*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> ch_rc (1m)              


 ch_rc(1M)                                                         ch_rc(1M)

 NAME    [Toc]    [Back]
      ch_rc - change system configuration file

 SYNOPSIS    [Toc]    [Back]
      /usr/sbin/ch_rc -a|-r|-l [-v] [-A] [-R root] [-p
      {parameter|parameter=value}...] [file...]

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
           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

                     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.

 Hewlett-Packard Company            - 1 -      HP-UX 11i Version 2: Sep 2004

 ch_rc(1M)                                                         ch_rc(1M)

                     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>


                          VALUE=a b c

                     which is an error, whereas,

                          ch_rc -a -p VALUE='"a b c"' <file>


                          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 occurrence
                     of the parameter.

           -A        The -A option is used to list all occurrences 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

                     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    [Toc]    [Back]
      ch_rc exits with one of the following values:

 Hewlett-Packard Company            - 2 -      HP-UX 11i Version 2: Sep 2004

 ch_rc(1M)                                                         ch_rc(1M)

           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    [Toc]    [Back]
      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.


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

 WARNINGS    [Toc]    [Back]
      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. Also, only certain formats are supported and
      whole lines are replaced.

      Parameters must not be exported.  If the parameters are exported, only
      the parameter value (name=value) pair is stored and the rest of the
      data like an export special command in front of a name value pair,
      whitespace, and comments are deleted from the line.

 AUTHOR    [Toc]    [Back]
      ch_rc was developed by HP.

 FILES    [Toc]    [Back]
      /etc/rc.config           system configuration database driver file
      /etc/rc.config.d         directory containing system configuration

 Hewlett-Packard Company            - 3 -      HP-UX 11i Version 2: Sep 2004

 ch_rc(1M)                                                         ch_rc(1M)

 SEE ALSO    [Toc]    [Back]

 Hewlett-Packard Company            - 4 -      HP-UX 11i Version 2: Sep 2004
[ Back ]
 Similar pages
Name OS Title
chattr Linux change file attributes on a Linux second extended file system
sizer Tru64 Displays information about the system or kernel, or creates a system configuration file
pivot_root Linux change the root file system
pivot_root Linux change the root file system
vxresize HP-UX change the length of a volume containing a file system
mk_kernel HP-UX load a kernel configuration from a system file
nsswitch.conf Linux System Databases and Name Service Switch configuration file
fs_wrapper HP-UX configuration and binary files used by file system administration commands
ups_conf HP-UX HP PowerTrust Uninterruptible Power System (UPS) monitor configuration file
ssdi IRIX consult configuration file and load DSO corresponding to the source for a given system database
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service