chkconfig man page on Fedora

Man page or keyword search:  
man Server   31170 pages
apropos Keyword Search (all sections)
Output format
Fedora logo
[printable version]

CHKCONFIG(8)							  CHKCONFIG(8)

NAME
       chkconfig  -  updates  and queries runlevel information for system ser‐
       vices

SYNOPSIS
       chkconfig [--list] [--type type] [name]
       chkconfig --add name
       chkconfig --del name
       chkconfig --override name
       chkconfig  [--level  levels]   [--type	type]	[--no-redirect]	  name
       <on|off|reset|resetpriorities>
       chkconfig [--level levels] [--type type] [--no-redirect] name

DESCRIPTION
       chkconfig  provides  a  simple  command-line  tool  for maintaining the
       /etc/rc[0-6].d directory hierarchy by relieving	system	administrators
       of  the	task  of  directly manipulating the numerous symbolic links in
       those directories.

       This implementation of chkconfig was inspired by the chkconfig  command
       present	in the IRIX operating system. Rather than maintaining configu‐
       ration 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 manage‐
       ment, removing services from management, listing	 the  current  startup
       information  for	 services,  changing  the startup information for ser‐
       vices, and checking the startup state of a particular service.

       When chkconfig is run with only a service name, 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.

       When chkconfig is run with the --list argument, or no arguments at all,
       a listing is displayed of all services and their current configuration.

       If  one	of  on,	 off, reset, or resetpriorities is specified after the
       service name, chkconfig changes the startup information for the	speci‐
       fied  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  on/off state for all runlevels for the service to whatever
       is specified in the init script in question, while the  resetpriorities
       flag  resets  the  start/stop priorities for the service to whatever is
       specified in the init script.

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

       Note that for every service, each runlevel has either a 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.

       chkconfig also can manage xinetd scripts via the means of xinetd.d con‐
       figuration files. Note that only the on, off, and --list	 commands  are
       supported for xinetd.d services.

       chkconfig  supports  a  --type argument to limit actions to only a spe‐
       cific type of services, in the case where services of either  type  may
       share a name. Possible values for type are sysv and xinetd.

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

       --no-redirect
	      When  chkconfig is run on a system that uses systemd as its init
	      system, chkconfig will forward commands to systemd if a  systemd
	      service file exists for it.  This switch turns off the redirect‐
	      ion  to  systemd	and  only  operates   on   the	 symlinks   in
	      /etc/rc[0-6].d.  This  option  is only valid when on, off, or no
	      command (to check enablement) is passed to a service.

       --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.  Note  that default entries in LSB-delimited 'INIT INFO'
	      sections take precedence	over  the  default  runlevels  in  the
	      initscript;  if  any Required-Start or Required-Stop entries are
	      present, the start and stop priorities of	 the  script  will  be
	      adjusted to account for these dependencies.

       --del name
	      The  service  is removed from chkconfig management, and any sym‐
	      bolic links in /etc/rc[0-6].d which pertain to it are removed.

	      Note that future package installs for this service may run  chk‐
	      config  --add,  which  will re-add such links. To disable a ser‐
	      vice, run chkconfig name off.

       --override name
	      If service name is configured exactly as	it  would  be  if  the
	      --add  option  had  been	specified  with	 no  override  file in
	      /etc/chkconfig.d/name, and if /etc/chkconfig.d/name  now	exists
	      and  is  specified  differently from the base initscript, change
	      the configuration for  service  name  to	follow	the  overrides
	      instead of the base configuration.

       --list name
	      This  option  lists  all	of  the services which chkconfig 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 chk‐
       config 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  con‐
       tinuation.

       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 levels 2, 3, 4,
       and 5, that its start priority should be 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.

       chkconfig  also supports LSB-style init stanzas, and will apply them in
       preference to "chkconfig:" lines where available.  A LSB	 stanza	 looks
       like:
       ### BEGIN INIT INFO
       # Provides: foo
       # Required-Start: bar
       # Defalt-Start: 2 3 4 5
       # Default-Stop: 0 1 6
       # Description: Foo init script
       ### END INIT INFO

       In this case, the start priority of "foo" would be changed such that it
       is higher than the "bar" start priority, if  "bar"  is  enabled.	  Care
       must  be	 taken when adding dependencies, as they can cause vast shifts
       in the start and stop priorities of many scripts.

OVERRIDE FILES
       File in /etc/chkconfig.d/servicename are parsed using the same comments
       that  chkconfig notices in init service scripts, and override values in
       the init service scripts themselves.

SEE ALSO
       init(8) ntsysv(8) system-config-services(8)

AUTHOR
       Erik Troan <ewt@redhat.com>

4th Berkeley Distribution	Wed Oct 8 1997			  CHKCONFIG(8)
[top]

List of man pages available for Fedora

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net