Provided by: libggi2-dev_2.2.2-3ubuntu1_i386 bug

NAME

       ggiInit, ggiExit - Initialize and uninitialize LibGGI

SYNOPSIS

       #include <ggi/ggi.h>

       int ggiInit(void);

       int ggiExit(void);

DESCRIPTION

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

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

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

RETURN VALUE

       ggiInit returns 0 for OK, otherwise a ggi-error(3) code.

       ggiExit returns:

       0      after successfully cleaning up,

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

       <0     ggi-error(3), especially if more ggiExit calls  have  been  done
              than ggiInit calls.

EXAMPLES

       Initialize and uninitialize LibGGI:

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

       /* Do some LibGGI stuff */

       ggiExit();

SEE ALSO

       ggiOpen(3)