From 77df77b863b35aa00a5b8e3d63e4dfb094b0aef9 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 8 Apr 2024 20:51:16 +0200 Subject: Adding upstream version 252.23. Signed-off-by: Daniel Baumann --- man/org.freedesktop.systemd1.xml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) (limited to 'man/org.freedesktop.systemd1.xml') diff --git a/man/org.freedesktop.systemd1.xml b/man/org.freedesktop.systemd1.xml index 0332632..1e12e8f 100644 --- a/man/org.freedesktop.systemd1.xml +++ b/man/org.freedesktop.systemd1.xml @@ -1228,7 +1228,13 @@ node /org/freedesktop/systemd1 { and terminate all units that aren't dependencies of it. If ignore-dependencies, it will start a unit but ignore all its dependencies. If ignore-requirements, it will start a unit but only ignore the requirement dependencies. It is not recommended to make use of the - latter two options. On completion, this method returns the newly created job object. + latter two options. On reply, if successful, this method returns the newly created job object + which has been enqueued for asynchronous activation. Callers that want to track the outcome of the + actual start operation need to monitor the result of this job. This can be achieved in a race-free + manner by first subscribing to the JobRemoved() signal, then calling + StartUnit() and using the returned job object to filter out unrelated + JobRemoved() signals, until the desired one is received, which will then carry + the result of the start operation. StartUnitReplace() is similar to StartUnit() but replaces a job that is queued for one unit by a job for another unit. -- cgit v1.2.3