feat(doc): Add systemd user service messages
[BK-2020-03.git] / config-shared / syncthing / INSTRUCTIONS.md
index dd68fb7bf4af526cff10b64a29d256256eabfcee..81842be8139d0cbb8d3c0d92bd325fefdb17b151 100644 (file)
@@ -51,12 +51,30 @@ The commands to create a `systemd` system service under user
 `baltakatei` are:
 
     $ sudo systemctl enable syncthing@baltakatei.service
-       $ sudo systemctl start syncthing@baltakatei.service
+    $ sudo systemctl start syncthing@baltakatei.service
+
+The following notifications may appear while running these commands:
+
+    $ systemctl enable syncthing@baltakatei.service
+    Created symlink /etc/systemd/system/multi-user.target.wants/syncthing@baltakatei.service → /lib/systemd/system/syncthing@.service.
 
 The status of the new system service can be verified via:
 
     $ systemctl status syncthing@baltakatei.service
 
+The resulting status data will resemble:
+
+    $ systemctl status syncthing@baltakatei.service 
+    ● syncthing@baltakatei.service - Syncthing - Open Source Continuous File Synchronization for baltakatei
+       Loaded: loaded (/lib/systemd/system/syncthing@.service; enabled; vendor preset: enabled)
+       Active: active (running) since Mon 2020-04-27 09:01:00 PDT; 3min 34s ago
+        Docs: man:syncthing(1)
+     Main PID: 2799 (syncthing)
+       Tasks: 23 (limit: 1132)
+       Memory: 45.3M
+       CGroup: /system.slice/system-syncthing.slice/syncthing@baltakatei.service
+              └─2799 /usr/bin/syncthing -no-browser -no-restart -logflags=0
+
 #### 2.2.b. Enable automatic startup via `systemd` upon login (user service).
 
 For a user service, identify which user under which to run
@@ -68,12 +86,27 @@ The commands to create a `systemd` user service under user
 `baltakatei` are:
 
     $ systemctl --user enable syncthing.service
-       $ systemctl --user start syncthing.service
+    $ systemctl --user start syncthing.service
+
+The following notifications may appear while running these commands:
+
+    Created symlink /home/baltakatei/.config/systemd/user/default.target.wants/syncthing.service → /usr/lib/systemd/user/syncthing.service.
 
 The status of the new user service can be verified via:
 
     $ systemctl --user status syncthing.service
 
+The resulting status data will resemble:
+
+    $ systemctl --user status syncthing.service
+    ● syncthing.service - Syncthing - Open Source Continuous File Synchronization
+       Loaded: loaded (/usr/lib/systemd/user/syncthing.service; enabled; vendor preset: enabled)
+       Active: active (running) since Mon 2020-04-27 09:57:08 PDT; 14s ago
+        Docs: man:syncthing(1)
+     Main PID: 3284 (syncthing)
+       CGroup: /user.slice/user-1000.slice/user@1000.service/syncthing.service
+              └─3284 /usr/bin/syncthing -no-browser -no-restart -logflags=0
+
 ## 3. References
 - <a name="syncthing_20200331_autostart">1.</a> ["Starting Syncthing Automatically"][1]. Date: 2020-03-31. [syncthing.net](https://syncthing.net). Date Accessed: 2020-04-27. [Archive link](https://web.archive.org/web/20200414114635/https://docs.syncthing.net/users/autostart.html). Archive date: 2017-04-14.