diff --git a/man/org.freedesktop.systemd1.xml b/man/org.freedesktop.systemd1.xml
index 97629c0470..75909aa9e5 100644
--- a/man/org.freedesktop.systemd1.xml
+++ b/man/org.freedesktop.systemd1.xml
@@ -2720,12 +2720,6 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice {
-
-
-
-
-
-
@@ -3772,6 +3766,18 @@ node /org/freedesktop/systemd1/unit/avahi_2ddaemon_2eservice {
Most properties of the Service interface map directly to the corresponding settings in service
unit files. For the sake of brevity, here's a list of all exceptions only:
+ TimeoutStartUSec, TimeoutStopUSec and
+ TimeoutAbortUSec contain the start, stop and abort timeouts, in microseconds. Note
+ the slight difference in naming when compared to the matching unit file settings (see
+ systemd.service7):
+ these bus properties strictly use microseconds (and thus are suffixed …USec) while
+ the unit file settings default to a time unit of seconds (and thus are suffixed
+ …Sec), unless a different unit is explicitly specified. This reflects that fact that
+ internally the service manager deals in microsecond units only, and the bus properties are a relatively
+ low-level (binary) concept exposing this. The unit file settings on the other hand are relatively
+ high-level (string-based) concepts and thus support more user friendly time specifications which
+ default to second time units but allow other units too, if specified.
+
WatchdogTimestamp and WatchdogTimestampMonotonic contain
CLOCK_REALTIME/CLOCK_MONOTONIC microsecond timestamps of the
last watchdog ping received from the service, or 0 if none was ever received.
@@ -9238,8 +9244,6 @@ node /org/freedesktop/systemd1/unit/session_2d1_2escope {
-
-
diff --git a/man/systemctl.xml b/man/systemctl.xml
index bb3a296645..1c55028837 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -446,7 +446,11 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
current main process identifier as MainPID (which is runtime state), and time settings
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.
+ internally by the system and service manager.
+
+ For details about many of these properties, see the documentation of the D-Bus interface
+ backing these properties, see
+ org.freedesktop.systemd15.
diff --git a/man/systemd.time.xml b/man/systemd.time.xml
index 5b7800e78b..79fe9735c4 100644
--- a/man/systemd.time.xml
+++ b/man/systemd.time.xml
@@ -75,6 +75,16 @@
One can use the timespan command of
systemd-analyze1
to normalise a textual time span for testing and validation purposes.
+
+ Internally, systemd generally operates with microsecond time granularity, while the default time
+ unit in user-configurable time spans is usually seconds (see above). This disparity becomes visible when
+ comparing the same settings in the (high-level) unit file syntax with the matching (more low-level) D-Bus
+ properties (which are what
+ systemctl1's
+ show command displays). The former typically are suffixed with …Sec
+ to indicate the default unit of seconds, the latter are typically suffixed with …USec
+ to indicate the underlying low-level time unit, even if they both encapsulate the very same
+ settings.