OS Manuals

/usr/bin/systemd-notify

The systemd System and Service Manager

From systemd 262.2-r1 (os), captured 2026-11-05 by running systemd-notify --help (exit 0). permalink

> systemd-notify [OPTION…] [VARIABLE=VALUE…]
> systemd-notify [OPTION…] --exec [VARIABLE=VALUE…] ; -- CMDLINE…
> systemd-notify [OPTION…] --fork -- CMDLINE…

Notify the service manager about service status updates.

Options:
  -h --help        Show this help
     --version     Show package version
     --ready       Inform the service manager about service start-up/reload completion
     --reloading   Inform the service manager about configuration reloading
     --stopping    Inform the service manager about service shutdown
     --pid[=PID]   Set main PID of daemon
     --uid=USER    Set user to send from
     --status=TEXT Set status text
     --booted      Check if the system was booted up with systemd
     --no-block    Do not wait until operation finished
     --exec        Execute command line separated by ';' once done
     --fd=FD       Pass specified file descriptor along with the message
     --fdname=NAME Name to assign to passed file descriptors
     --fork        Receive notifications from child rather than sending them
  -q --quiet       Do not show PID of child when forking

See the systemd-notify(1) man page for details.
Options (13)
OptionDescriptionSource
-h --helpShow this helphelp
--versionShow package versionhelp
--readyInform the service manager about service start-up/reload completionhelp
--reloadingInform the service manager about configuration reloadinghelp
--stoppingInform the service manager about service shutdownhelp
--pid PIDSet main PID of daemonhelp
--uid USERSet user to send fromhelp
--bootedCheck if the system was booted up with systemdhelp
--no-blockDo not wait until operation finishedhelp
--execExecute command line separated by ';' once donehelp
--fd FDPass specified file descriptor along with the messagehelp
--forkReceive notifications from child rather than sending themhelp
-q --quietDo not show PID of child when forkinghelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.