diff --git a/man/org.freedesktop.LogControl1.xml b/man/org.freedesktop.LogControl1.xml index 5738a3dda6..135e8bc8de 100644 --- a/man/org.freedesktop.LogControl1.xml +++ b/man/org.freedesktop.LogControl1.xml @@ -89,7 +89,9 @@ node /org/freedesktop/LogControl1 { syslog3 call). - Those two properties are writable, so they may be set by sufficiently privileged users. + Write AccessThe LogLevel and + LogTarget properties are supposed to be writable. Care should be taken to ensure + that only appropriately privileged clients can modify them. 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 @@ -127,6 +129,11 @@ node /org/freedesktop/LogControl1 { This creates a simple server on the bus. It implements the LogControl1 interface by providing the required properties and allowing to set the writable ones. It logs at the configured log level using sd_journal_print3. + + Note that when porting this example to other D-Bus libraries it might be necessary to add manual + client privilege checks, as they typically do not default to the restrictive defaults of sd-bus, where + unprivileged access to properties is controlled via the SD_BUS_VTABLE_UNPRIVILEGED + flag that is opt-in rather than opt-out.