Skip to content

Commit

Permalink
Improve examples/var_service READMEs
Browse files Browse the repository at this point in the history
Signed-off-by: Denys Vlasenko <vda.linux@googlemail.com>
  • Loading branch information
Denys Vlasenko committed Feb 21, 2014
1 parent 265a74b commit 192c14b
Show file tree
Hide file tree
Showing 13 changed files with 71 additions and 2 deletions.
13 changes: 11 additions & 2 deletions examples/var_service/README
Expand Up @@ -9,6 +9,15 @@ env - PATH=... <other vars=...> runsvdir /var/service &
from one of system startup scripts. (Google "man runsvdir" and "man runsv"
for more info about these tools).

You can try or debug an individual service by running its SERVICE_DIR/run script.
In this case, its stdout and stderr go to your terminal.

You can also run "runsv SERVICE_DIR", which runs both the service
and its logger service (SERVICE_DIR/log/run) if logger service exists.
If logger service exists, the output will go to it instead of the terminal.

"runsvdir DIR" merely runs "runsv SERVICE_DIR" for every subdirectory in DIR.

Some existing examples:

var_service/dhcp_if -
Expand Down Expand Up @@ -47,8 +56,8 @@ This even works while fw service runs: if dhcp signals fw to (re)start
while fw runs, fw will not stop after its execution, but will re-execute once,
picking up dhcp's new configuration.
This is achieved very simply by having
# Make ourself one-shot
sv o .
# Make ourself one-shot
sv o .
at the very beginning of fw/run script, not at the end.
Therefore, any "sv u /var/run/service/fw" command by any other
script "undoes" o(ne-shot) command if fw still runs, thus
Expand Down
5 changes: 5 additions & 0 deletions examples/var_service/dhcp_if/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/dhcp_if_pinger/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/ftpd/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/fw/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/getty_tty1/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/gpm/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/httpd/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/ifplugd_if/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/inetd/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/nmeter/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/ntpd/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.
5 changes: 5 additions & 0 deletions examples/var_service/tftpd/README
@@ -0,0 +1,5 @@
The real README file is one directory up.

This directory's run script can have useful comments.
If it doesn't but you feel it should, please send a patch
to busybox's mailing list.

0 comments on commit 192c14b

Please sign in to comment.