diff options
Diffstat (limited to 'src/include/openssl/engine.h')
-rw-r--r-- | src/include/openssl/engine.h | 76 |
1 files changed, 38 insertions, 38 deletions
diff --git a/src/include/openssl/engine.h b/src/include/openssl/engine.h index b029ef94..595e53c0 100644 --- a/src/include/openssl/engine.h +++ b/src/include/openssl/engine.h @@ -22,36 +22,36 @@ extern "C" { #endif -/* Engines are collections of methods. Methods are tables of function pointers, - * defined for certain algorithms, that allow operations on those algorithms to - * be overridden via a callback. This can be used, for example, to implement an - * RSA* that forwards operations to a hardware module. - * - * Methods are reference counted but |ENGINE|s are not. When creating a method, - * you should zero the whole structure and fill in the function pointers that - * you wish before setting it on an |ENGINE|. Any functions pointers that - * are NULL indicate that the default behaviour should be used. */ +// Engines are collections of methods. Methods are tables of function pointers, +// defined for certain algorithms, that allow operations on those algorithms to +// be overridden via a callback. This can be used, for example, to implement an +// RSA* that forwards operations to a hardware module. +// +// Methods are reference counted but |ENGINE|s are not. When creating a method, +// you should zero the whole structure and fill in the function pointers that +// you wish before setting it on an |ENGINE|. Any functions pointers that +// are NULL indicate that the default behaviour should be used. -/* Allocation and destruction. */ +// Allocation and destruction. -/* ENGINE_new returns an empty ENGINE that uses the default method for all - * algorithms. */ +// ENGINE_new returns an empty ENGINE that uses the default method for all +// algorithms. OPENSSL_EXPORT ENGINE *ENGINE_new(void); -/* ENGINE_free decrements the reference counts for all methods linked from - * |engine| and frees |engine| itself. */ +// ENGINE_free decrements the reference counts for all methods linked from +// |engine| and frees |engine| itself. OPENSSL_EXPORT void ENGINE_free(ENGINE *engine); -/* Method accessors. - * - * Method accessors take a method pointer and the size of the structure. The - * size allows for ABI compatibility in the case that the method structure is - * extended with extra elements at the end. Methods are always copied by the - * set functions. - * - * Set functions return one on success and zero on allocation failure. */ +// Method accessors. +// +// Method accessors take a method pointer and the size of the structure. The +// size allows for ABI compatibility in the case that the method structure is +// extended with extra elements at the end. Methods are always copied by the +// set functions. +// +// Set functions return one on success and zero on allocation failure. OPENSSL_EXPORT int ENGINE_set_RSA_method(ENGINE *engine, const RSA_METHOD *method, @@ -64,33 +64,33 @@ OPENSSL_EXPORT int ENGINE_set_ECDSA_method(ENGINE *engine, OPENSSL_EXPORT ECDSA_METHOD *ENGINE_get_ECDSA_method(const ENGINE *engine); -/* Generic method functions. - * - * These functions take a void* type but actually operate on all method - * structures. */ +// Generic method functions. +// +// These functions take a void* type but actually operate on all method +// structures. -/* METHOD_ref increments the reference count of |method|. This is a no-op for - * now because all methods are currently static. */ +// METHOD_ref increments the reference count of |method|. This is a no-op for +// now because all methods are currently static. void METHOD_ref(void *method); -/* METHOD_unref decrements the reference count of |method| and frees it if the - * reference count drops to zero. This is a no-op for now because all methods - * are currently static. */ +// METHOD_unref decrements the reference count of |method| and frees it if the +// reference count drops to zero. This is a no-op for now because all methods +// are currently static. void METHOD_unref(void *method); -/* Private functions. */ +// Private functions. -/* openssl_method_common_st contains the common part of all method structures. - * This must be the first member of all method structures. */ +// openssl_method_common_st contains the common part of all method structures. +// This must be the first member of all method structures. struct openssl_method_common_st { - int references; /* dummy – not used. */ + int references; // dummy – not used. char is_static; }; #if defined(__cplusplus) -} /* extern C */ +} // extern C extern "C++" { @@ -100,10 +100,10 @@ BORINGSSL_MAKE_DELETER(ENGINE, ENGINE_free) } // namespace bssl -} /* extern C++ */ +} // extern C++ #endif #define ENGINE_R_OPERATION_NOT_SUPPORTED 100 -#endif /* OPENSSL_HEADER_ENGINE_H */ +#endif // OPENSSL_HEADER_ENGINE_H |