X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_notify.xml;h=7c1d982d855e4f37654ce653f9fd600bac7cdcfe;hp=140e795979083150192cc88a5b9b9b71826270e0;hb=20d910092d61dff9ae4e2500efd26ec68ca208b2;hpb=f9378423b9758861850748aeb49ae0d3300e56e6 diff --git a/man/sd_notify.xml b/man/sd_notify.xml index 140e79597..7c1d982d8 100644 --- a/man/sd_notify.xml +++ b/man/sd_notify.xml @@ -104,7 +104,7 @@ definition file has Type=notify set. The passed argument is a boolean "1" or "0". Since there is little - value in signalling non-readiness the + value in signalling non-readiness, the only value daemons should send is "READY=1". @@ -115,7 +115,7 @@ Passes a single-line status string back to the init system that describes the daemon state. This - is free-from and can be used for + is free-form and can be used for various purposes: general state feedback, fsck-like programs could pass completion percentages and @@ -153,7 +153,7 @@ - It is recommened to prefix variable names that + It is recommended to prefix variable names that are not shown in the list above with X_ to avoid namespace clashes. @@ -177,11 +177,11 @@ On failure, these calls return a negative errno-style error code. If $NOTIFY_SOCKET was not set and - hence no status data could be sent 0 is returned. If + hence no status data could be sent, 0 is returned. If the status was sent these functions return with a - positive return value. In order to support both init + positive return value. In order to support both, init systems that implement this scheme and those which - don't it is generally recommended to ignore the return + don't, it is generally recommended to ignore the return value of this call. @@ -227,6 +227,24 @@ become a NOP. + + Environment + + + + $NOTIFY_SOCKET + + Set by the init system + for supervised processes for status + and start-up completion + notification. This environment variable + specifies the socket + sd_notify() talks + to. See above for details. + + + + Examples @@ -234,7 +252,7 @@ Start-up Notification When a daemon finished starting up, it - might issue the following call call to notify + might issue the following call to notify the init system: sd_notify(0, "READY=1"); @@ -267,9 +285,9 @@ See Also + systemd1, sd_daemon7, daemon7, - systemd8, systemd.service5