File: gpgrt.info,  Node: Initializing the library,  Next: Multi-Threading,  Prev: Building sources using Automake,  Up: Preparation

2.4 Initializing the library
============================

Before the library can be used, it should initialize itself.  This is
achieved by invoking the function 'gpgrt_check_version' described below.

   Also, it is often desirable to check that the version of Libgpg-error
used is indeed one which fits all requirements.  Even with binary
compatibility, new features may have been introduced, but due to problem
with the dynamic linker an old version may actually be used.  So you may
want to check that the version is okay right after program startup.

 -- Function: const char * gpgrt_check_version (const char *REQ_VERSION)

     The function 'gpgrt_check_version' initializes some subsystems used
     by Libgpg-error and must be invoked before any other function in
     the library.  *Note Multi-Threading::.

     Furthermore, this function returns the version number of the
     library.  It can also verify that the version number is higher than
     a certain required version number REQ_VERSION, if this value is not
     a null pointer.