openrc/man/rc-update.8

.\" Copyright (c) 2007-2009 Roy Marples
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.Dd Jan 13, 2014
.Dt RC-UPDATE 8 SMM
.Os OpenRC
.Sh NAME
.Nm rc-update
.Nd add and remove services to and from a runlevel
.Sh SYNOPSIS
.Nm
.Op Fl s , -stack
.Ar add
.Ar service
.Op Ar runlevel ...
.Nm
.Op Fl s , -stack
.Op Fl a , -all
.Ar delete
.Ar service
.Op Ar runlevel ...
.Nm
.Op Fl u , -update
.Op Fl v , -verbose
.Ar show
.Op Ar runlevel ...
.Sh DESCRIPTION
OpenRC uses named runlevels.  Rather than editing some obscure
file or managing a directory of symlinks,
.Nm
exists to quickly add or delete services to and from from different runlevels.
All services must reside in the
.Pa /etc/init.d
or
.Pa /usr/local/etc/init.d
directories.
They must also be standard OpenRC scripts, meaning they must use
openrc-run.
.Pp
.Bl -tag -width "Fl a , -delete service"
.It Ar add Ar service
Add the
.Ar service
to the
.Ar runlevel
or the current one if none given.
Services added to the boot runlevel must exist in
.Pa /etc/init.d .
.It Ar delete Ar service
Delete the
.Ar service
from the
.Ar runlevel
or the current one if none given.
.It Ar show
Show all enabled services and the runlevels they belong to.  If you specify
runlevels to show, then only those will be included in the output.
.It Fl v , -verbose
Show all services.
.It Fl u , -update
Forces an update of the dependency tree cache.
This may be needed in the event of clock skew (a file in /etc is newer than the
system clock).
.El
.Pp
If the
.Fl s , -stack
option is given then we either add or remove the runlevel from the runlevel.
This allows inheritance of runlevels.
.Pp
If the
.Fl a, -all
option is given, we remove the service from all runlevels. This is
useful, for example, to clean up the dangling symlinks after a service
is removed.
.Sh SEE ALSO
.Xr openrc 8 ,
.Xr openrc-run 8 ,
.Xr rc-status 8
.Sh AUTHORS
.An Roy Marples <roy@marples.name>
.An The OpenRC Team <openrc@gentoo.org>
Typo 2009-05-02 17:01:13 +05:30			`.\" Copyright (c) 2007-2009 Roy Marples`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.\"`
			`.\" Redistribution and use in source and binary forms, with or without`
			`.\" modification, are permitted provided that the following conditions`
			`.\" are met:`
			`.\" 1. Redistributions of source code must retain the above copyright`
			`.\" notice, this list of conditions and the following disclaimer.`
			`.\" 2. Redistributions in binary form must reproduce the above copyright`
			`.\" notice, this list of conditions and the following disclaimer in the`
			`.\" documentation and/or other materials provided with the distribution.`
			`.\"`
			.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
			`.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE`
			`.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE`
			`.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE`
			`.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL`
			`.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS`
			`.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)`
			`.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT`
			`.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY`
			`.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF`
			`.\" SUCH DAMAGE.`
			`.\"`
rc-update: add option to remove a service from all runlevels The -a option,which only applies to the del command, is used to remove a service from all runlevels. X-Gentoo-Bug: 497740 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=497740 2014-01-13 20:48:40 +05:30			`.Dd Jan 13, 2014`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.Dt RC-UPDATE 8 SMM`
			`.Os OpenRC`
			`.Sh NAME`
			`.Nm rc-update`
Whitespace 2012-01-22 05:47:42 +05:30			`.Nd add and remove services to and from a runlevel`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.Sh SYNOPSIS`
			`.Nm`
Add runlevel stacking, #88 This implementation has the limitation that you cannot have a stacked runlevel and service of the same name in a runlevel. 2009-05-02 16:56:45 +05:30			`.Op Fl s , -stack`
We should not use options for rc-update, as add, delete and such are commands. 2008-01-15 15:20:14 +05:30			`.Ar add`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.Ar service`
			`.Op Ar runlevel ...`
			`.Nm`
Add runlevel stacking, #88 This implementation has the limitation that you cannot have a stacked runlevel and service of the same name in a runlevel. 2009-05-02 16:56:45 +05:30			`.Op Fl s , -stack`
rc-update: add option to remove a service from all runlevels The -a option,which only applies to the del command, is used to remove a service from all runlevels. X-Gentoo-Bug: 497740 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=497740 2014-01-13 20:48:40 +05:30			`.Op Fl a , -all`
We should not use options for rc-update, as add, delete and such are commands. 2008-01-15 15:20:14 +05:30			`.Ar delete`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.Ar service`
			`.Op Ar runlevel ...`
			`.Nm`
We now warn about clock skews rc-update -u will force a regen of the dep tree rc_newer_than and rc_olderthan now take another two parameters for newest/oldest file and mtime 2009-01-13 05:23:13 +05:30			`.Op Fl u , -update`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.Op Fl v , -verbose`
We should not use options for rc-update, as add, delete and such are commands. 2008-01-15 15:20:14 +05:30			`.Ar show`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.Op Ar runlevel ...`
			`.Sh DESCRIPTION`
