emo/openrc
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
910e3e2a0e
openrc/man/rc-service.8

105 lines
2.1 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 rc-service and update all softlevel refs to runlevel.
2008-03-19 22:41:50 +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 rc-service and update all softlevel refs to runlevel.
2008-03-19 22:41:50 +05:30
.\"
Add -i, --ifexists so that we can do this rc-sercice -i foo -- restart instead of this rc-service -e foo && rc-service foo -- restart
2009-05-01 13:08:57 +05:30
.Dd May 1, 2009
Add rc-service and update all softlevel refs to runlevel.
2008-03-19 22:41:50 +05:30
.Dt RC-SERVICE 8 SMM
.Os OpenRC
.Sh NAME
.Nm rc-service
Whitespace
2012-01-22 05:47:42 +05:30
.Nd locate and run an OpenRC service with the given arguments
Add rc-service and update all softlevel refs to runlevel.
2008-03-19 22:41:50 +05:30
.Sh SYNOPSIS
.Nm
rc-service: add --ifcrashed option This works like the other --if options. If the service is crashed, run the command. This fixes #154.
2017-12-05 04:47:17 +05:30
.Op Fl c , -ifcrashed
.Ar service cmd
.Op Ar ...
.Nm
rc-service: add -d/--debug and -D/--nodeps options
2018-05-16 03:29:21 +05:30
.Fl d , -debug
.Ar service cmd
.Op Ar ...
.Nm
.Fl D , -nodeps
.Ar service cmd
.Op Ar ...
.Nm
Add -i, --ifexists so that we can do this rc-sercice -i foo -- restart instead of this rc-service -e foo && rc-service foo -- restart
2009-05-01 13:08:57 +05:30
.Op Fl i , -ifexists
Add rc-service and update all softlevel refs to runlevel.
2008-03-19 22:41:50 +05:30
.Ar service cmd
.Op Ar ...
Add --list to rc-service to list all available services.
2008-03-21 14:40:59 +05:30
.Nm
rc-service: add --ifinactive and --ifnotstarted flags X-Gentoo-Bug: 523174 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=523174
2014-09-22 00:24:51 +05:30
.Op Fl I , -ifinactive
.Ar service cmd
.Op Ar ...
.Nm
.Op Fl N , -ifnotstarted
.Ar service cmd
.Op Ar ...
rc-service: add --ifstarted and --ifstopped options
2018-05-16 23:55:22 +05:30
.Nm
.Op Fl s , -ifstarted
.Ar service cmd
.Op Ar ...
.Nm
.Op Fl S , -ifstopped
.Ar service cmd
.Op Ar ...
rc-service: add --ifinactive and --ifnotstarted flags X-Gentoo-Bug: 523174 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=523174
2014-09-22 00:24:51 +05:30
.Nm
Add --exists and --resolve to rc-service.
2008-03-26 13:38:47 +05:30
.Fl e , -exists
.Ar service
.Nm
rc-service: add a --dry-run option This is for #225.
2018-05-15 05:30:04 +05:30
.Fl Z , -dry-run
Man: rc-service man page cleanups
2018-05-16 03:39:56 +05:30
.Ar service cmd
.Op Ar ...
rc-service: add a --dry-run option This is for #225.
2018-05-15 05:30:04 +05:30
.Nm
Add -i, --ifexists so that we can do this rc-sercice -i foo -- restart instead of this rc-service -e foo && rc-service foo -- restart
2009-05-01 13:08:57 +05:30
.Fl l , -list
.Nm
Add --exists and --resolve to rc-service.
2008-03-26 13:38:47 +05:30
.Fl r , -resolve
.Ar service
Add rc-service and update all softlevel refs to runlevel.
2008-03-19 22:41:50 +05:30
.Sh DESCRIPTION
Whitespace
2012-01-22 05:47:42 +05:30
Service scripts could be in different places on different systems.
Add rc-service and update all softlevel refs to runlevel.
2008-03-19 22:41:50 +05:30
.Nm
locates the specified service and runs it with the given arguments.
Add -i, --ifexists so that we can do this rc-sercice -i foo -- restart instead of this rc-service -e foo && rc-service foo -- restart
2009-05-01 13:08:57 +05:30
If
.Fl i , -ifexists
is given then
.Nm
returns 0 even if the service does not exist.
rc-service: add --ifinactive and --ifnotstarted flags X-Gentoo-Bug: 523174 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=523174
2014-09-22 00:24:51 +05:30
If
.Fl I , -ifinactive
or
.Fl N , -ifnotstarted
is given then
.Nm
returns 0 if the service exists but is in the wrong state.
Add --list to rc-service to list all available services.
2008-03-21 14:40:59 +05:30
.Pp
If given the
.Fl l , -list
argument then
.Nm
will list all available services.
Add --exists and --resolve to rc-service.
2008-03-26 13:38:47 +05:30
.Pp
Add -i, --ifexists so that we can do this rc-sercice -i foo -- restart instead of this rc-service -e foo && rc-service foo -- restart
2009-05-01 13:08:57 +05:30
.Fl e , -exists
Add --exists and --resolve to rc-service.
2008-03-26 13:38:47 +05:30
return 0 if it can find
.Ar service ,
otherwise -1.
Add -i, --ifexists so that we can do this rc-sercice -i foo -- restart instead of this rc-service -e foo && rc-service foo -- restart
2009-05-01 13:08:57 +05:30
.Fl r , -resolve
Add --exists and --resolve to rc-service.
2008-03-26 13:38:47 +05:30
does the same and also prints the full path of the service to stdout.
rc-service: add a --dry-run option This is for #225.
2018-05-15 05:30:04 +05:30
.Pp
rc-service: add -d/--debug and -D/--nodeps options
2018-05-16 03:29:21 +05:30
.Fl d , -debug
sets -x when running the service script(s).
.Pp
.Fl D , -nodeps
ignores dependencies when running the service.
.Pp
rc-service: add a --dry-run option This is for #225.
2018-05-15 05:30:04 +05:30
.Fl Z , -dry-run
Man: rc-service man page cleanups
2018-05-16 03:39:56 +05:30
displays commands rather than executing them.
Add rc-service and update all softlevel refs to runlevel.
2008-03-19 22:41:50 +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 ,
Add --exists and --resolve to rc-service.
2008-03-26 13:38:47 +05:30
.Xr stdout 3
Add rc-service and update all softlevel refs to runlevel.
2008-03-19 22:41:50 +05:30
.Sh AUTHORS
Typo.
2008-12-31 00:38:51 +05:30
.An Roy Marples <roy@marples.name>
Reference in New Issue Copy Permalink