| 1 |
commit: b810473e4f7218afbb7047890860c15a8c45472b |
| 2 |
Author: William Hubbs <w.d.hubbs <AT> gmail <DOT> com> |
| 3 |
AuthorDate: Thu Dec 3 23:37:38 2015 +0000 |
| 4 |
Commit: William Hubbs <williamh <AT> gentoo <DOT> org> |
| 5 |
CommitDate: Thu Dec 3 23:37:38 2015 +0000 |
| 6 |
URL: https://gitweb.gentoo.org/proj/openrc.git/commit/?id=b810473e |
| 7 |
|
| 8 |
man/openrc-run.8: Clarify documentation on dependencies and keywords |
| 9 |
|
| 10 |
Provide an example of using the -containers keyword and clarify |
| 11 |
documentation on some of the dependency functions. |
| 12 |
|
| 13 |
man/openrc-run.8 | 15 ++++++++++----- |
| 14 |
1 file changed, 10 insertions(+), 5 deletions(-) |
| 15 |
|
| 16 |
diff --git a/man/openrc-run.8 b/man/openrc-run.8 |
| 17 |
index 5d18fe5..bbb8b50 100644 |
| 18 |
--- a/man/openrc-run.8 |
| 19 |
+++ b/man/openrc-run.8 |
| 20 |
@@ -166,23 +166,25 @@ will start and stop it in the right order in relation to other services. |
| 21 |
As it's a function it can be very flexible, see the example below. |
| 22 |
Here is a list of the functions you can use in a |
| 23 |
.Ic depend |
| 24 |
-function. You simply pass the names of the services to it to add to that |
| 25 |
-dependency type, or prefix it with ! to remove it. |
| 26 |
+function. You simply pass the names of the services you want to add to |
| 27 |
+that dependency type to the function, or prefix the names with ! to |
| 28 |
+remove them from the dependencies. |
| 29 |
.Bl -tag -width "RC_DEFAULTLEVEL" |
| 30 |
.It Ic need |
| 31 |
The service will refuse to start until needed services have started and it |
| 32 |
will refuse to stop until any services that need it have stopped. |
| 33 |
.It Ic use |
| 34 |
-The service will attempt to start any services we use that have been added |
| 35 |
+The service will attempt to start any services it uses that have been added |
| 36 |
to the runlevel. |
| 37 |
.It Ic want |
| 38 |
-The service will attempt to start any services we want. |
| 39 |
+The service will attempt to start any services it wants, regardless of |
| 40 |
+whether they have been added to the runlevel. |
| 41 |
.It Ic after |
| 42 |
The service will start after these services and stop before these services. |
| 43 |
.It Ic before |
| 44 |
The service will start before these services and stop after these services. |
| 45 |
.It Ic provide |
| 46 |
-We provide this virtual service. For example, named provides dns. |
| 47 |
+The service provides this virtual service. For example, named provides dns. |
| 48 |
Virtual services take precedence over real services, so it is highly |
| 49 |
recommended that you do not have a real service that has the same name |
| 50 |
as a virtual service. |
| 51 |
@@ -471,6 +473,9 @@ rc_net_tap1_provide="!net" |
| 52 |
# It's also possible to negate keywords. This is mainly useful for prefix |
| 53 |
# users testing OpenRC. |
| 54 |
rc_keyword="!-prefix" |
| 55 |
+# This can also be used to block a script from runining in all |
| 56 |
+# containers except one or two |
| 57 |
+rc_keyword="!-containers !-docker" |
| 58 |
.Ed |
| 59 |
.Sh EXAMPLES |
| 60 |
.Pp |
Archives