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+
9 <refentry id=
"sd-daemon"
10 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
13 <title>sd-daemon
</title>
14 <productname>systemd
</productname>
18 <refentrytitle>sd-daemon
</refentrytitle>
19 <manvolnum>3</manvolnum>
23 <refname>sd-daemon
</refname>
24 <refname>SD_EMERG
</refname>
25 <refname>SD_ALERT
</refname>
26 <refname>SD_CRIT
</refname>
27 <refname>SD_ERR
</refname>
28 <refname>SD_WARNING
</refname>
29 <refname>SD_NOTICE
</refname>
30 <refname>SD_INFO
</refname>
31 <refname>SD_DEBUG
</refname>
33 new-style daemons
</refpurpose>
38 <funcsynopsisinfo>#include
<systemd/sd-daemon.h
></funcsynopsisinfo>
42 <command>pkg-config --cflags --libs libsystemd
</command>
48 <title>Description
</title>
50 <para><filename>sd-daemon.h
</filename> provides APIs for new-style
51 daemons, as implemented by the
52 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
53 service manager.
</para>
56 <citerefentry><refentrytitle>sd_listen_fds
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
57 <citerefentry><refentrytitle>sd_notify
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
58 <citerefentry><refentrytitle>sd_booted
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
59 <citerefentry><refentrytitle>sd_is_fifo
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
60 <citerefentry><refentrytitle>sd_watchdog_enabled
</refentrytitle><manvolnum>3</manvolnum></citerefentry>
61 for more information about the functions implemented. In addition
62 to these functions, a couple of logging prefixes are defined as
65 <programlisting>#define SD_EMERG
"<0>" /* system is unusable */
66 #define SD_ALERT
"<1>" /* action must be taken immediately */
67 #define SD_CRIT
"<2>" /* critical conditions */
68 #define SD_ERR
"<3>" /* error conditions */
69 #define SD_WARNING
"<4>" /* warning conditions */
70 #define SD_NOTICE
"<5>" /* normal but significant condition */
71 #define SD_INFO
"<6>" /* informational */
72 #define SD_DEBUG
"<7>" /* debug-level messages */
</programlisting>
74 <para>These prefixes are intended to be used in conjunction with
75 stderr-based logging as implemented by systemd. If a systemd
76 service definition file is configured with
77 <varname>StandardError=journal
</varname>,
78 <varname>StandardError=syslog
</varname> or
79 <varname>StandardError=kmsg
</varname>, these prefixes can be used
80 to encode a log level in lines printed. This is similar to the
81 kernel
<function>printk()
</function>-style logging. See
82 <citerefentry><refentrytitle>klogctl
</refentrytitle><manvolnum>2</manvolnum></citerefentry>
83 for more information.
</para>
85 <para>The log levels are identical to
86 <citerefentry project='man-pages'
><refentrytitle>syslog
</refentrytitle><manvolnum>3</manvolnum></citerefentry>'s
87 log level system. To use these prefixes simply prefix every line
88 with one of these strings. A line that is not prefixed will be
89 logged at the default log level SD_INFO.
</para>
92 <title>Hello World
</title>
94 <para>A daemon may log with the log level NOTICE by issuing this
97 <programlisting>fprintf(stderr, SD_NOTICE
"Hello World!\n");
</programlisting>
101 <xi:include href=
"libsystemd-pkgconfig.xml" />
104 <title>See Also
</title>
106 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
107 <citerefentry><refentrytitle>sd_listen_fds
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
108 <citerefentry><refentrytitle>sd_notify
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
109 <citerefentry><refentrytitle>sd_booted
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
110 <citerefentry><refentrytitle>sd_is_fifo
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
111 <citerefentry><refentrytitle>sd_watchdog_enabled
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
112 <citerefentry><refentrytitle>daemon
</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
113 <citerefentry><refentrytitle>systemd.service
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
114 <citerefentry><refentrytitle>systemd.socket
</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
115 <citerefentry project='man-pages'
><refentrytitle>fprintf
</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
116 <citerefentry project='die-net'
><refentrytitle>pkg-config
</refentrytitle><manvolnum>1</manvolnum></citerefentry>