HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

g
gdc(1M) gdc(1M)
toggletrace
If gated is currently tracing to a file, cause tracing to be suspended and the trace file to be
closed. If gated tracing is current suspended, cause the trace file to be reopenned and
tracing initiated. This is useful for moving trace files.
By default gated obtains its configuration from a file normally named
/etc/gated.config
. The gdc
program also maintains several other versions of the configuration file, in particular named:
/etc/gated.conf+
The new configuration file. When gdc
is requested to install a new configuration
file, this file is renamed
/etc/gated.conf
.
/etc/gated.conf-
The old configuration file. When
gdc is requested to install a new configuration
file, the previous
/etc/gated.conf
is renamed to this name.
/etc/gated.conf--
The really old configuration file.
gdc retains the previous old configuration file
under this name.
The following commands perform operations related to configuration files:
checkconf Check /etc/gated.conf
for syntax errors. This is usefully done after changes to the
configuration file but before sending a
reconfig signal to the currently running gated,
to ensure that there are no errors in the configuration which would cause the running
gated to terminate on reconfiguration. When this command is used, gdc issues an infor-
mational message indicating whether there were parse errors or not, and if so saves the
error output in a file for inspection.
checknew Like checkconf except that the new configuration file, /etc/gated.conf+
,is
checked instead.
newconf Move the /etc/gated.conf+
file into place as /etc/gated.conf, retaining the
older versions of the file as described above.
gdc will decline to do anything when given
this command if the new configuration file doesn’t exist or otherwise looks suspect.
backout Rotate the configuration files in the newer direction, in effect moving the old configuration
file to
/etc/gated.conf
. The command will decline to perform the operation if
/etc/gated.conf-
doesn’t exist or is zero length, or if the operation would delete an
existing, non-zero length
/etc/gated.conf+
file.
BACKOUT Perform a backout operation even if /etc/gated.conf+
exists and is of non-zero
length.
modeconf Set all configuration files to mode 664, owner root, group gdmaint. This allows a trusted
non-root user to modify the configuration files.
createconf If /etc/gated.conf+
does not exist, create a zero length file with the file mode set to
664, owner root, group gdmaint. This allows a trusted non-root user to install a new
configuration file.
The following commands provide support for starting and stopping
gated, and for determining its running
state:
running Determine if gated is currently running. This is done by checking to see if gated
has a
lock on the file containing its pid, if the pid in the file is sensible and if there is a running
process with that pid. Exits with zero status if
gated is running, non-zero otherwise.
start Start gated. The command returns an error if gated is already running. Otherwise it
executes the gated binary and waits for up to the delay interval (10 seconds by default, as
set with the -t option otherwise) until the newly started process obtains a lock on the pid
file. A non-zero exit status is returned if an error is detected while executing the binary, or
if a lock is not obtained on the pid file within the specified wait time.
stop Stop gated, gracefully if possible, ungracefully if not. The command returns an error
(with non-zero exit status) if gated is not currently running. Otherwise it sends a ter-
minate signal to gated and waits for up to the delay interval (10 seconds by default, as
specified with the -t option otherwise) for the process to exit. Should gated fail to exit
within the delay interval it is then signaled again with a second terminate signal. Should it
fail to exit by the end of the second delay interval it is signaled for a third time with a kill
signal. This should force immediate termination unless something is very broken. The com-
mand terminates with zero exit status when it detects that gated has terminated, non-
zero otherwise.
Section 1M−−296 Hewlett-Packard Company − 2 − HP-UX 11i Version 1: September 2005