summary refs log tree commit diff
path: root/doc/guix.texi
diff options
context:
space:
mode:
authorMaxim Cournoyer <maxim.cournoyer@gmail.com>2021-12-07 22:48:39 -0500
committerMaxim Cournoyer <maxim.cournoyer@gmail.com>2022-06-14 14:23:21 -0400
commita860a5fa95a743093cbda5540fb5be7800439a9f (patch)
tree757657410edc55e566139d10fbda2ff874e3e6dc /doc/guix.texi
parent3aaf52a129ccf1d42aefd31322d21f697ce026b4 (diff)
downloadguix-a860a5fa95a743093cbda5540fb5be7800439a9f.tar.gz
services: dbus: Add a VERBOSE? configuration option.
* gnu/services/dbus.scm (<dbus-configuration>)[verbose?]: New field.
(dbus-shepherd-service): Use it.
(dbus-service)[verbose?]: Add argument and update doc.
* doc/guix.texi (Desktop Services): Document it.
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi9
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 967145a627..4c2c856c79 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -21767,9 +21767,14 @@ The actual service definitions included in @code{%desktop-services} and
 provided by @code{(gnu services dbus)} and @code{(gnu services desktop)}
 are described below.
 
-@deffn {Scheme Procedure} dbus-service [#:dbus @var{dbus}] [#:services '()]
+@deffn {Scheme Procedure} dbus-service [#:dbus @var{dbus}] [#:services '()] @
+                                       [#:verbose?]
 Return a service that runs the ``system bus'', using @var{dbus}, with
-support for @var{services}.
+support for @var{services}.  When @var{verbose?} is true, it causes the
+@samp{DBUS_VERBOSE} environment variable to be set to @samp{1}; a
+verbose-enabled D-Bus package such as @code{dbus-verbose} should be
+provided as @var{dbus} in this scenario.  The verbose output is logged
+to @file{/var/log/dbus-daemon.log}.
 
 @uref{https://dbus.freedesktop.org/, D-Bus} is an inter-process communication
 facility.  Its system bus is used to allow system services to communicate