Guralp Systems CMG-DCM User Manual
Page 119

Operator's guide
certain options are numbers), but will not otherwise make sure that
your change makes sense.
gcfgdbget option-name-or-prefix : Enter this command to find
the current value of the named option. Instead of a single option name,
you can also use a prefix (as described above) to find out the values of
a range of options. The remaining tools also allow you to use prefixes
in place of full option names.
Each option in the database can be marked either as “clean” or as
“dirty”. This flag tells the DCM whether the database is currently in
sync with the state of the device. Whenever you alter the value of an
option using the gcfgdbset tool, or using the Web interface, the
option is marked as “dirty”; the DCM then alters its configuration, and
marks the option as “clean” again, to signify that the change completed
successfully. Three more commands are provided to allow you to
access this flag:
gcfgdbmark clean option-name-or-prefix : Enter this
command to mark the named configuration option as “clean” in the
database.
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 -c config-database other-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 -c option, in which case the command will be
December 2006
119