chkconfig  -  updates and queries runlevel information for
       system services


SYNOPSIS

       chkconfig --list [name]
       chkconfig --add name
       chkconfig --del name
       chkconfig [--level levels] name <on|off|reset>
       chkconfig [--level levels] name


DESCRIPTION

       chkconfig provides a simple command-line  tool  for  main­
       taining  the /etc/rc[0-6].d directory hierarchy by reliev­
       ing system administrators of the task of directly  manipu­
       lating the numerous symbolic links in those directories.

       This  implementation of chkconfig was inspired by the chk­
       config command  present  in  the  IRIX  operating  system.
       Rather  than maintaining configuration information outside
       of the /etc/rc[0-6].d  hierarchy,  however,  this  version
       directly  manages  the  symlinks  in  /etc/rc[0-6].d. This
       leaves all of the configuration information regarding what
       services init starts in a single location.

       chkconfig has five distinct functions: adding new services
       for management, removing services from management, listing
       the current startup information for services, changing the
       startup information for services, and checking the startup
       state of a particular service.

       When  chkconfig  is  run  without any options, it displays
       usage information.  If only a service name  is  given,  it
       checks  to  see if the service is configured to be started
       in the current runlevel. If it is, chkconfig returns true;
       otherwise it returns false. The --level option may be used
       to have chkconfig query  an  alternative  runlevel  rather
       than the current one.

       If one of on, off, or reset is specified after the service
       name, chkconfig changes the startup  information  for  the
       specified service.  The on and off flags cause the service
       to be started or stopped, respectively, in  the  runlevels
       being changed.  The reset flag resets the startup informa­
       tion for the service to whatever is specified in the  init
       script in question.

       By  default,  the on and off options affect only runlevels
       3, 4, and 5, while reset affects  all  of  the  runlevels.
       The  --level option may be used to specify which runlevels
       are affected.

       start  script or a stop script.  When switching runlevels,
       init will not re-start  an  already-started  service,  and
       will not re-stop a service that is not running.


OPTIONS

       --level levels
              Specifies  the  run levels an operation should per­
              tain to. It is given as a string of numbers from  0
              to 7. For example, --level 35 specifies runlevels 3
              and 5.

       --add name

              This option adds a new service  for  management  by
              chkconfig.   When a new service is added, chkconfig
              ensures that the service has either a  start  or  a
              kill  entry  in  every runlevel. If any runlevel is
              missing such an entry, chkconfig creates the appro­
              priate  entry as specified by the default values in
              the init script.

       --del name
              The service is removed from  chkconfig  management,
              and any symbolic links in /etc/rc[0-6].d which per­
              tain to it are removed.

       --list name
              This option lists all of the services which chkcon­
              fig  knows  about,  and whether they are stopped or
              started in each runlevel.  If  name  is  specified,
              information in only display about service name.


RUNLEVEL FILES

       Each service which should be manageable by chkconfig needs
       two or more commented lines added to  its  init.d  script.
       The  first line tells chkconfig what runlevels the service
       should be started in by default, as well as the start  and
       stop  priority  levels.  If  the  service  should  not, by
       default, be started in any runlevels, a - should  be  used
       in  place of the runlevels list.  The second line contains
       a description for the service, and may be extended  across
       multiple lines with backslash continuation.

       For example, random.init has these three lines:
       # chkconfig: 2345 20 80
       # description: Saves and restores system entropy pool for \
       #              higher quality random number generation.
       This  says  that  the  random  script should be started in

       20,  and  that its stop priority should be 80.  You should
       be able to figure out what the  description  says;  the  \
       causes the line to be continued.  The extra space in front
       of the line is ignored.


SEE ALSO

       init(8) ntsysv(8) tksysv(8)


AUTHOR

       Erik Troan <ewt@redhat.com>


Man(1) output converted with man2html