1 <?xml version='
1.0'
?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
6 SPDX-License-Identifier: LGPL-2.1+
8 This file is part of systemd.
10 Copyright 2010 Lennart Poettering
13 <refentry id=
"sd-daemon"
14 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
17 <title>sd-daemon
</title>
18 <productname>systemd
</productname>
22 <contrib>Developer
</contrib>
23 <firstname>Lennart
</firstname>
24 <surname>Poettering
</surname>
25 <email>lennart@poettering.net
</email>
31 <refentrytitle>sd-daemon
</refentrytitle>
32 <manvolnum>3</manvolnum>
36 <refname>sd-daemon
</refname>
37 <refname>SD_EMERG
</refname>
38 <refname>SD_ALERT
</refname>
39 <refname>SD_CRIT
</refname>
40 <refname>SD_ERR
</refname>
41 <refname>SD_WARNING
</refname>
42 <refname>SD_NOTICE
</refname>
43 <refname>SD_INFO
</refname>
44 <refname>SD_DEBUG
</refname>
46 new-style daemons
</refpurpose>
51 <funcsynopsisinfo>#include
<systemd/sd-daemon.h
></funcsynopsisinfo>
55 <command>pkg-config --cflags --libs libsystemd
</command>
61 <title>Description
</title>
63 <para><filename>sd-daemon.h
</filename> provides APIs for new-style
64 daemons, as implemented by the
65 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
66 service manager.
</para>
69 <citerefentry><refentrytitle>sd_listen_fds
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
70 <citerefentry><refentrytitle>sd_notify
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
71 <citerefentry><refentrytitle>sd_booted
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
72 <citerefentry><refentrytitle>sd_is_fifo
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
73 <citerefentry><refentrytitle>sd_watchdog_enabled
</refentrytitle><manvolnum>3</manvolnum></citerefentry>
74 for more information about the functions implemented. In addition
75 to these functions, a couple of logging prefixes are defined as
78 <programlisting>#define SD_EMERG
"<0>" /* system is unusable */
79 #define SD_ALERT
"<1>" /* action must be taken immediately */
80 #define SD_CRIT
"<2>" /* critical conditions */
81 #define SD_ERR
"<3>" /* error conditions */
82 #define SD_WARNING
"<4>" /* warning conditions */
83 #define SD_NOTICE
"<5>" /* normal but significant condition */
84 #define SD_INFO
"<6>" /* informational */
85 #define SD_DEBUG
"<7>" /* debug-level messages */
</programlisting>
87 <para>These prefixes are intended to be used in conjunction with
88 stderr-based logging as implemented by systemd. If a systemd
89 service definition file is configured with
90 <varname>StandardError=journal
</varname>,
91 <varname>StandardError=syslog
</varname> or
92 <varname>StandardError=kmsg
</varname>, these prefixes can be used
93 to encode a log level in lines printed. This is similar to the
94 kernel
<function>printk()
</function>-style logging. See
95 <citerefentry><refentrytitle>klogctl
</refentrytitle><manvolnum>2</manvolnum></citerefentry>
96 for more information.
</para>
98 <para>The log levels are identical to
99 <citerefentry project='man-pages'
><refentrytitle>syslog
</refentrytitle><manvolnum>3</manvolnum></citerefentry>'s
100 log level system. To use these prefixes simply prefix every line
101 with one of these strings. A line that is not prefixed will be
102 logged at the default log level SD_INFO.
</para>
105 <title>Hello World
</title>
107 <para>A daemon may log with the log level NOTICE by issuing this
110 <programlisting>fprintf(stderr, SD_NOTICE
"Hello World!\n");
</programlisting>
114 <xi:include href=
"libsystemd-pkgconfig.xml" />
117 <title>See Also
</title>
119 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
120 <citerefentry><refentrytitle>sd_listen_fds
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
121 <citerefentry><refentrytitle>sd_notify
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
122 <citerefentry><refentrytitle>sd_booted
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
123 <citerefentry><refentrytitle>sd_is_fifo
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
124 <citerefentry><refentrytitle>sd_watchdog_enabled
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
125 <citerefentry><refentrytitle>daemon
</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
126 <citerefentry><refentrytitle>systemd.service
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
127 <citerefentry><refentrytitle>systemd.socket
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
128 <citerefentry project='man-pages'
><refentrytitle>fprintf
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
129 <citerefentry project='die-net'
><refentrytitle>pkg-config
</refentrytitle><manvolnum>1</manvolnum></citerefentry>