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 parameter 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 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 

-R root

Normally, the files specified on the command line are used as specified. By specifying a root directory with the -R option, all files (including the default files if none are specified) will be interpreted relative to root.

For example, if root is specified as /foo and /etc/TIMEZONE is specified on the command line, it will be interpreted as /foo/etc/TIMEZONE.

RETURN VALUE

ch_rc 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 /etc/rc.config.d directory have the following format:

# Comments are preceded by pound signs and 
# are always on a line of their own. 
# Blank lines are allowed. 

VARIABLE=value 
VARIABLE_2=value2 
VARIABLE_3[1]=value3 
VARIABLE_3[2]=value4 

# All parameters are defined on a single line 
# Parameters must not be exported 

WARNINGS

ch_rc does not interpret configuration files; it only does pattern matching. As a result, if comments appear on lines containing parameter definitions, the comments will also appear in output when using the -l option.

ch_rc cannot parse multiple parameter definitions which occur on the same line of a file.

AUTHOR

ch_rc was developed by HP.

FILES

/etc/rc.config: system configuration database driver file
/etc/rc.config.d: directory containing system configuration files