Home | History | Annotate | Download | only in openssl
      1 /* Copyright (c) 2014, Google Inc.
      2  *
      3  * Permission to use, copy, modify, and/or distribute this software for any
      4  * purpose with or without fee is hereby granted, provided that the above
      5  * copyright notice and this permission notice appear in all copies.
      6  *
      7  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
      8  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
      9  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
     10  * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
     11  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
     12  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
     13  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */
     14 
     15 #ifndef OPENSSL_HEADER_CRYPTO_H
     16 #define OPENSSL_HEADER_CRYPTO_H
     17 
     18 #include <openssl/base.h>
     19 
     20 /* Upstream OpenSSL defines |OPENSSL_malloc|, etc., in crypto.h rather than
     21  * mem.h. */
     22 #include <openssl/mem.h>
     23 
     24 /* Upstream OpenSSL defines |CRYPTO_LOCK|, etc., in crypto.h rather than
     25  * thread.h. */
     26 #include <openssl/thread.h>
     27 
     28 
     29 #if defined(__cplusplus)
     30 extern "C" {
     31 #endif
     32 
     33 
     34 /* crypto.h contains functions for initializing the crypto library. */
     35 
     36 
     37 /* CRYPTO_library_init initializes the crypto library. It must be called if the
     38  * library is built with BORINGSSL_NO_STATIC_INITIALIZER. Otherwise, it does
     39  * nothing and a static initializer is used instead. It is safe to call this
     40  * function multiple times and concurrently from multiple threads.
     41  *
     42  * On some ARM configurations, this function may require filesystem access and
     43  * should be called before entering a sandbox. */
     44 OPENSSL_EXPORT void CRYPTO_library_init(void);
     45 
     46 /* CRYPTO_is_confidential_build returns one if the linked version of BoringSSL
     47  * has been built with the BORINGSSL_CONFIDENTIAL define and zero otherwise.
     48  *
     49  * This is used by some consumers to identify whether they are using an
     50  * internal version of BoringSSL. */
     51 OPENSSL_EXPORT int CRYPTO_is_confidential_build(void);
     52 
     53 /* CRYPTO_has_asm returns one unless BoringSSL was built with OPENSSL_NO_ASM,
     54  * in which case it returns zero. */
     55 OPENSSL_EXPORT int CRYPTO_has_asm(void);
     56 
     57 
     58 /* Deprecated functions. */
     59 
     60 /* OPENSSL_VERSION_TEXT contains a string the identifies the version of
     61  * OpenSSL. node.js requires a version number in this text. */
     62 #define OPENSSL_VERSION_TEXT "OpenSSL 1.0.2 (compatible; BoringSSL)"
     63 
     64 #define SSLEAY_VERSION 0
     65 
     66 /* SSLeay_version is a compatibility function that returns the string
     67  * "BoringSSL". */
     68 OPENSSL_EXPORT const char *SSLeay_version(int unused);
     69 
     70 /* SSLeay is a compatibility function that returns OPENSSL_VERSION_NUMBER from
     71  * base.h. */
     72 OPENSSL_EXPORT unsigned long SSLeay(void);
     73 
     74 /* CRYPTO_malloc_init returns one. */
     75 OPENSSL_EXPORT int CRYPTO_malloc_init(void);
     76 
     77 /* ENGINE_load_builtin_engines does nothing. */
     78 OPENSSL_EXPORT void ENGINE_load_builtin_engines(void);
     79 
     80 /* ENGINE_register_all_complete returns one. */
     81 OPENSSL_EXPORT int ENGINE_register_all_complete(void);
     82 
     83 /* OPENSSL_load_builtin_modules does nothing. */
     84 OPENSSL_EXPORT void OPENSSL_load_builtin_modules(void);
     85 
     86 /* FIPS_mode returns zero. */
     87 OPENSSL_EXPORT int FIPS_mode(void);
     88 
     89 
     90 #if defined(__cplusplus)
     91 }  /* extern C */
     92 #endif
     93 
     94 #endif  /* OPENSSL_HEADER_CRYPTO_H */
     95