chiark / gitweb /
systemctl: clarify usage of "--all" versus list-unit-files
authorHarald Hoyer <harald@redhat.com>
Wed, 10 Apr 2013 10:32:27 +0000 (12:32 +0200)
committerHarald Hoyer <harald@redhat.com>
Wed, 17 Apr 2013 07:23:09 +0000 (09:23 +0200)
Novice users might think, that
 $ systemctl --all
is equal to
 $ systemctl list-unit-files

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

man/systemctl.xml
src/systemctl/systemctl.c

index a2c3501..c0f5bb9 100644 (file)
@@ -133,10 +133,12 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
         <term><option>--all</option></term>
 
         <listitem>
-          <para>When listing units, show all units, regardless of
+          <para>When listing units, show all internally loaded units, regardless of
           their state, including inactive units. When showing
           unit/job/manager properties, show all properties regardless
           whether they are set or not.</para>
+          <para>To list all units installed on disk, use the command
+          <command>list-unit-files</command> instead.</para>
         </listitem>
       </varlistentry>
 
index 2f43052..b738a6d 100644 (file)
@@ -4488,7 +4488,9 @@ static int systemctl_help(void) {
                "     --version        Show package version\n"
                "  -t --type=TYPE      List only units of a particular type\n"
                "  -p --property=NAME  Show only properties by this name\n"
-               "  -a --all            Show all units/properties, including dead/empty ones\n"
+               "  -a --all            Show all internally loaded units/properties,\n"
+               "                      including dead/empty ones. To list all units installed\n"
+               "                      on disk, use the command 'list-unit-files' instead.\n"
                "     --failed         Show only failed units\n"
                "     --full           Don't ellipsize unit names on output\n"
                "     --fail           When queueing a new job, fail if conflicting jobs are\n"