pub fn notify(unset_env: bool, state: &[NotifyState<'_>]) -> Result<()>
Expand description
Sends the service manager a list of state changes.
If the unset_env
parameter is set, the NOTIFY_SOCKET
environment variable
will be unset before returning. Further calls to sd_notify
will fail, but
child processes will no longer inherit the variable.
The notification mechanism involves sending a datagram to a Unix domain socket.
See sd_notify(3)
for details.
Limitations
The implementation of this function is somewhat naive: it doesn’t support sending notifications on behalf of other processes, doesn’t pass file descriptors, doesn’t send credentials, and does not increase the send buffer size. It’s still useful, though, in usual situations.
Example
let _ = sd_notify::notify(true, &[NotifyState::Ready]);