aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorWilliam Hubbs <w.d.hubbs@gmail.com>2015-12-03 17:37:38 -0600
committerWilliam Hubbs <w.d.hubbs@gmail.com>2015-12-03 17:37:38 -0600
commitb810473e4f7218afbb7047890860c15a8c45472b (patch)
tree9449c5cc0b26e45250fbb83ccfe25497c1793934
parent627e925463068e754ffd869f99a43634d6d9631e (diff)
man/openrc-run.8: Clarify documentation on dependencies and keywords
Provide an example of using the -containers keyword and clarify documentation on some of the dependency functions.
-rw-r--r--man/openrc-run.815
1 files changed, 10 insertions, 5 deletions
diff --git a/man/openrc-run.8 b/man/openrc-run.8
index 5d18fe59..bbb8b502 100644
--- a/man/openrc-run.8
+++ b/man/openrc-run.8
@@ -166,23 +166,25 @@ will start and stop it in the right order in relation to other services.
As it's a function it can be very flexible, see the example below.
Here is a list of the functions you can use in a
.Ic depend
-function. You simply pass the names of the services to it to add to that
-dependency type, or prefix it with ! to remove it.
+function. You simply pass the names of the services you want to add to
+that dependency type to the function, or prefix the names with ! to
+remove them from the dependencies.
.Bl -tag -width "RC_DEFAULTLEVEL"
.It Ic need
The service will refuse to start until needed services have started and it
will refuse to stop until any services that need it have stopped.
.It Ic use
-The service will attempt to start any services we use that have been added
+The service will attempt to start any services it uses that have been added
to the runlevel.
.It Ic want
-The service will attempt to start any services we want.
+The service will attempt to start any services it wants, regardless of
+whether they have been added to the runlevel.
.It Ic after
The service will start after these services and stop before these services.
.It Ic before
The service will start before these services and stop after these services.
.It Ic provide
-We provide this virtual service. For example, named provides dns.
+The service provides this virtual service. For example, named provides dns.
Virtual services take precedence over real services, so it is highly
recommended that you do not have a real service that has the same name
as a virtual service.
@@ -471,6 +473,9 @@ rc_net_tap1_provide="!net"
# It's also possible to negate keywords. This is mainly useful for prefix
# users testing OpenRC.
rc_keyword="!-prefix"
+# This can also be used to block a script from runining in all
+# containers except one or two
+rc_keyword="!-containers !-docker"
.Ed
.Sh EXAMPLES
.Pp