Whitespace 2012-01-22 05:47:42 +05:30			`OpenRC uses named runlevels. Rather than editing some obscure`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`file or managing a directory of symlinks,`
			`.Nm`
			`exists to quickly add or delete services to and from from different runlevels.`
			`All services must reside in the`
			`.Pa /etc/init.d`
			`or`
			`.Pa /usr/local/etc/init.d`
Add runlevel stacking, #88 This implementation has the limitation that you cannot have a stacked runlevel and service of the same name in a runlevel. 2009-05-02 16:56:45 +05:30			`directories.`
Rename runscript to openrc-run This was requested by Debian, because the minicom software, which is available on Debian and other distros, has a binary named runscript. We are keeping a backward compatibility symlink for now, but this allows Debian or any other distro to safely remove the symlink. X-Gentoo-Bug: 494220 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=494220 2013-12-22 02:21:11 +05:30			`They must also be standard OpenRC scripts, meaning they must use`
			`openrc-run.`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.Pp`
			`.Bl -tag -width "Fl a , -delete service"`
We now warn about clock skews rc-update -u will force a regen of the dep tree rc_newer_than and rc_olderthan now take another two parameters for newest/oldest file and mtime 2009-01-13 05:23:13 +05:30			`.It Ar add Ar service`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`Add the`
			`.Ar service`
			`to the`
			`.Ar runlevel`
			`or the current one if none given.`
			`Services added to the boot runlevel must exist in`
			`.Pa /etc/init.d .`
We should not use options for rc-update, as add, delete and such are commands. 2008-01-15 15:20:14 +05:30			`.It Ar delete Ar service`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`Delete the`
			`.Ar service`
			`from the`
			`.Ar runlevel`
			`or the current one if none given.`
We should not use options for rc-update, as add, delete and such are commands. 2008-01-15 15:20:14 +05:30			`.It Ar show`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`Show all enabled services and the runlevels they belong to. If you specify`
			`runlevels to show, then only those will be included in the output.`
			`.It Fl v , -verbose`
			`Show all services.`
We now warn about clock skews rc-update -u will force a regen of the dep tree rc_newer_than and rc_olderthan now take another two parameters for newest/oldest file and mtime 2009-01-13 05:23:13 +05:30			`.It Fl u , -update`
			`Forces an update of the dependency tree cache.`
Typo, #150 Thanks to betelgeuse 2009-02-13 18:22:29 +05:30			`This may be needed in the event of clock skew (a file in /etc is newer than the`
We now warn about clock skews rc-update -u will force a regen of the dep tree rc_newer_than and rc_olderthan now take another two parameters for newest/oldest file and mtime 2009-01-13 05:23:13 +05:30			`system clock).`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.El`
Add runlevel stacking, #88 This implementation has the limitation that you cannot have a stacked runlevel and service of the same name in a runlevel. 2009-05-02 16:56:45 +05:30			`.Pp`
			`If the`
			`.Fl s , -stack`
			`option is given then we either add or remove the runlevel from the runlevel.`
			`This allows inheritance of runlevels.`
Fix mdoc warning for empty line in rc-update man page. X-Gentoo-Bug: 529374 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=529374 2014-11-22 23:11:10 +05:30			`.Pp`
rc-update: add option to remove a service from all runlevels The -a option,which only applies to the del command, is used to remove a service from all runlevels. X-Gentoo-Bug: 497740 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=497740 2014-01-13 20:48:40 +05:30			`If the`
			`.Fl a, -all`
			`option is given, we remove the service from all runlevels. This is`
			`useful, for example, to clean up the dangling symlinks after a service`
			`is removed.`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.Sh SEE ALSO`
Rename the rc binary to openrc Debian requested this rename due to the "rc" binary conflicting with the "rc" binary from the plan 9 shell. We also add a deprecation warning to the binary when it is run as rc to encourage users to switch to openrc instead. X-Gentoo-Bug: 493958 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=493958 2013-12-12 05:09:38 +05:30			`.Xr openrc 8 ,`
Rename runscript to openrc-run This was requested by Debian, because the minicom software, which is available on Debian and other distros, has a binary named runscript. We are keeping a backward compatibility symlink for now, but this allows Debian or any other distro to safely remove the symlink. X-Gentoo-Bug: 494220 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=494220 2013-12-22 02:21:11 +05:30			`.Xr openrc-run 8 ,`
Rework the manpages into mdoc format for easier maintainence 2007-12-17 15:44:54 +05:30			`.Xr rc-status 8`
			`.Sh AUTHORS`
Typo. 2008-12-31 00:38:51 +05:30			`.An Roy Marples <roy@marples.name>`
rc-update: add option to remove a service from all runlevels The -a option,which only applies to the del command, is used to remove a service from all runlevels. X-Gentoo-Bug: 497740 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=497740 2014-01-13 20:48:40 +05:30			`.An The OpenRC Team <openrc@gentoo.org>`