gcry_check_version get or check the version of libgcrypt #include <gcrypt.h> const char *gcry_check_version const char *req_version gcry_check_version gcry_check_version checks that the version of the library is at minimum the requested one and return the version string; NULL is returned if the condition is not met. You may pass NULL as reqy_version to simply get the version string back without any checking. gcry_errno gcry_strerror Get the last error #include <gcrypt.h> int gcry_errno const char *gcry_strerror intno gcry_errno gcry_strerror Both function are to be used like there Standard-C counterparts. However gcry_errno is a function and not just a global variable. If -1 is passed to gcry_strerror, gcry_errno is implictly used. gcry_control Multi purpose control function #include <gcrypt.h> int gcry_control enum gcry_ctl_cmdscmd ... gcry_control This function is used to control various aspects of &libgcrypt; FIXME: Explain all commands here. gcry_set_allocation_handler gcry_set_outofcore_handler Use application defined malloc functions #include <gcrypt.h> void gcry_set_allocation_handler void *(*alloc_func)(size_t n) void *(*alloc_secure_func)(size_t n) int (*is_secure_func)(const void *p) void *(*realloc_func)(void *p, size_t n) void (*free_func)(void *p) void gcry_set_outofcore_handler int (*h)( void*, size_t, unsigned int ), void *opaque ) gcry_set_allocation_handler gcry_set_outofcore_handler FIXME gcry_set_fatalerror_handler change the default fatal error handler #include <gcrypt.h> void gcry_set_fatalerror_handler void (*func)( void *, int, const char*) void *opaque gcry_set_fatalerror_handler At certain places the &libgcrypt; may need to call a fatal error fucntion which does terminate the process. To allow an application to do some emergency cleanup, it may register a fatal error handler with the library. This handler is assumed to terminate the application; however if it returns &libgcrypt; will abort anyway. The handler is called with the opaque value registered here, an errorcode from &libgcrypt; and some descriptive text string. gcry_set_gettext_handler Change the default gettext function #include <gcrypt.h> void gcry_set_gettext_handler const char *(*func)(const char*) void *opaque gcry_set_log_handler FIXME!! gcry_set_log_handler Change the default logging function #include <gcrypt.h> void gcry_set_log_handler void (*func) (void*, int, const char*, va_list) void *opaque gcry_set_log_handler &libgcrypt; has it;s own logging functions. Applications which need to use their own, should provide a log function to &libgcrypt; so that it will use this function instead. Fixme: Describe how this is intended to work. gcry_malloc gcry_calloc gcry_malloc_secure gcry_calloc_secure gcry_realloc gcry_xmalloc gcry_xcalloc gcry_xmalloc_secure gcry_xcalloc_secure gcry_xrealloc gcry_xstrdup gcry_malloc gcry_malloc Change the default logging function #include <gcrypt.h> void gcry_set_log_handler void (*func) (void*, int, const char*, va_list) void *opaque gcry_set_log_handler &libgcrypt; has it;s own logging functions. Applications which need to use their own, should provide a log function to &libgcrypt; so that it will use this function instead. Fixme: Describe how this is intended to work.