Operator's guide
gcfgdbmark dirty option-name-or-prefix : Enter this command to mark the named configuration option as “dirty” in the database.
gcfgdbisdirty option-name-or-prefix(option-names-or- prefixes...) : This command finds out whether any of the named options is marked as “dirty”. If none are marked, the command exits successfully; otherwise, it exits with a failure code. Thus you can use gcfgdbisdirty in your own shell scripts, to perform actions depending on the status of the DCM's configuration options.
Note that marking an option as “dirty” will not necessarily lead to any action being taken. For example, you cannot force a service to be restarted using these commands.
Each of the four tools can also take two command-line options:
gcfgdbxxx -h : Displays a short usage reminder about the command gcfgdbxxx. All other arguments will be ignored.
gcfgdbxxx -cconfig-databaseother-arguments : Normally, all the gcfgdbxxx commands work on the system configuration database. However, you can supply the file name of an alternative database using the -coption, in which case the command will be performed on that database instead.
For a detailed description of the configuration options in the database, see Chapter 4, “Configuration options”.
Digitizer console access
The command gcli allows you to pass commands directly to the digitizer's console. The syntax is:
gcli port-number[-f][-r]command
where port-number refers to the serial port connected to the digitizer. You can use serialmap to discover which serial port has which number, as described below. command is a DM24 FORTH command, which may contain
several words. For information on the commands available on the DM24, please see its own documentation.
gcli will wait for the digitizer command to finish before exiting, and will only output any response from the digitizer afterwards. If you need to issue a
command which monitors a value, you will need to connect to the digitizer's console directly using Scream! or minicom.
If you want to pass special characters to gcli, using the -foption allows you to use backslash sequences as used by the C command printf (e.g. \t = tab
