emo/openrc
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
3054046e18
openrc/man/openrc.8

99 lines
2.9 KiB
Groff
Raw Normal View History

Convert OpenRC to a centralized copyright/license structure In the past, OpenRC was a hybrid of a centralized and file-scope license/copyright structure. I followed the instructions from the Software Freedom Law Center [1] to convert to a Centralized structure where possible, for easier future maintenance. [1] https://softwarefreedom.org/resources/2012/ManagingCopyrightInformation.html
2015-12-05 04:22:19 +05:30
.\" Copyright (c) 2007-2015 The OpenRC Authors.
.\" See the Authors file at the top-level directory of this distribution and
use HEAD in git URIs to point to the default branch This makes the URIs shorter and dynamic: whatever the default branch the repo uses will be used.
2021-12-21 06:37:00 +05:30
.\" https://github.com/OpenRC/openrc/blob/HEAD/AUTHORS
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.\"
Convert OpenRC to a centralized copyright/license structure In the past, OpenRC was a hybrid of a centralized and file-scope license/copyright structure. I followed the instructions from the Software Freedom Law Center [1] to convert to a Centralized structure where possible, for easier future maintenance. [1] https://softwarefreedom.org/resources/2012/ManagingCopyrightInformation.html
2015-12-05 04:22:19 +05:30
.\" This file is part of OpenRC. It is subject to the license terms in
.\" the LICENSE file found in the top-level directory of this
use HEAD in git URIs to point to the default branch This makes the URIs shorter and dynamic: whatever the default branch the repo uses will be used.
2021-12-21 06:37:00 +05:30
.\" distribution and at https://github.com/OpenRC/openrc/blob/HEAD/LICENSE
Convert OpenRC to a centralized copyright/license structure In the past, OpenRC was a hybrid of a centralized and file-scope license/copyright structure. I followed the instructions from the Software Freedom Law Center [1] to convert to a Centralized structure where possible, for easier future maintenance. [1] https://softwarefreedom.org/resources/2012/ManagingCopyrightInformation.html
2015-12-05 04:22:19 +05:30
.\" This file may not be copied, modified, propagated, or distributed
.\" except according to the terms contained in the LICENSE file.
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.\"
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
.Dd May 2, 2009
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
.Dt OPENRC 8 SMM
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Os OpenRC
.Sh NAME
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
.Nm openrc
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Nd stops and starts services for the specified runlevel
.Sh SYNOPSIS
.Nm
rc: allow switching runlevels without stopping services OpenRC, by default, stops all services that are not listed in a runlevel when rc is used to switch runlevels. This adds a -n/--no-stop command line option to rc which tells it to skip stopping the services which are not in the runlevel. Reported-by: gentoo@thoth.purplefrog.com X-Gentoo-Bug: 372585 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=372585
2013-04-28 23:21:12 +05:30
.Op Fl n , -no-stop
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Op Fl o , -override
.Op Ar runlevel
.Sh DESCRIPTION
.Nm
rc: allow switching runlevels without stopping services OpenRC, by default, stops all services that are not listed in a runlevel when rc is used to switch runlevels. This adds a -n/--no-stop command line option to rc which tells it to skip stopping the services which are not in the runlevel. Reported-by: gentoo@thoth.purplefrog.com X-Gentoo-Bug: 372585 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=372585
2013-04-28 23:21:12 +05:30
first stops any services that are not in the specified runlevel unless
--no-stop is specified, then starts any services in the runlevel and
stacked runlevels added by
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Nm rc-update
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
that are not currently started.
rc: allow switching runlevels without stopping services OpenRC, by default, stops all services that are not listed in a runlevel when rc is used to switch runlevels. This adds a -n/--no-stop command line option to rc which tells it to skip stopping the services which are not in the runlevel. Reported-by: gentoo@thoth.purplefrog.com X-Gentoo-Bug: 372585 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=372585
2013-04-28 23:21:12 +05:30
If no runlevel is specified, we use the current runlevel.
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Pp
There are some special runlevels that you should be aware of:
.Bl -tag -width "shutdown"
.It Ar sysinit
Brings up any system specific stuff such as
.Pa /dev ,
.Pa /proc
and optionally
.Pa /sys
Typo, thanks to dberkholz.
2008-01-15 14:56:29 +05:30
for Linux based systems. It also mounts
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Pa /lib/rc/init.d
We don't mount /lib/rc/init.d when / is rw at boot.
2008-03-08 20:48:53 +05:30
as a ramdisk using tmpfs where available unless / is mounted rw at boot.
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Nm
uses
.Pa /lib/rc/init.d
to hold state information about the services it runs.
sysinit always runs when the host first starts should not be run again.
.It Ar boot
Generally the only services you should add to the boot runlevel are those
which deal with the mounting of filesystems, set the initial state of attached
peripherals and logging.
Remove sysvinit specific code. The runlevels shutdown, reboot, sysinit and single should be called by init(8) and shutdown(8) and not manually. sysvinit users will have to add sulogin to their inittab to secure the console.
2008-10-27 23:31:03 +05:30
Hotplugged services are added to the boot runlevel by the system.
All services in the boot and sysinit runlevels are automatically included
in all other runlevels except for those listed here.
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.It Ar single
Remove sysvinit specific code. The runlevels shutdown, reboot, sysinit and single should be called by init(8) and shutdown(8) and not manually. sysvinit users will have to add sulogin to their inittab to secure the console.
2008-10-27 23:31:03 +05:30
Stops all services except for those in the sysinit runlevel.
Don't allow SYSVINIT parameters through anymore. RC_REBOOT is now yes when rebooting. Document the special reboot runlevel.
2009-01-13 16:32:00 +05:30
.It Ar reboot
Changes to the shutdown runlevel and then reboots the host.
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.It Ar shutdown
Don't allow SYSVINIT parameters through anymore. RC_REBOOT is now yes when rebooting. Document the special reboot runlevel.
2009-01-13 16:32:00 +05:30
Changes to the shutdown runlevel and then halts the host.
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.El
Remove sysvinit specific code. The runlevels shutdown, reboot, sysinit and single should be called by init(8) and shutdown(8) and not manually. sysvinit users will have to add sulogin to their inittab to secure the console.
2008-10-27 23:31:03 +05:30
.Pp
You should not call any of these runlevels yourself.
Instead you should use
.Xr init 8
and
.Xr shutdown 8
and let them call these special runlevels.
man/openrc.8: populate OPTIONS from --help output This fixes #378.
2020-08-30 08:49:26 +05:30
.Sh OPTIONS
.Pp
.Bl -tag -width "-o , --override"
.It Fl n , -no-stop
Do not stop any services.
.It Fl o , -override
Override the next runlevel to change into when leaving single user or boot
runlevels
.It Fl s , -service
Run the service specified with the rest of the arguments.
.It Fl S , -sys
Output the RC system type, if any.
.It Fl h , -help
Display usage information and exit.
.It Fl C , -nocolor
Disable color output.
.It Fl V , -version
Display software version.
.It Fl v , -verbose
Run verbosely.
.It Fl q , -quiet
Run quietly (repeat to suppress errors).
.El
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Sh SEE ALSO
man/openrc.8: add openrc-run.8 to see also This fixes #283.
2019-01-16 02:55:22 +05:30
.Xr openrc-run 8 ,
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Xr rc-status 8 ,
Remove sysvinit specific code. The runlevels shutdown, reboot, sysinit and single should be called by init(8) and shutdown(8) and not manually. sysvinit users will have to add sulogin to their inittab to secure the console.
2008-10-27 23:31:03 +05:30
.Xr rc-update 8 ,
.Xr init 8 ,
.Xr shutdown 8
Add a manpage for rc.8
2007-12-20 21:24:19 +05:30
.Sh AUTHORS
Don't allow SYSVINIT parameters through anymore. RC_REBOOT is now yes when rebooting. Document the special reboot runlevel.
2009-01-13 16:32:00 +05:30
.An Roy Marples Aq roy@marples.name
Reference in New Issue Copy Permalink