libgii.conf(5)

1libgii.conf(5)                        GGI                       libgii.conf(5)
2
3
4

NAME

6       libgii.conf : LibGII configuration file format
7

DESCRIPTION

9       /etc/ggi/libgii.conf  is the configuration file that defines what input
10       module are available and where libgii is supposed  to  find  them.   It
11       consists  of  lines  defining target locations (mapping a target name a
12       function name) and target aliases (fake  targets  that  actually  calls
13       other target with a specific set of parameters).
14
15       The format is common to all GGI libraries. It is defined by libgg.  See
16       ggLoadConfig(3) for additional information on file inclusions and other
17       generic options.
18

EXAMPLES

20       These examples show how to use the generic configuration mechanism pro‐
21       posed by LibGG with LibGII.
22
23       The first example defines three input modules (or  targets)  for  which
24       initialization  function  is found in three different dynamic libraries
25       (.so files), under the default LibGII input symbol: GIIdlinit:
26
27       input-stdin                   input/stdin.so
28       input-x                       input/x.so
29       input-xwin                    input/xwin.so
30
31       In the second example, the two  inputs  are  implemented  in  a  single
32       dynamic  library, but they each have their own initialization functions
33       in this library. Their name is separated from the path by a :.
34              input-x                         input/x.so:GIIdl_x    input-xwin
35              input/x.so:GIIdl_xwin
36       The  third  example  defines  only  one real target input-x, located in
37       shared object input/x.so under the symbol GIIdl_x.   input-xwin  is  an
38       alias  that  will resolve to target input-x with the option string -be-
39       xwin to be passed to the target function (GIIdl_x in input/x.so).
40              input-x                            input/x.so:GIIdl_x      alias
41              input-xwin      input-x:-be-xwin
42       The  last  examples  defines two inputs, with two possible location for
43       their implementation.  The first two lines are the same as  in  example
44       2. The other two states that these two inputs can also be found (if the
45       previous fail) as a built-in modules. The /gii-builtins path points  to
46       the LibGII built-in symbol namespace.  In this case both input would be
47       found in this namespace under the default symbol GIIdlinit.   The  ini‐
48       tialization  function  will  be given the requested target name to know
49       which implementation to use.
50
51       input-x                              input/x.so:GIIdl_x      input-xwin
52       input/x.so:GIIdl_xwin
53
54       input-x                                 /gii-builtins        input-xwin
55       /gii-builtins
56

NAME

DESCRIPTION

EXAMPLES

SEE ALSO