ch_rc(1M)																 ch_rc(1M)

NAME

       ch_rc - change system configuration file

SYNOPSIS

       root] {parameter|parameter=value}...]  [file...]

DESCRIPTION

       manages the addition, modification, removal, and retrieval of information 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 specified
			on the command line, if the parameter is found in the specified (or default) files, it is modified to reflect  the  speci-
			fied 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, specifying 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  exam-
			ple,

			yields:

			which is an error, whereas,

			yields:

	      Verbose.	When used with the
			option,  the  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.

	      The	option is used to list all occurances of array parameters 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  specified)  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 defi-
       nitions, 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 ALSO

       rc.config(4).

																	 ch_rc(1M)