libfprint
Functions
Core library operations

Functions

void fp_set_debug (int level)
 Set message verbosity. More...
 
int fp_init (void)
 Initialise libfprint. More...
 
void fp_exit (void)
 Deinitialise libfprint. More...
 

Detailed Description

Function Documentation

void fp_set_debug ( int  level)

Set message verbosity.

  • Level 0: no messages ever printed by the library (default)
  • Level 1: error messages are printed to stderr
  • Level 2: warning and error messages are printed to stderr
  • Level 3: informational messages are printed to stdout, warning and error messages are printed to stderr

The default level is 0, which means no messages are ever printed. If you choose to increase the message verbosity level, ensure that your application does not close the stdout/stderr file descriptors.

You are advised to set level 3. libfprint is conservative with its message logging and most of the time, will only log messages that explain error conditions and other oddities. This will help you debug your software.

If the LIBFPRINT_DEBUG environment variable was set when libfprint was initialized, this function does nothing: the message verbosity is fixed to the value in the environment variable.

If libfprint was compiled without any message logging, this function does nothing: you'll never get any messages.

If libfprint was compiled with verbose debug message logging, this function does nothing: you'll always get messages from all levels.

Parameters
ctxthe context to operate on, or NULL for the default context
leveldebug level to set
int fp_init ( void  )

Initialise libfprint.

This function must be called before you attempt to use the library in any way.

Returns
0 on success, non-zero on error.
void fp_exit ( void  )

Deinitialise libfprint.

This function should be called during your program exit sequence. You must not use any libfprint functions after calling this function, unless you call fp_init() again.

References fp_dev_close().