5.1 Initialise the library

struct libannocheck_internals *
libannocheck_init (unsigned int  VERSION,
                   const char *  FILEPATH,
                   const char *  DEBUGPATH)

Returns a token used to identify the instantiation in future calls.

VERSION is the expected version of the libannocheck library. This should normally be ’libannocheck_version’. If the actual version of the library cannot support VERSION then libannocheck_error_bad_version is returned.

FILEPATH is a path the binary to be tested. It can be absolute or relative. It may not be NULL.

DEBUGPATH is a path the debug info file associated with FILEPATH. It can be NULL.

Returns an enum libannocheck_error cast to a struct libannocheck_internals * if something goes wrong.