From c7612b20052d9151f60a96623b8743cbac88390d Mon Sep 17 00:00:00 2001 From: Yu Watanabe Date: Tue, 16 Jan 2018 23:25:56 +0900 Subject: [PATCH] man: mention that systemctl is-active or is-failed do not load units See the discussion in the issue #7875. --- man/systemctl.xml | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/man/systemctl.xml b/man/systemctl.xml index 60882e5aa3b..375b91a9bb0 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -877,6 +877,10 @@ Sun 2017-02-26 20:57:49 EST 2h 3min left Sun 2017-02-26 11:56:36 EST 6h ago non-zero otherwise. Unless is specified, this will also print the current unit state to standard output. + + Unlike status or show commands, this does not + load units. So, when a specified unit is an alias of another unit and is not loaded, + then this outputs "inactive", even if the aliased unit is active. @@ -889,6 +893,10 @@ Sun 2017-02-26 20:57:49 EST 2h 3min left Sun 2017-02-26 11:56:36 EST 6h ago non-zero otherwise. Unless is specified, this will also print the current unit state to standard output. + + Unlike status or show commands, this does not + load units. So, when a specified unit is an alias of another unit and is not loaded, + then this outputs "inactive", even if the aliased unit is failed. @@ -987,6 +995,9 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err are always exposed as properties ending in the …USec suffix even if a matching configuration options end in …Sec, because microseconds is the normalized time unit used by the system and service manager. + + As similar to status command, systemd implicitly loads units as necessary. + See also status command for the detail. -- 2.39.2