unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-3.1)
Page:
Section:
Apropos / Subsearch:
optional field

UPDATE-RC.D(8)                      sysv-rc                     UPDATE-RC.D(8)



NAME
       update-rc.d - install and remove System-V style init script links

SYNOPSIS
       update-rc.d [-n] [-f] name remove

       update-rc.d [-n] name defaults [NN | NN-start NN-stop]

       update-rc.d   [-n]   name   start|stop  NN  runlevel  runlevel  ...   .
              start|stop NN runlevel runlevel ...  . ...

DESCRIPTION
       update-rc.d automatically updates the System V style init script  links
       /etc/rcrunlevel.d/NNname to scripts /etc/init.d/name.  These are run by
       init when changing runlevels and are generally used to start  and  stop
       system services such as daemons.  runlevel is one of the runlevels sup-
       ported by init, 0123456789S, and NN is the two-digit sequence code used
       by init to decide which order to run the scripts in.

       This  manpage  documents  only  the usage and behaviour of update-rc.d.
       For a discussion of the System V style init script arrangements  please
       see init(8) and the Debian Policy Manual.

INSTALLING INIT SCRIPT LINKS
       When  run with either the defaults, start, or stop options, update-rc.d
       makes  links  /etc/rcrunlevel.d/[SK]NNname  pointing  to   the   script
       /etc/init.d/name,

       If  any  files  /etc/rcrunlevel.d/[SK]??name already exist then update-
       rc.d does nothing.  This is so that the system administrator can  rear-
       range  the links, provided that they leave at least one link remaining,
       without having their configuration overwritten.

       If defaults is used then update-rc.d will make links to start the  ser-
       vice  in  runlevels  2345  and  stop  the service in runlevels 016.  By
       default all the links will have sequence code 20, but this can be over-
       ridden by supplying one or two NN arguments; one argument overrides the
       sequence code for both start and stop links whereas  of  two  arguments
       the  first  overrides  the code for start links and the second that for
       stop links.

       Instead of defaults the runlevels in which to start and stop  the  ser-
       vice may be specified explicitly using a series of sets of arguments:

       Each  of  these  sets  starts with an argument start or stop to specify
       whether start or stop links are to be created by that set.   Then  fol-
       lows NN, the sequence code number for all the links in the set, and one
       or more runlevel numbers as a single argument each.  The set is  termi-
       nated by an argument .  (a single full stop).

       When  explicit  specification, rather than defaults, is used there will
       usually be one start and one stop set.  If different sequence codes are
       required in different runlevels then several start sets or several stop
       sets may be specified.

       The script /etc/init.d/name must exist before  update-rc.d  is  run  to
       create the links.

REMOVING SCRIPTS
       When  invoked  with the remove option, update-rc.d removes any links in
       the /etc/rcrunlevel.d directories to the script /etc/init.d/name.   The
       script  must  have  been deleted already - update-rc.d checks for this.
       update-rc.d is usually called from a package's post-removal script when
       that  script  detects that its first argument is purge, indicating that
       the user has requested the configuration for the package to be removed.
       Any  files  in  the /etc/rcrunlevel.d directories that are not symbolic
       links to the script /etc/init.d/name will be left untouched.

OPTIONS
       -n     Don't do anything, just show what we would do.

       -f     Force removal of symlinks even if /etc/init.d/name still exists.

EXAMPLES
       Insert links using the defaults:
          update-rc.d foobar defaults
       Equivalent command using explicit argument sets:
          update-rc.d foobar start 20 2 3 4 5 . stop 20 0 1 6 .

BUGS
       There should be a way for the system administrator to specify at  least
       the  default start and stop runlevels to be used by defaults and possi-
       bly to override other things as well.

FILES
       /etc/init.d/
              The directory containing the actual init scripts.

       /etc/rc?.d/
              The directories containing the links used by init and managed by
              update-rc.d.

       /etc/init.d/skeleton
              Model for use by writers of init.d scripts.

SEE ALSO
       Debian Policy Manual,
       /etc/init.d/skeleton,
       init(8).



Debian Project                 23 December 2003                 UPDATE-RC.D(8)