Man Linux: Main Page and Category List

NAME

       gicInit, gicExit - Initialize and uninitialize LibGIIGIC

SYNOPSIS

       #include <ggi/gic.h>

       int gicInit(void);

       int gicExit(void);

DESCRIPTION

       gicInit  initializes  the  library. This function must be called before
       using  other  LibGIIGIC  functions;  otherwise  the  results  will   be
       undefined.

       gicExit  uninitializes the library (after being initialized by gicInit)
       and automatically cleans up if necessary.  This should be called  after
       an  application  finished  using the library.  If any GIC functions are
       called after the library has been uninitialized, the  results  will  be
       undefined.

       gicInit  allows multiple invocations.  A reference count is maintained,
       and to completely uninitialize the library, gicExit must be  called  as
       many times as gicInit has been called beforehand.

RETURN VALUE

       gicInit returns 0 for OK, otherwise an gii-error(3) code.

       gicExit returns:

       0      after successfully cleaning up,

       >0     the  number of ’open’ gicInit calls, if there has been more than
              one call to gicInit.  As gicInit and gicExit  must  be  used  in
              properly   nested  pairs,  e.g.  the  first  gicExit  after  two
              gicInit’s will return 1.

       <0     gii-error(3), especially if more gicExit calls  have  been  done
              than gicInit calls.

EXAMPLES

       Initialize and uninitialize LibGIIGIC:

       if (gicInit() < 0) {
           fprintf(stderr, "Cannot initialize LibGIIGIC!\n");
           exit(1);
       }

       /* Do some LibGIIGIC stuff */

       gicExit();

SEE ALSO

       gicOpen(3)