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

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] or X .
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 parame-
ter 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 out-
put. 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 parameters
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
Section 1M132 Hewlett-Packard Company 1 HP-UX 11i Version 1: September 2005