From 87698625aaf08ab2411a54a4ac9878acd4b46772 Mon Sep 17 00:00:00 2001 From: Harald Hoyer Date: Wed, 10 Apr 2013 12:32:27 +0200 Subject: [PATCH] systemctl: clarify usage of "--all" versus list-unit-files 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 | 4 +++- src/systemctl/systemctl.c | 4 +++- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/man/systemctl.xml b/man/systemctl.xml index a2c3501ec..c0f5bb974 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -133,10 +133,12 @@ along with systemd; If not, see . - When listing units, show all units, regardless of + 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. + To list all units installed on disk, use the command + list-unit-files instead. diff --git a/src/systemctl/systemctl.c b/src/systemctl/systemctl.c index 2f43052f9..b738a6d1d 100644 --- a/src/systemctl/systemctl.c +++ b/src/systemctl/systemctl.c @@ -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" -- 2.30.2