From 77e9da01ad6383aab4d50a00b705ec96f16cb55e Mon Sep 17 00:00:00 2001

From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>

Date: Sun, 8 Dec 2013 18:56:16 -0500

Subject: [PATCH] man: document 'is-enabled' output

https://bugzilla.redhat.com/show_bug.cgi?id=953077

---

 man/systemctl.xml | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++-----

 1 file changed, 59 insertions(+), 5 deletions(-)

diff --git a/man/systemctl.xml b/man/systemctl.xml

index 166282c..b4bc15d 100644

--- a/man/systemctl.xml

+++ b/man/systemctl.xml

@@ -437,7 +437,7 @@ systemctl start foo

         <listitem>

           <para>When used with <command>enable</command>,

-          <command>disable</command>, <command>is-enabled</command>

+          <command>disable</command>,

           (and related commands), make changes only temporarily, so

           that they are lost on the next reboot. This will have the

           effect that changes are not made in subdirectories of

@@ -885,10 +885,64 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service

           <listitem>

             <para>Checks whether any of the specified unit files are

-            enabled (as with <command>enable</command>). Returns an exit

-            code of 0 if at least one is enabled, non-zero

-            otherwise. Prints the current enable status. To suppress

-            this output, use <option>--quiet</option>.</para>

+            enabled (as with <command>enable</command>). Returns an

+            exit code of 0 if at least one is enabled, non-zero

+            otherwise. Prints the current enable status (see table).

+            To suppress this output, use <option>--quiet</option>.

+            </para>

+

+            

+              <title>

+                <command>is-enabled</command> output

+              </title>

+

+              <tgroup cols='3'>

+                

+                  <row>

+                    <entry>Printed string</entry>

+                    <entry>Meaning</entry>

+                    <entry>Return value</entry>

+                  </row>

+                

+                

+                  <row>

+                    <entry><literal>enabled</literal></entry>

+                    <entry morerows='1'>Enabled through a symlink in <filename>.wants</filename> directory (permanently or just in <filename>/run</filename>)</entry>

+                    <entry morerows='1'>0</entry>

+                  </row>

+                  <row>

+                    <entry><literal>enabled-runtime</literal></entry>

+                  </row>

+                  <row>

+                    <entry><literal>linked</literal></entry>

+                    <entry morerows='1'>Made available through a symlink to the unit file (permanently or just in <filename>/run</filename>)</entry>

+                    <entry morerows='1'>1</entry>

+                  </row>

+                  <row>

+                    <entry><literal>linked-runtime</literal></entry>

+                  </row>

+                  <row>

+                    <entry><literal>masked</literal></entry>

+                    <entry morerows='1'>Disabled entirely (permanently or just in <filename>/run</filename>)</entry>

+                    <entry morerows='1'>1</entry>

+                  </row>

+                  <row>

+                    <entry><literal>masked-runtime</literal></entry>

+                  </row>

+                  <row>

+                    <entry><literal>static</literal></entry>

+                    <entry>Unit is not enabled, but has no provisions for enabling in [Install] section</entry>

+                    <entry>1</entry>

+                  </row>

+                  <row>

+                    <entry><literal>disabled</literal></entry>

+                    <entry>Unit is not enabled</entry>

+                    <entry>1</entry>

+                  </row>

+                

+              </tgroup>

+            

+

           </listitem>

         </varlistentry>