Poster of Linux kernelThe best gift for a Linux geek
gicInit

gicInit

Section: GGI (3) Updated: 2006-12-30
Local index Up
 

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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:46:56 GMT, April 16, 2011