annobin: Libannocheck

1 
1 5 Allowing other programs to run security checks
1 ************************************************
1 
1 The 'annocheck' program is mostly seen as a security checking tool and
1 in order to allow third party programs such as 'rpminspect' the ability
1 to access these checks a library interface is provided.
1 
1    An example of how to use the libannocheck library can be found in the
1 annobin testsuite.  In particular the 'tests/use-libannocheck.c' file
1 contains code to initialise, run and then close the library.  In theory
1 however the code flow looks like this:
1 
1        #include <libannocheck.h>
1        struct libannocheck_internals * handle;
1        unsigned int num_fails, num_maybs;
1        handle = libannocheck_init (libannocheck_version, "a.out", NULL);
1        libannocheck_disable_all_tests (handle);
1        libannocheck_enable_test (handle, "bind-now");
1        libannocheck_run_tests (handle, & num_fails, & num_maybs);
1        libannocheck_finish (handle);
1 
1    The library consists of a header file ('libannocheck.h') and a shared
1 object file (libannocheck.so).  It provides the following functions:
1 

Menu

1 
· libannocheck_init               Initialise the library
· libannocheck_finish             Close the library
· libannocheck_get_version        Get the library version
· libannocheck_get_error_message  Convert an error number into an error message
· libannocheck_get_known_tests    Get a list of tests supported by the library
· libannocheck_enable_all_tests   Enable all tests
· libannocheck_disable_all_tests  Disable all tests
· libannocheck_enable_test        Enable a specific test
· libannocheck_disable_test       Disable a specific test
· libannocheck_enable_profile     Enable a profile
· libannocheck_get_known_profiles Get a list of known profiles
· libannocheck_run_tests          Run enabled tests
1