dasharo/systemd
0
0
Fork 0
mirror of https://github.com/Dasharo/systemd.git synced 2026-03-06 15:02:31 -08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #10088 from keszybz/man-systemctl-return

Browse Source 
man: add a description of systemctl return codes
This commit is contained in:
Lennart Poettering
2018-09-25 12:35:36 +02:00
committed by GitHub
parent 7c428bb5d5 4aabca0058
commit 2b5d05fdfe
2 changed files with 60 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
man/systemctl.xml
View File

@@ -1940,8 +1940,56 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
<refsect1>
<title>Exit status</title>
<para>On success, 0 is returned, a non-zero failure
code otherwise.</para>
<para>On success, 0 is returned, a non-zero failure code otherwise.</para>
<para><command>systemctl</command> uses the return codes defined by LSB, as defined in
<ulink url="http://refspecs.linuxbase.org/LSB_3.0.0/LSB-PDA/LSB-PDA/iniscrptact.html">LSB 3.0.0</ulink>.
</para>
<table>
<title>LSB return codes</title>
<tgroup cols='3'>
<thead>
<row>
<entry>Value</entry>
<entry>Description in LSB</entry>
<entry>Use in systemd</entry>
</row>
</thead>
<tbody>
<row>
<entry><constant>0</constant></entry>
<entry>"program is running or service is OK"</entry>
<entry>unit is active</entry>
</row>
<row>
<entry><constant>1</constant></entry>
<entry>"program is dead and <filename>/var/run</filename> pid file exists"</entry>
<entry>unit <emphasis>not</emphasis> failed (used by <command>is-failed</command>)</entry>
</row>
<row>
<entry><constant>2</constant></entry>
<entry>"program is dead and <filename>/var/lock</filename> lock file exists"</entry>
<entry>unused</entry>
</row>
<row>
<entry><constant>3</constant></entry>
<entry>"program is not running"</entry>
<entry>unit is not active</entry>
</row>
<row>
<entry><constant>4</constant></entry>
<entry>"program or service status is unknown"</entry>
<entry>no such unit</entry>
</row>
</tbody>
</tgroup>
</table>
<para>The mapping of LSB service states to systemd unit states is imperfect, so it is better to
not rely on those return values but to look for specific unit states and substates instead.
</para>
</refsect1>
<refsect1>

16
man/systemd.special.xml
View File

@@ -596,14 +596,18 @@
<listitem>
<para>A special target unit that sets up all slice units (see
<citerefentry><refentrytitle>systemd.slice</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for details) that shall be active after boot. By default the generic
<filename>system.slice</filename> slice unit, as well as the root slice unit
<filename>-.slice</filename>, is pulled in and ordered before this unit (see
for details) that shall always be active after boot. By default the generic
<filename>system.slice</filename> slice unit as well as the root slice unit
<filename>-.slice</filename> are pulled in and ordered before this unit (see
below).</para>
<para>It's a good idea to add <varname>WantedBy=slices.target</varname> lines to the
<literal>[Install]</literal> section of all slices units that may be installed
dynamically.</para>
<para>Adding slice units to <filename>slices.target</filename> is generally not
necessary. Instead, when some unit that uses <varname>Slice=</varname> is started, the
specified slice will be started automatically. Adding
<varname>WantedBy=slices.target</varname> lines to the <literal>[Install]</literal>
section should only be done for units that need to be always active. In that case care
needs to be taken to avoid creating a loop through the automatic dependencies on
"parent" slices.</para>
</listitem>
</varlistentry>
<varlistentry>