Document dinitctl "restart" command.
authorDavin McCall <davmac@davmac.org>
Sun, 28 Jul 2019 07:09:30 +0000 (17:09 +1000)
committerDavin McCall <davmac@davmac.org>
Sun, 28 Jul 2019 07:10:59 +0000 (17:10 +1000)
doc/manpages/dinitctl.8.m4

index c40d70024771b8c93858d5e9e4a901a4c677143a..c6db5ce7c27cdef93155b9f5d9d26d814448e6b9 100644 (file)
@@ -12,6 +12,9 @@ dinitctl \- control services supervised by Dinit
 [\fIoptions\fR] \fBstop\fR [\fB\-\-no\-wait\fR] [\fB\-\-pin\fR] \fIservice-name\fR
 .br
 .B dinitctl
+[\fIoptions\fR] \restart\fR [\fB\-\-no\-wait\fR] \fIservice-name\fR
+.br
+.B dinitctl
 [\fIoptions\fR] \fBwake\fR [\fB\-\-no\-wait\fR] \fIservice-name\fR
 .br
 .B dinitctl
@@ -97,9 +100,17 @@ though a service which is starting will continue its startup before then stoppin
 configured to have an interruptible startup or is otherwise at a stage of startup which can be safely
 interrupted).
 .TP
+\fBrestart\fR
+Restart the specified service. The service will be stopped (if it is not already stopped) and then restarted.
+
+The service will not be marked explicitly active if it is not already marked; it is started as if by the
+\fBwake\fR command in that case. Note that since stopping the service may break dependency links, this may
+result in a "floating" service even if the service was not already "floating".
+.TP
 \fBwake\fR
 Start the specified service, but do not mark it as explicitly activated if it is not already so
-marked.
+marked. This may result in a "floating" service which will only stop if explicitly requested, or if a
+dependent starts and then stops (i.e. if a dependency link is reestablished and then broken).
 .TP
 \fBrelease\fR
 Clear the explicit activation mark from a service (service will then stop if it has no active dependents).