X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd-daemon.xml;h=9eef395deb59154f18ea310ae883fb4e4a4f2cca;hp=a3bf662fe9bc4b241a0f82ab73fd2506cbdefdb1;hb=26e3ff59a6a197e442255d8adfa2df239405c7e5;hpb=f274ece0f76b5709408821e317e87aef76123db6 diff --git a/man/sd-daemon.xml b/man/sd-daemon.xml index a3bf662fe..9eef395de 100644 --- a/man/sd-daemon.xml +++ b/man/sd-daemon.xml @@ -52,7 +52,7 @@ SD_NOTICE SD_INFO SD_DEBUG - Reference implementation of APIs for + APIs for new-style daemons @@ -62,7 +62,7 @@ - pkg-config --cflags --libs libsystemd-daemon + pkg-config --cflags --libs libsystemd @@ -70,10 +70,8 @@ Description - sd-daemon.c and - sd-daemon.h provide a reference - implementation of various APIs for new-style daemons, - as implemented by the + sd-daemon.h provide APIs + for new-style daemons, as implemented by the systemd1 init system. @@ -81,9 +79,10 @@ sd_listen_fds3, sd_notify3, sd_booted3, - sd_is_fifo3 + sd_is_fifo3, + sd_watchdog_enabled3 for more information about the functions - implemented. In addition to these functions a couple + implemented. In addition to these functions, a couple of logging prefixes are defined as macros: #define SD_EMERG "<0>" /* system is unusable */ @@ -96,10 +95,10 @@ #define SD_DEBUG "<7>" /* debug-level messages */ These prefixes are intended to be used in - conjunction with STDERR-based logging as implemented + conjunction with stderr-based logging as implemented by systemd. If a systemd service definition file is configured with StandardError=syslog - or StandardError=kmsg these + or StandardError=kmsg, these prefixes can be used to encode a log level in lines printed. This is similar to the kernel printk()-style logging. See @@ -126,38 +125,10 @@ Notes - These interfaces are provided by the reference - implementation of APIs for new-style daemons and - distributed with the systemd package. The algorithms - they implement are simple, and can easily be - reimplemented in daemons if it is important to support - this interface without using the reference - implementation. See the respective function man pages - for details. - - In addition, for details about the algorithms - check the liberally licensed reference implementation - sources: - - and - - These APIs are implemented in the reference - implementation's sd-daemon.c and - 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, - either verbatim or in excerpts. - - The functions directly related to new-style - daemons become NOPs when -DDISABLE_SYSTEMD is set - during compilation and the reference implementation is - used as drop-in files. In addition, if - sd-daemon.c is compiled on - non-Linux systems they become NOPs. + These APIs are implemented as a shared library, + which can be compiled and linked to with the + libsystemd pkg-config1 + file. @@ -168,6 +139,7 @@ sd_notify3, sd_booted3, sd_is_fifo3, + sd_watchdog_enabled3, daemon7, systemd.service5, systemd.socket5,