libgii.conf(5) GGI libgii.conf(5)NAME
libgii.conf - LibGII configuration file format
DESCRIPTION
/etc/ggi/libgii.conf is the configuration file that defines what input module are available and where libgii is supposed to find them. It
consists of lines defining target locations (mapping a target name a function name) and target aliases (fake targets that actually calls
other target with a specific set of parameters).
The format is common to all GGI libraries. It is defined by libgg. See ggLoadConfig(3) for additional information on file inclusions and
other generic options.
EXAMPLES
These examples show how to use the generic configuration mechanism proposed by LibGG with LibGII.
The first example defines three input modules (or targets) for which initialization function is found in three different dynamic libraries
(.so files), under the default LibGII input symbol: GIIdlinit:
input-stdin input/stdin.so
input-x input/x.so
input-xwin input/xwin.so
In the second example, the two inputs are implemented in a single dynamic library, but they each have their own initialization functions in
this library. Their name is separated from the path by a :.
input-x input/x.so:GIIdl_x input-xwin input/x.so:GIIdl_xwin
The third example defines only one real target input-x, located in shared object input/x.so under the symbol GIIdl_x. input-xwin is an
alias that will resolve to target input-x with the option string -be-xwin to be passed to the target function (GIIdl_x in input/x.so).
input-x input/x.so:GIIdl_x alias input-xwin input-x:-be-xwin
The last examples defines two inputs, with two possible location for their implementation. The first two lines are the same as in example
2. The other two states that these two inputs can also be found (if the previous fail) as a built-in modules. The /gii-builtins path points
to the LibGII built-in symbol namespace. In this case both input would be found in this namespace under the default symbol GIIdlinit. The
initialization function will be given the requested target name to know which implementation to use.
input-x input/x.so:GIIdl_x input-xwin input/x.so:GIIdl_xwin
input-x /gii-builtins input-xwin /gii-builtins
SEE ALSO ggLoadConfig(3)libgii-1.0.x 2006-12-30 libgii.conf(5)
Check Out this Related Man Page
giiEventPoll(3) GGI giiEventPoll(3)NAME
giiEventPoll, giiEventSelect, giiEventsQueued, giiEventRead - Wait for and receive events
SYNOPSIS
#include <ggi/gii.h>
gii_event_mask giiEventPoll(gii_input_t inp, gii_event_mask mask,
struct timeval *t);
int giiEventSelect(gii_input_t inp, gii_event_mask *mask, int n,
fd_set *readfds, fd_set *writefds, fd_set *exceptfds,
struct timeval *timeout);
int giiEventsQueued(gii_input_t inp, gii_event_mask mask);
int giiEventRead(gii_input_t inp, gii_event *ev, gii_event_mask mask);
DESCRIPTION
giiEventPoll waits for specific events to become available on an input. This call somewhat resembles the Unix select(2) call, but only for
LibGII events and is more portable. The function returns after an event matching the given event mask is available or after the amount of
time specified by t has elapsed, whichever occurs first. If t is NULL, there is no timeout.
The timeout value on return is updated to the time that would have been remaining. So make sure to re-setup this value when calling
giiEventPoll in a loop.
giiEventSelect is the combination of giiEventPoll and select(2) allowing to wait for both LibGII events and arbitrary file descriptors in
any of the three states. However, this function is not available if the operating system does not support the select(2) call, not even as
a stub.
giiEventsQueued returns the number of events matching the specified event mask that are currently queued in the input.
giiEventRead blocks for and transfers an event from the given input to the location pointed to by ev. The event with the earliest timestamp
that matches the given mask is returned to the application.
RETURN VALUE
giiEventPoll returns a mask of available events (constrained by the given mask). It is 0 if no events are available. On error, an nega-
tive gii-error(3) code is returned.
giiEventSelect returns the same values as select(2). Unlike other LibGGI/LibGII functions, it also uses errno. It will update the timeout
regardless of whether or not the system call does so.
giiEventsQueued returns the number of events.
giiEventRead returns the size of event on success, and 0 on error.
EXAMPLES
This is one of the various ways of coding an event-polling loop:
for(;;) {
tv.tv_sec = 0;
tv.tv_usec = 100; /* change to 0 for non-blocking behaviour */
ggiEventPoll(vis, emAll, &tv);
n = ggiEventsQueued(vis, emAll);
/* Process events in one gulp, when available */
while(n--) {
ggiEventRead(vis, &ggievent, emAll);
switch(ggievent.any.type) {
/* ... */
}
}
/* Do other stuff */
}
Note: This code uses the LibGGI functions and types instead of the LibGII ones, since the former is the more common case.
libgii-1.0.x 2006-12-30 giiEventPoll(3)