aboutsummaryrefslogtreecommitdiffstats
path: root/doc/s6_live.html
diff options
context:
space:
mode:
authorLaurent Bercot <ska-skaware@skarnet.org>2026-09-26 19:33:56 +0000
committerLaurent Bercot <ska-skaware@skarnet.org>2026-09-26 19:33:56 +0000
commite2b8022e7dca5ee139a82288a31098b8f55c273b (patch)
treec437594d7c79d59b6120792c1ab8096f20a2e31b /doc/s6_live.html
parent769e16b92767c28bf18b80e29f1b1fc87b80fb45 (diff)
downloads6-frontend-e2b8022e7dca5ee139a82288a31098b8f55c273b.tar.gz
Document s6 live status more accurately
Diffstat (limited to 'doc/s6_live.html')
-rw-r--r--doc/s6_live.html21
1 files changed, 16 insertions, 5 deletions
diff --git a/doc/s6_live.html b/doc/s6_live.html
index 410421f..8ef889c 100644
--- a/doc/s6_live.html
+++ b/doc/s6_live.html
@@ -67,12 +67,23 @@ and usage of the <tt>s6 live</tt> command. It is not as detailed as this page.
for every s6-rc service listed in <em>servicenames</em>. If <em>servicenames</em>
is empty, then it prints a line for all the services present in the
current live database. </li>
- <li> Every line is: the name of the service, a slash character (<tt>/</tt>),
-then <tt>up</tt> or <tt>down</tt> depending on the current state of the service.
- <li> If the output is a terminal or you have specified <tt>--color=yes</tt>
+ <li> Every line is a series of fields.
+ <ul>
+ <li> The fields are normally separated by a slash character (<tt>/</tt>). </li>
+ <li> But if the output is a terminal or you have specified <tt>--color=yes</tt>
in the generic s6 options, and s6-frontend is built with util-linux support,
-then the output is pretty-printed instead of having a slash separate the name
-of the service from its state. </li>
+then the output is pretty-printed, and the fields are displayed in columns instead. </li>
+ </ul> </li>
+ <li> The currently displayed fields are:
+ <ul>
+ <li> The name of the service </li>
+ <li> The type of the service (<tt>longrun</tt> or <tt>oneshot</tt>) </li>
+ <li> Whether the service is marked as essential (<tt>essential</tt>) or not (blank) </li>
+ <li> The state of the service (<tt>up</tt> or <tt>down</tt>) </li>
+ <li> If the service is up: whether it has been explicitly brought up by the
+user or by being listed in the default bundle (<tt>explicit</tt>), or it has been pulled
+by the dependency engine because an explicit service depended on it (<tt>pulled</tt>). </li>
+ </ul> </li>
</ul>
<h4> Options </h4>