diff --git a/man/org.freedesktop.LogControl1.xml b/man/org.freedesktop.LogControl1.xml
new file mode 100644
index 0000000000..125a008347
--- /dev/null
+++ b/man/org.freedesktop.LogControl1.xml
@@ -0,0 +1,106 @@
+
+
+
+
+
+
+ org.freedesktop.LogControl1
+ systemd
+
+
+
+ org.freedesktop.LogControl1
+ 5
+
+
+
+ org.freedesktop.LogControl1
+ D-Bus interface to query and set logging configuration
+
+
+
+ Introduction
+
+ org.freedesktop.LogControl1 is a generic interface that is intended
+ to be used by any daemon which should allow setting the log level and target over D-Bus. It is implemented
+ by various daemons that are part of the
+ systemd1 suite.
+
+ It is assumed that those settings are global for the whole program, so a fixed object path is
+ used. The interface should always be available under the path
+ /org/freedesktop/LogControl1.
+
+
+
+ Description
+
+ The following interface is exposed:
+
+
+node /org/freedesktop/LogControl1 {
+ interface org.freedesktop.LogControl1 {
+ properties:
+ @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+ @org.freedesktop.systemd1.Privileged("true")
+ readwrite s LogLevel = '...';
+ @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+ @org.freedesktop.systemd1.Privileged("true")
+ readwrite s LogTarget = '...';
+ @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+ readonly s SyslogIdentifier = '...';
+ };
+ interface org.freedesktop.DBus.Peer { ... };
+ interface org.freedesktop.DBus.Introspectable { ... };
+ interface org.freedesktop.DBus.Properties { ... };
+};
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Properties
+
+ LogLevel describes the
+ syslog3-style
+ log-level, and should be one of emerg, alert,
+ crit, err, warning, notice,
+ info, debug, in order of increasing verbosity.
+
+ LogTarget describes the log target (mechanism). It should be one of
+ console (log to the console or standard output),
+ kmsg (log to the kernel ring buffer),
+ journal (log the the journal natively, see
+ systemd-journald.service8),
+ syslog (log using the
+ syslog3 call).
+
+
+ Those two properties are writable, so they may be set by sufficiently privileged users.
+
+ SyslogIdentifier is a read-only property that shows the "syslog identifier".
+ It is a short string that identifies the program that is the source of log messages that is passed to
+ the syslog3 call.
+
+
+ Note: journalctl option / may
+ be used to filter log messages by log level, option /
+ may be used to by the syslog identifier, and filters like _TRANSPORT=syslog,
+ _TRANSPORT=journal, and _TRANSPORT=kernel may be used to filter
+ messages by the mechanism through which they reached systemd-journald.
+
+
+
diff --git a/man/rules/meson.build b/man/rules/meson.build
index 2096222c50..cda68ef99b 100644
--- a/man/rules/meson.build
+++ b/man/rules/meson.build
@@ -44,6 +44,7 @@ manpages = [
['nss-mymachines', '8', ['libnss_mymachines.so.2'], 'ENABLE_NSS_MYMACHINES'],
['nss-resolve', '8', ['libnss_resolve.so.2'], 'ENABLE_NSS_RESOLVE'],
['nss-systemd', '8', ['libnss_systemd.so.2'], 'ENABLE_NSS_SYSTEMD'],
+ ['org.freedesktop.LogControl1', '5', [], ''],
['org.freedesktop.hostname1', '5', [], 'ENABLE_HOSTNAMED'],
['org.freedesktop.import1', '5', [], 'ENABLE_IMPORTD'],
['org.freedesktop.locale1', '5', [], 'ENABLE_LOCALED'],
diff --git a/man/systemd-hostnamed.service.xml b/man/systemd-hostnamed.service.xml
index 699316a09a..1aa32a61ce 100644
--- a/man/systemd-hostnamed.service.xml
+++ b/man/systemd-hostnamed.service.xml
@@ -56,7 +56,9 @@
is a command line client to this service.
See
- org.freedesktop.hostname11
+ org.freedesktop.hostname15
+ and
+ org.freedesktop.LogControl15
for a description of the D-Bus API.
diff --git a/man/systemd-importd.service.xml b/man/systemd-importd.service.xml
index 355e5b0b98..fa3c3a812f 100644
--- a/man/systemd-importd.service.xml
+++ b/man/systemd-importd.service.xml
@@ -36,10 +36,11 @@
pull-raw, pull-tar, import-raw,
import-tar, export-raw, and export-tar commands.
- See the
-
- importd D-Bus API Documentation for information about the
- APIs systemd-importd provides.
+ See
+ org.freedesktop.import15
+ and
+ org.freedesktop.LogControl15
+ for a description of the D-Bus API.
diff --git a/man/systemd-localed.service.xml b/man/systemd-localed.service.xml
index e5f6b78d21..49eeeffee6 100644
--- a/man/systemd-localed.service.xml
+++ b/man/systemd-localed.service.xml
@@ -41,7 +41,9 @@
is a command line client to this service.
See
- org.freedesktop.locale11
+ org.freedesktop.locale15
+ and
+ org.freedesktop.LogControl15
for a description of the D-Bus API.
diff --git a/man/systemd-logind.service.xml b/man/systemd-logind.service.xml
index 12f9f7a0f6..c602b2e42f 100644
--- a/man/systemd-logind.service.xml
+++ b/man/systemd-logind.service.xml
@@ -79,7 +79,9 @@
such as users, sessions and seats.
See
- org.freedesktop.login13
+ org.freedesktop.login15
+ and
+ org.freedesktop.LogControl15
for information about the D-Bus APIs systemd-logind provides.For more information on the inhibition logic see the sd-login3
and
- org.freedesktop.machine13.
+ org.freedesktop.machine15.
+ and
+ org.freedesktop.LogControl15A small companion daemon
diff --git a/man/systemd-resolved.service.xml b/man/systemd-resolved.service.xml
index 2f4efab1ff..6e1ee9f4a5 100644
--- a/man/systemd-resolved.service.xml
+++ b/man/systemd-resolved.service.xml
@@ -38,6 +38,8 @@
The native, fully-featured API systemd-resolved exposes on the bus,
see
org.freedesktop.resolve15
+ and
+ org.freedesktop.LogControl15
for details. Usage of this API is generally recommended to clients as it is asynchronous and fully
featured (for example, properly returns DNSSEC validation status and interface scope for addresses as
necessary for supporting link-local networking).
diff --git a/man/systemd-timedated.service.xml b/man/systemd-timedated.service.xml
index b722b33115..93cfdf5118 100644
--- a/man/systemd-timedated.service.xml
+++ b/man/systemd-timedated.service.xml
@@ -55,6 +55,8 @@
See
org.freedesktop.timedate15
+ and
+ org.freedesktop.LogControl15
for information about the D-Bus API.
diff --git a/man/systemd.xml b/man/systemd.xml
index 4e08ff6254..11954a78da 100644
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -281,7 +281,10 @@
systemd.generator7.The D-Bus API of systemd is described in
- org.freedesktop.systemd15.
+ org.freedesktop.systemd15
+ and
+ org.freedesktop.LogControl15.
+
Systems which invoke systemd in a container or initrd environment should implement the Container Interface or