X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd-daemon.xml;h=ed85debd77224f3d4a4f397011c82459f791fb7a;hp=cbfe28f84256affab8357010b82641afa4c42f89;hb=89f7c8465cd1ab37347dd0c15920bce31e8225df;hpb=e62e6670f77a886d26fbfe612e6f4fa0c2e0c98b diff --git a/man/sd-daemon.xml b/man/sd-daemon.xml index cbfe28f84..ed85debd7 100644 --- a/man/sd-daemon.xml +++ b/man/sd-daemon.xml @@ -8,16 +8,16 @@ Copyright 2010 Lennart Poettering systemd is free software; you can redistribute it and/or modify it - under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or + under the terms of the GNU Lesser General Public License as published by + the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. systemd is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. + Lesser General Public License for more details. - You should have received a copy of the GNU General Public License + You should have received a copy of the GNU Lesser General Public License along with systemd; If not, see . --> @@ -39,19 +39,32 @@ sd-daemon - 7 + 3 sd-daemon + SD_EMERG + SD_ALERT + SD_CRIT + SD_ERR + SD_WARNING + SD_NOTICE + SD_INFO + SD_DEBUG Reference implementation of APIs for new-style daemons - #include "sd-daemon.h" + #include <systemd/sd-daemon.h> + + + pkg-config --cflags --libs libsystemd-daemon + + @@ -70,7 +83,7 @@ sd_booted3, sd_is_fifo3 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 */ @@ -86,7 +99,7 @@ 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 @@ -122,24 +135,26 @@ implementation. See the respective function man pages for details. - In addition, for details about the algorithms + In addition, for details about the algorithms, check the liberally licensed reference implementation sources: - - resp. + + and These APIs are implemented in the reference - implementation's drop-in - sd-daemon.c and - sd-daemon.h files. It is - recommended that applications consuming these APIs copy - the implementation into their source tree, either - verbatim or in excerpts. These interfaces are - currently not available in a dynamic library. + implementation's sd-daemon.c and + sd-daemon.h files. These + interfaces are available as a 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. In addition, if + 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. @@ -152,11 +167,13 @@ sd_notify3, sd_booted3, sd_is_fifo3, + sd_watchdog_enabled3, daemon7, systemd.service5, systemd.socket5, fprintf3, - sd-readahead7 + sd-readahead3, + pkg-config1