Content-type: text/html
Manpage of gtk-server.cfg
gtk-server.cfg
Section: User Commands (1)
Index
Return to Main Contents
NAME
gtk-server.cfg - Configfile for the gtk-server.
SYNOPSIS
gtk-server.cfg
DESCRIPTION
The 'gtk-server.cfg' file is a configfile which is used by the GTK-server. If
the 'gtk-server.cfg' file is available in the same
directory as your client script, the GTK-server will read this local configfile
(preferred). This way each client program can use it's own GTK configuration.
If the configfile is not available locally, the GTK-server will follow the next logic:
1) try reading the environment variable GTK_SERVER_CONFIG. This variable should
contain the full path and name to the configfile.
2) try finding the (hidden) configfile in the homedir of the user. The name of
the configfile should be preceded by a dot, e.g. '.gtk-server.cfg'.
3) try finding the configfile in the /etc directory.
4) try finding the configfile in the /usr/local/etc directory.
The 'gtk-server.cfg' file contains the decriptions of the GTK functions which
will be used by your client script. The format of the file is <KEYWORD = VALUE>. Lines
starting with a hash '#' will be skipped. The keywords must be written using capitals.
Six keywords are recognized by the GTK-server:
- GTK_LIB_NAME = <library name>
-
Describes the name of the GTK library (.so or .dll) to open. This setting is mandatory.
Example:
GTK_LIB_NAME = libgtk-x11-2.0.so
- GDK_LIB_NAME = <library name>
-
Describes the name of the GDK library (.so or .dll) to open. This is an optional setting.
Example:
GDK_LIB_NAME = libgdk-x11-2.0.so
- GLIB_LIB_NAME = <library name>
-
Describes the name of the GLIB library (.so or .dll) to open. This is an optional setting.
Example:
GLIB_LIB_NAME = libglib-2.0.so
- GTK_LIB_EXTRA = <library name>
-
Describes the name of an additional library (.so or .dll) to open. This is an optional setting.
Example:
GTK_LIB_EXTRA = libgdk_pixbuf_xlib.so
- GTK_LIB_FUNCTION = <func>, <callback>, <type>, <amount>, <arg1>...<argx>
-
Every GTK function used by a script must be described here. First the name of
the function itself must be mentioned, after that a callback signal if applicable. The real
names for the GTK callback signals must be used here. Then the type of the returnvalue
must be specified. The type can be one of the following:
NONE, WIDGET, BOOL, STRING, LONG or FLOAT. After that, it must be clear how many
arguments the GTK function needs. Finally, the type of each indivdual argument must be declared.
The type of the arguments can be one of the following: NULL, WIDGET, BOOL, STRING, LONG, or FLOAT.
Example:
GTK_LIB_FUNCTION = gtk_window_new, delete-event, WIDGET, 1, LONG
- GTK_SERVER_LOG = <directory>
-
This keyword describes the directory where the GTK-server has to put it's logfile, if logging
is turned on. If the directory is described with a dot '.', the logfile will be produced
in the same directory where the GTK-server binary resides.
Example:
GTK_SERVER_LOG = /tmp
EXAMPLES
An example of a 'gtk-server.cfg' file can be found in the sourcepackage.
LICENSE
The GTK-server is GPL licensed.
SEE ALSO
gtk-server(1)
AUTHORS
Orignal concept, design and implementation by Peter van Eerten, e-mail : peter@gtk-server.org
Current version of the GTK-server was created with help of many others - see the CREDITS file in
the sourcepackage for credits.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- EXAMPLES
-
- LICENSE
-
- SEE ALSO
-
- AUTHORS
-
This document was created by
man2html,
using the manual pages.
Time: 22:56:21 GMT, September 06, 2005