65878a
From ce006689117c3226ddb0eb5a1f8e5963cab1c92a Mon Sep 17 00:00:00 2001
65878a
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
65878a
Date: Sun, 8 Dec 2013 18:56:16 -0500
65878a
Subject: [PATCH] man: document 'is-enabled' output
65878a
65878a
https://bugzilla.redhat.com/show_bug.cgi?id=953077
65878a
---
65878a
 man/systemctl.xml | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++-----
65878a
 1 file changed, 59 insertions(+), 5 deletions(-)
65878a
65878a
diff --git a/man/systemctl.xml b/man/systemctl.xml
65878a
index 166282c..b4bc15d 100644
65878a
--- a/man/systemctl.xml
65878a
+++ b/man/systemctl.xml
65878a
@@ -437,7 +437,7 @@ systemctl start foo
65878a
 
65878a
         <listitem>
65878a
           <para>When used with <command>enable</command>,
65878a
-          <command>disable</command>, <command>is-enabled</command>
65878a
+          <command>disable</command>,
65878a
           (and related commands), make changes only temporarily, so
65878a
           that they are lost on the next reboot. This will have the
65878a
           effect that changes are not made in subdirectories of
65878a
@@ -885,10 +885,64 @@ kobject-uevent 1 systemd-udevd-kernel.socket systemd-udevd.service
65878a
 
65878a
           <listitem>
65878a
             <para>Checks whether any of the specified unit files are
65878a
-            enabled (as with <command>enable</command>). Returns an exit
65878a
-            code of 0 if at least one is enabled, non-zero
65878a
-            otherwise. Prints the current enable status. To suppress
65878a
-            this output, use <option>--quiet</option>.</para>
65878a
+            enabled (as with <command>enable</command>). Returns an
65878a
+            exit code of 0 if at least one is enabled, non-zero
65878a
+            otherwise. Prints the current enable status (see table).
65878a
+            To suppress this output, use <option>--quiet</option>.
65878a
+            </para>
65878a
+
65878a
+            
65878a
+              <title>
65878a
+                <command>is-enabled</command> output
65878a
+              </title>
65878a
+
65878a
+              <tgroup cols='3'>
65878a
+                
65878a
+                  <row>
65878a
+                    <entry>Printed string</entry>
65878a
+                    <entry>Meaning</entry>
65878a
+                    <entry>Return value</entry>
65878a
+                  </row>
65878a
+                
65878a
+                
65878a
+                  <row>
65878a
+                    <entry><literal>enabled</literal></entry>
65878a
+                    <entry morerows='1'>Enabled through a symlink in <filename>.wants</filename> directory (permanently or just in <filename>/run</filename>)</entry>
65878a
+                    <entry morerows='1'>0</entry>
65878a
+                  </row>
65878a
+                  <row>
65878a
+                    <entry><literal>enabled-runtime</literal></entry>
65878a
+                  </row>
65878a
+                  <row>
65878a
+                    <entry><literal>linked</literal></entry>
65878a
+                    <entry morerows='1'>Made available through a symlink to the unit file (permanently or just in <filename>/run</filename>)</entry>
65878a
+                    <entry morerows='1'>1</entry>
65878a
+                  </row>
65878a
+                  <row>
65878a
+                    <entry><literal>linked-runtime</literal></entry>
65878a
+                  </row>
65878a
+                  <row>
65878a
+                    <entry><literal>masked</literal></entry>
65878a
+                    <entry morerows='1'>Disabled entirely (permanently or just in <filename>/run</filename>)</entry>
65878a
+                    <entry morerows='1'>1</entry>
65878a
+                  </row>
65878a
+                  <row>
65878a
+                    <entry><literal>masked-runtime</literal></entry>
65878a
+                  </row>
65878a
+                  <row>
65878a
+                    <entry><literal>static</literal></entry>
65878a
+                    <entry>Unit is not enabled, but has no provisions for enabling in [Install] section</entry>
65878a
+                    <entry>1</entry>
65878a
+                  </row>
65878a
+                  <row>
65878a
+                    <entry><literal>disabled</literal></entry>
65878a
+                    <entry>Unit is not enabled</entry>
65878a
+                    <entry>1</entry>
65878a
+                  </row>
65878a
+                
65878a
+              </tgroup>
65878a
+            
65878a
+
65878a
           </listitem>
65878a
         </varlistentry>
65878a