X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_notify.xml;h=020914607cab38df794e7807e50b5eaa0133464f;hp=80856a22d534ba984b41737fec9238732cf1369d;hb=54fe0cdbe313558a712a15dc3bc516a46c1f7b6e;hpb=af62c704053b5d34672497eb5bdc4764ebbb5f4f diff --git a/man/sd_notify.xml b/man/sd_notify.xml index 80856a22d..020914607 100644 --- a/man/sd_notify.xml +++ b/man/sd_notify.xml @@ -50,7 +50,7 @@ - #include "sd-daemon.h" + #include <systemd/sd-daemon.h> int sd_notify @@ -87,7 +87,7 @@ processes. The state parameter - should contain an newline-seperated list of variable + should contain an newline-separated list of variable assignments, similar in style to an environment block. A trailing newline is implied if none is specified. The string may contain any kind of variable @@ -166,7 +166,7 @@ for details. sd_notifyf() is similar to - sd_notifyf() but takes a + sd_notify() but takes a printf()-like format string plus arguments. @@ -206,25 +206,30 @@ datagram is accompanied by the process credentials of the sending daemon, using SCM_CREDENTIALS. - For details about the algorithm check the + For details about the algorithms check the liberally licensed reference implementation sources: - + resp. + url="http://cgit.freedesktop.org/systemd/plain/src/systemd/sd-daemon.h"/> sd_notify() and sd_notifyf() are implemented in - the reference implementation's drop-in + the reference implementation's sd-daemon.c and - sd-daemon.h files. It is - recommended that applications consuming these APIs - copy the implementation into their source tree. For + sd-daemon.h files. These + interfaces are available as shared library, which can + be compiled and linked to with the + libsystemd-daemon + pkg-config1 + file. Alternatively, applications consuming these APIs + may copy the implementation into their source tree. For more details about the reference implementation see - sd_daemon7 + sd_daemon7. - If -DDISABLE_SYSTEMD is set during compilation - this function will always return 0 and otherwise - become a NOP. + If the reference implementation is used as + drop-in files and -DDISABLE_SYSTEMD is set during + compilation these functions will always return 0 and + otherwise become a NOP. @@ -252,7 +257,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");