Debian Codegraph @

upstream/debian-unstable/man3/libsystemd.3

raw
1 '\" t
2 .TH "LIBSYSTEMD" "3" "" "systemd 261~rc3" "libsystemd"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 libsystemd \- Functions for implementing services and interacting with systemd
24 .SH "SYNOPSIS"
25 .sp
26 .nf
27 #include <systemd/sd\-bus\&.h>
28 #include <systemd/sd\-daemon\&.h>
29 #include <systemd/sd\-device\&.h>
30 #include <systemd/sd\-event\&.h>
31 #include <systemd/sd\-gpt\&.h>
32 #include <systemd/sd\-hwdb\&.h>
33 #include <systemd/sd\-id128\&.h>
34 #include <systemd/sd\-journal\&.h>
35 #include <systemd/sd\-json\&.h>
36 #include <systemd/sd\-login\&.h>
37 #include <systemd/sd\-messages\&.h>
38 #include <systemd/sd\-path\&.h>
39 #include <systemd/sd\-varlink\&.h>
40 .fi
41 .HP \w'\fBpkg\-config\ \-\-cflags\ \-\-libs\ libsystemd\fR\ 'u
42 \fBpkg\-config \-\-cflags \-\-libs libsystemd\fR
43 .SH "DESCRIPTION"
44 .PP
45 The
46 libsystemd
47 library provides functions that allow interacting with various interfaces provided by the
48 \fBsystemd\fR(1)
49 service manager, as well as various other functions and constants useful for implementing services in general\&.
50 .PP
51 See
52 \fBsd-bus\fR(3),
53 \fBsd-bus-errors\fR(3),
54 \fBsd-daemon\fR(3),
55 \fBsd-device\fR(3),
56 \fBsd-event\fR(3),
57 \fBsd-hwdb\fR(3),
58 \fBsd-id128\fR(3),
59 \fBsd-journal\fR(3),
60 \fBsd-json\fR(3),
61 \fBsd-login\fR(3),
62 \fBsd-path\fR(3), and
63 \fBsd-varlink\fR(3)
64 for information about different parts of the library interface\&.
65 .SH "INTERFACE STABILITY"
66 .PP
67 Strict backwards\-compatibility is maintained for the API (application programming interface) and ABI (application binary interface)\&. Symbol versioning is used, with symbols only added and never removed\&.
68 .SH "NOTES"
69 .PP
70 Functions described here are available as a shared library, which can be compiled against and linked to with the
71 \fBlibsystemd\fR\ \&\fBpkg-config\fR(1)
72 file\&.
73 .PP
74 The code described here uses
75 \fBgetenv\fR(3), which is declared to be not multi\-thread\-safe\&. This means that the code calling the functions described here must not call
76 \fBsetenv\fR(3)
77 from a parallel thread\&. It is recommended to only do calls to
78 \fBsetenv()\fR
79 from an early phase of the program when no other threads have been started\&.
80 .SH "SEE ALSO"
81 .PP
82 \fBsystemd\fR(1), \fBlibudev\fR(3), \fBpkg-config\fR(1), \m[blue]\fBInterface Portability and Stability Promise\fR\m[]\&\s-2\u[1]\d\s+2
83 .SH "NOTES"
84 .IP " 1." 4
85 Interface Portability and Stability Promise
86 .RS 4
87 \%https://systemd.io/PORTABILITY_AND_STABILITY/
88 .RE