UPDATE\-RC.DSection: dpkg utilities (8)
Updated: 2 March 1998
Return to Main Contents
NAMEupdate-rc.d - install and remove System-V style init script links
SYNOPSISupdate-rc.d [-n] [-f] name remove
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 dpkg programmers' manual.
INSTALLING INIT SCRIPT LINKSWhen 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 rearrange 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 service in runlevels 2345 and stop the service in runlevels 016. By default all the links will have sequence code 20, but this can be overridden 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 service 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 follows 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 terminated 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.
REMOVING SCRIPTSWhen 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.
EXAMPLESInsert links using the defaults:
update-rc.d foobar defaultsEquivalent command using explicit argument sets:
update-rc.d foobar start 20 2 3 4 5 . stop 20 0 1 6 .
SEE ALSOdpkg programmers manual,
This document was created by man2html, using the manual pages.
Time: 18:12:36 GMT, December 08, 2021