ch_rc(1M)ch_rc(1M)NAMEch_rc - change system configuration file
SYNOPSIS
root] {parameter|parameter=value}...] [file...]
DESCRIPTION
manages the addition, modification, removal, and retrieval of informa‐
tion stored in files having the format of those in the directory.
Parameter names are treated as strings. Thus, has no special meaning
to in relation to other parameters named
Options
file Specify the file(s) to be used as the configuration
database. If no file is specified, the set of files
used by defaults to and all files in the directory.
Modification and deletion of configuration parameters
occurs in the file where the parameter is found.
Add or modify a parameter definition. For each parameter speci‐
fied
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.
Remove a parameter definition. For each parameter name specified
on the command line, remove any occurrence of that
parameter from the specified file(s).
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.
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, speci‐
fying or will result in and respectively.
Due to shell quoting rules, if you need a quoted
parameter value, you must protect the quotes from the
shell. For example,
yields:
which is an error, whereas,
yields:
Verbose. When used with the
option, the 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.
The option is used to list all occurances of array parame‐
ters matching the parameters specified on the command
line.
For example,
may emit the following output:
Normally, the files specified on the command line are used as
specified.
By specifying a root directory with the option, all
files (including the default files if none are speci‐
fied) will be interpreted relative to root.
For example, if root is specified as and is specified
on the command line, it will be interpreted as
RETURN VALUE
exits with one of the following values:
0 add/delete/list successful
1 command line syntax/usage error
2 can not access one or more of the listed (or default) files
3 can not open/create/write file
4 memory error
5 no files specified on command line for add option
EXAMPLES
Files in the directory have the following format:
WARNINGS
does not interpret configuration files; it only does pattern matching.
As a result, if comments appear on lines containing parameter defini‐
tions, the comments will also appear in output when using the option.
cannot parse multiple parameter definitions which occur on the same
line of a file.
AUTHOR
was developed by HP.
FILES
system configuration database driver file
directory containing system configuration files
SEE ALSOrc.config(4).
ch_rc(1M)