]> git.ipfire.org Git - thirdparty/systemd.git/commit
docs: Clarify that login1 signals are not emitted for convenience objects 36467/head
authorPhilip Withnall <pwithnall@gnome.org>
Thu, 20 Feb 2025 18:15:43 +0000 (18:15 +0000)
committerPhilip Withnall <pwithnall@gnome.org>
Thu, 20 Feb 2025 18:18:56 +0000 (18:18 +0000)
commit82b32b997c51e259ddf66a0ec6bd7631b0ea781d
treeb347e588e04db994575cf9d9a4d4370c4e74be95
parent5fe4edd3fccd2a14ec3488daeac80ddb33bc71db
docs: Clarify that login1 signals are not emitted for convenience objects

While this is obvious if you spend a few minutes thinking about how
D-Bus signals work (in this case, they are broadcast from a system
service, so cannot apply to a specific user/session/seat), it’s a bit
easy to overlook this while putting code together which uses the login1
D-Bus API, so it’s helpful to point this hazard out specifically in the
docs.

The signals can only be emitted on the canonical objects. The
convenience objects are useful for method calls, as the calling context
can be used to dereference ‘self’ and ‘auto’, but this can’t work for
signals.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>
man/org.freedesktop.login1.xml