This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg.
View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=351900813acc447eaa212602b387ffb724821ed8 commit 351900813acc447eaa212602b387ffb724821ed8 Author: Guillem Jover <[email protected]> AuthorDate: Sun Jan 11 02:40:12 2026 +0100 s-s-d(8): Clarify relationship between --notify-await and --background Switch from a warning to a note admonition for --background, given that --notify-await makes it a reliable operation to perform. And document that the latter requires the former. Ref: #1124643 --- man/start-stop-daemon.pod | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/man/start-stop-daemon.pod b/man/start-stop-daemon.pod index 9bd609738..d730423cb 100644 --- a/man/start-stop-daemon.pod +++ b/man/start-stop-daemon.pod @@ -319,18 +319,20 @@ will force B<start-stop-daemon> to fork before starting the process, and force it into the background. -B<Warning>: B<start-stop-daemon> -cannot check the exit status if the process fails to execute for -B<any> -reason. -This is a last resort, and is only meant for programs that either -make no sense forking on their own, or where it's not feasible to add the +B<Note>: The exit status from a late unexpected failure during the +process initialization cannot be checked, +unless the B<--notify-await> option is used. +It is intended for use with programs that either make no sense daemonizing +on their own, +or where it is not feasible or desired to add the daemonizing and notification code for them to do this themselves. =item B<--notify-await> Wait for the background process to send a readiness notification before considering the service started (since version 1.19.3). +This option can only be used with B<--background>. + This implements parts of the systemd readiness protocol, as specified in the L<sd_notify(3)> manual page. The following variables are supported: -- Dpkg.Org's dpkg
