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