gcaps is a communication server natively supported by gclib to multiplex Galil hardware communication features. It runs in the background on the host computer, as a service or daemon.
Incidentally, the name gcaps is an acronym for the improbable name Galil Controller Asynchronous Proxy Server. Yet another tidbit to impress friends at parties.
gclib will attempt to use gcaps whenever GOpen() is called without the --direct
or -d
switch. Other than this small difference, gclib function calls through gcaps operate as if the connetion was direct. The first version of gclib supporting gcaps is 299.
At this time, gcaps must be running on the same host as gclib (localhost). Contact Galil if connection to a remote host is desired.
The following functions will attempt to use gcaps first to gather data. If gcaps is not found, the functions will fall back to user space calls to populate information.
gclib Function | Usage | If gcaps unavailable |
---|---|---|
GVersion() | Provide the version of gclib and gcaps (if available). | No gcaps version. |
GIpRequests() | Provide a list of all Galil controllers requesting IP addresses via BOOT-P or DHCP. | Must be root. |
GAssign() | Assigns an IP address over the Ethernet to a controller at a given MAC address. | Must be root. |
GAddresses() | Provides a listing of all available connection addresses. | Must be root, or user must be in device group. |
Because gcaps runs as a service on Windows, and as a system daemon on Linux, gcaps runs with root privileges. See If gcaps unavailable column in the above table when running without gcaps.
If gcaps is unavailable when these functions are run, a ~1 second delay will be incurred while gclib searches for the absent server. In order to prevent gcaps usage in these functions, comment out the symbol G_USE_GCAPS in gclibo.h and rebuild gclibo. See Rebuilding gclibo.
See the installation page to see if gcaps is available on your OS. Support is marked with a diamond (♦).
If gcaps is needed on a different OS, please email softw, or call ares uppor t@ga lil.c omGalil Applications.
gcaps is bundled in the gclib and GDK installer packages. Install with defaults to get the gcaps service included. gcaps is also available as a standalone installer. Downloads are available on the release notes page.
gcaps is currently available only on 64 bit Windows.
Instructions to install gcaps are listed with the instructions to install gclib. Follow the link for your OS on the installation page.
gcaps is currently available only on 64 bit versions of Linux.
See the release notes page.