ch_rc.1m (2010 09)

c
ch_rc(1M) ch_rc(1M)
NAME
ch_rc - change system configuration file
SYNOPSIS
/usr/sbin/ch_rc -a
|-r|-l [-v][-A
][-R root ][-p {parameter |parameter=value}...] [ file ...]
DESCRIPTION
ch_rc manages the addition, modification, removal, and retrieval of information stored in files having
the format of those in the /etc/rc.config.d
directory.
Parameter names are treated as strings. Thus,
X[0] has no special meaning to ch_rc in relation to
other parameters named
X[1]orX .
Options
file Specify the file(s) to be used as the configuration database. If no file is specified, the set
of files used by
ch_rc defaults to
/etc/TIMEZONE and all files in the
/etc/rc.config.d
directory.
Modification and deletion of configuration parameters occurs in the file where the param-
eter is found.
-a Add or modify a parameter definition. For each parameter specified on the command line,
if the parameter is found in the specified (or default) files, it is modified to reflect the
specified value. If the parameter is not found, it is added to the specified file(s).
If a new parameter is being defined, one or more files must be specified on the command
line; the specified files are those in which the parameter will be defined.
-r Remove a parameter definition. For each parameter name specified on the command line,
remove any occurrence of that parameter from the specified file(s).
-l List configuration values. For each parameter specified on the command line, output
every definition of the parameter from the specified file(s). Output consists of only the
values, one per line.
-p Specify a parameter name or name/value pair. If a name and value is expected, but only
a name is specified, the value will be set to the empty string. For example, specifying
FOO or FOO= will result in FOO and FOO= respectively.
Due to shell quoting rules, if you need a quoted parameter value, you must protect the
quotes from the shell. For example,
ch_rc -a -p VALUE="a b c" <file>
yields:
VALUE=a b c
which is an error, whereas,
ch_rc -a -p VALUE=’"a b c"’ <file>
yields:
VALUE="a b c"
-v Verbose. When used with the -l option, the -v option causes a verbose listing to be
output. This listing includes a filename followed by the entire line containing the
specified parameter for each occurrance of the parameter.
-A The -A option is used to list all occurances of array parameters matching the parame-
ters specified on the command line.
For example,
ch_rc -l -A -v -p ZZZ file
may emit the following output:
file: ZZZ[0]=zero
file: ZZZ[5]=five
file: ZZZ[9]=fred
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1