diff options
author | Bruno Victal <mirai@makinata.eu> | 2023-02-25 18:58:04 +0000 |
---|---|---|
committer | Ludovic Courtès <ludo@gnu.org> | 2023-03-03 17:55:34 +0100 |
commit | ffc5d42fc2589c349579c00e9dd11fabdff2663b (patch) | |
tree | ea2dd2e1b87933bae294af794627a951b23cee26 /doc | |
parent | c3dc13e29c624609b851ef50db343074fad2d7cb (diff) |
services: dbus: Deprecate 'polkit-service' procedure.
* doc/guix.texi (Desktop Services): Replace 'polkit-service' with 'polkit-service-type'.
* gnu/services/dbus.scm (polkit-service): Deprecate procedure.
* gnu/tests/docker.scm (%docker-os): Use polkit-service-type.
* gnu/tests/virtualization.scm (%libvirt-os): Ditto.
Signed-off-by: Ludovic Courtès <ludo@gnu.org>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/guix.texi | 14 |
1 files changed, 9 insertions, 5 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 0530b9a45b..4ff5622ad3 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -23440,16 +23440,20 @@ The value for this service is a file-like object, by default it is set to @code{accountsservice} (the package object for AccountsService). @end defvar -@deffn {Scheme Procedure} polkit-service @ - [#:polkit @var{polkit}] -Return a service that runs the -@uref{https://www.freedesktop.org/wiki/Software/polkit/, Polkit privilege +@defvar polkit-service-type +Type for the service that runs the +@url{https://www.freedesktop.org/wiki/Software/polkit/, Polkit privilege management service}, which allows system administrators to grant access to privileged operations in a structured way. By querying the Polkit service, a privileged system component can know when it should grant additional capabilities to ordinary users. For example, an ordinary user can be granted the capability to suspend the system if the user is logged in locally. -@end deffn + +The value for this service is a @code{<polkit-configuration>} object. +@end defvar + +@c TODO: Document <polkit-configuration>, preferably by refactoring this to use +@c define-configuration and generating documentation from it. @defvar polkit-wheel-service Service that adds the @code{wheel} group as admins to the Polkit |