Updated documentation for the new user flag 20/head
authorFabien Poussin <fabien.poussin@gmail.com>
Tue, 3 Sep 2019 09:09:01 +0000 (11:09 +0200)
committerFabien Poussin <fabien.poussin@gmail.com>
Tue, 3 Sep 2019 09:11:48 +0000 (11:11 +0200)
README.md
doc/manpages/dinitctl.8.m4

index dfc12a774dde2c362646ec69725fffd7f2b248f7..db37cee8c8cba64624669d751c265148689376bb 100644 (file)
--- a/README.md
+++ b/README.md
@@ -311,10 +311,12 @@ dependents are configured).
 If stopping a service would also require a dependent service to stop, a warning
 will be issued and the `--force` option will be required.
 
-Use the "-s" switch to talk the "system" instance of Dinit, rather than a
-personal instance, e.g:
+Use the "-u" switch to talk the "user" instance of Dinit, rather than the system
+instance, e.g:
 
-    dinitctl -s start mysql   # start system mysql service
+    dinitctl -u start mysql   # start user mysql service
+
+The -u flag is implicitely set when calling dinitctl as a regular user, not when root.
 
 For complete details on the command line, use:
 
@@ -324,9 +326,9 @@ You can "pin" a service in either the stopped or started state, which prevents
 it from changing state either due to a dependency/dependent or a direct
 command:
 
-    dinitctl -s start --pin mysql  # start mysql service, pin it as "started"
-    dinitctl -s stop mysql  # issues stop, but doesn't take effect due to pin
-    dinitctl -s unpin mysql # release pin; service will now stop
+    dinitctl start --pin mysql  # start mysql service, pin it as "started"
+    dinitctl stop mysql  # issues stop, but doesn't take effect due to pin
+    dinitctl unpin mysql # release pin; service will now stop
 
 You can pin a service in the stopped state in order to make sure it doesn't
 get started accidentally (either via a dependency or directly). You can also
@@ -336,7 +338,7 @@ to restart automatically).
 
 Finally, you can list the state of all loaded services:
 
-    dinitctl -s list
+    dinitctl list
 
 This may result in something like the following:
 
index 4040d0b42af46fa4143b0b730ad4053ed5270527..ca3aa370dc803b9a5db0178689b53f3193182750 100644 (file)
@@ -55,8 +55,8 @@ service status.
 \fB\-\-help\fR
 display this help and exit
 .TP
-\fB\-s\fR, \fB\-\-system\fR
-Control the system init process. The default is to control the user process. This option selects
+\fB\-u\fR, \fB\-\-user\fR
+Control the user init process. The default is to control the system process. This option selects
 the path to the control socket used to communicate with the \fBdinit\fR daemon process.
 .TP
 \fB\-\-socket\-path\fR \fIsocket-path\fR, \fB\-p\fR \fIsocket-path\fR