summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-40/man3/libsystemd.3
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-40/man3/libsystemd.3')
-rw-r--r--upstream/fedora-40/man3/libsystemd.389
1 files changed, 89 insertions, 0 deletions
diff --git a/upstream/fedora-40/man3/libsystemd.3 b/upstream/fedora-40/man3/libsystemd.3
new file mode 100644
index 00000000..73f6ab4e
--- /dev/null
+++ b/upstream/fedora-40/man3/libsystemd.3
@@ -0,0 +1,89 @@
+'\" t
+.TH "LIBSYSTEMD" "3" "" "systemd 255" "libsystemd"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+libsystemd \- Functions for implementing services and interacting with systemd
+.SH "SYNOPSIS"
+.sp
+.nf
+#include <systemd/sd\-bus\&.h>
+#include <systemd/sd\-bus\-vtable\&.h>
+#include <systemd/sd\-bus\-protocol\&.h>
+#include <systemd/sd\-daemon\&.h>
+#include <systemd/sd\-device\&.h>
+#include <systemd/sd\-event\&.h>
+#include <systemd/sd\-gpt\&.h>
+#include <systemd/sd\-hwdb\&.h>
+#include <systemd/sd\-id128\&.h>
+#include <systemd/sd\-journal\&.h>
+#include <systemd/sd\-login\&.h>
+#include <systemd/sd\-messages\&.h>
+#include <systemd/sd\-path\&.h>
+
+.fi
+.HP \w'\fBpkg\-config\ \-\-cflags\ \-\-libs\ libsystemd\fR\ 'u
+\fBpkg\-config \-\-cflags \-\-libs libsystemd\fR
+.SH "DESCRIPTION"
+.PP
+The
+libsystemd
+library provides functions that allow interacting with various interfaces provided by the
+\fBsystemd\fR(1)
+service manager, as well as various other functions and constants useful for implementing services in general\&.
+.PP
+See
+\fBsd-bus\fR(3),
+\fBsd-bus-errors\fR(3),
+\fBsd-daemon\fR(3),
+\fBsd-device\fR(3),
+\fBsd-event\fR(3),
+\fBsd-hwdb\fR(3),
+\fBsd-id128\fR(3),
+\fBsd-journal\fR(3), and
+\fBsd-login\fR(3)
+for information about different parts of the library interface\&.
+.SH "INTERFACE STABILITY"
+.PP
+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\&.
+.SH "NOTES"
+.PP
+Functions described here are available as a shared library, which can be compiled against and linked to with the
+\fBlibsystemd\fR\ \&\fBpkg-config\fR(1)
+file\&.
+.PP
+The code described here uses
+\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
+\fBsetenv\fR(3)
+from a parallel thread\&. It is recommended to only do calls to
+\fBsetenv()\fR
+from an early phase of the program when no other threads have been started\&.
+.SH "SEE ALSO"
+.PP
+\fBsystemd\fR(1),
+\fBlibudev\fR(1),
+\fBpkg-config\fR(1),
+\m[blue]\fBInterface Portability and Stability Promise\fR\m[]\&\s-2\u[1]\d\s+2
+.SH "NOTES"
+.IP " 1." 4
+Interface Portability and Stability Promise
+.RS 4
+\%https://systemd.io/PORTABILITY_AND_STABILITY/
+.RE