<div dir="ltr">Could someone update this doc:<div><br></div><div><a href="https://www.freedesktop.org/wiki/Software/systemd/dbus/">https://www.freedesktop.org/wiki/Software/systemd/dbus/</a></div><div><br></div><div>The history says it was last updated Feb 2014, so I think it's out of date, but I don't know enough about what's changed to update it. (If you want to explain it, I can try to write it up, and then I'll have to figure out how to get write access to update it)</div><div><br></div><div>Here are the issues I see.</div><div><div><br></div><div>1) =============</div><div><br></div><div>Fourth paragraph of the introduction:</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">In contrast to most of the other services of the systemd suite PID 1 does not use PolicyKit for controlling access to privileged operations, but relies exclusively on the low-level D-Bus policy language. (This is done in order to avoid a cyclic dependency between PolicyKit and systemd/PID 1.) This means that sensitive operations exposed by PID 1 on the bus are generally not available to unprivileged processes directly.</blockquote><div><br></div><div>Are there any docs about how to configure systemd access via polkit? I think this changed with these commits (Aug 2014, Sep 2015)</div></div><div><div><a href="https://github.com/systemd/systemd/commit/283868e1dcd8ea7475850d9c6e7d4722c473dd50">https://github.com/systemd/systemd/commit/283868e1dcd8ea7475850d9c6e7d4722c473dd50</a></div></div><div><a href="https://github.com/systemd/systemd/commit/88ced61bf9673407f4b15bf51b1b408fd78c149d">https://github.com/systemd/systemd/commit/88ced61bf9673407f4b15bf51b1b408fd78c149d</a><br></div><div><br></div><div>There are probably other commits that my search didn't turn up.</div><div><br></div><div>2) =============</div><div><br></div><div>First property of Manager: <a href="https://www.freedesktop.org/wiki/Software/systemd/dbus/#properties">https://www.freedesktop.org/wiki/Software/systemd/dbus/#properties</a><br></div><div><br></div><div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><b>Version</b> encodes the version string of the running systemd instance. Note that the version string is purely informational, it should not be parsed, one may not assume the version to be formatted in any particular way. We take the liberty to change the versioning scheme at any time and it is not part of the API.</blockquote><div><br></div></div><div>And in the <font face="monospace, monospace">gdbus introspect</font> examples:</div><div><br></div><div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><font face="monospace, monospace">    properties:<br>      readonly s Version = 'systemd 205';</font></blockquote><div><br></div><div>So, the Version has, as promised, changed format. I just tested in 219 (Centos 7) and 233 (Gentoo), and the dbus Version is only the version number: "219" or "233" respectively, unlike "systemd 205" in the example.</div></div><div>Is version still considered internal API? Do you still discourage using the Version string via dbus?</div><div><br></div><div>3) =============<br></div><div><br></div><div>I've seen Manager.ListUnitsFiltered and Manager.ListUnitsByName in various places (Introspection or comments or commits online), but they're not on the page.</div><div><br></div><div>It would be nice to have them there, perhaps mentioning in which the version they were added to systemd.</div><div><br></div><div><div>4) =============<br></div></div><div><br></div><div>Is there anything else on that page that should be updated due to changes in the last (almost) 4 years?</div><div><br></div><div>Thanks,</div><div>Jacob Floyd</div></div>