docs/dconf-service.xml

   1 <?xml version='1.0'?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4
   5 <refentry id="dconf-service">
   6   <refentryinfo>
   7     <title>dconf-service</title>
   8     <productname>dconf</productname>
   9
  10     <authorgroup>
  11       <author>
  12         <contrib>Developer</contrib>
  13         <firstname>Ryan</firstname>
  14         <surname>Lortie</surname>
  15         <email>desrt@desrt.ca</email>
  16       </author>
  17     </authorgroup>
  18
  19   </refentryinfo>
  20
  21   <refmeta>
  22     <refentrytitle>dconf-service</refentrytitle>
  23     <manvolnum>1</manvolnum>
  24     <refmiscinfo class="manual">User Commands</refmiscinfo>
  25   </refmeta>
  26
  27   <refnamediv>
  28     <refname>dconf-service</refname>
  29     <refpurpose>D-Bus service for writes to the dconf database</refpurpose>
  30   </refnamediv>
  31
  32   <refsynopsisdiv>
  33     <cmdsynopsis>
  34       <command>dconf-service</command>
  35     </cmdsynopsis>
  36   </refsynopsisdiv>
  37
  38   <refsect1>
  39     <title>Description</title>
  40
  41     <para>
  42       The <command>dconf-service</command> program provides the <emphasis>ca.desrt.dconf</emphasis> name on the
  43       session or system bus. Users or administrators should never need to start the service, as it will be
  44       automatically started by
  45       <citerefentry><refentrytitle>dbus-daemon</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  46       whenever an application tries to write settings.
  47     </para>
  48
  49     <para>
  50       Reading values from the dconf database does not involve the service; it is only needed for writes. The
  51       service is stateless and can exit freely at any time (and is therefore robust against crashes).
  52     </para>
  53   </refsect1>
  54
  55   <refsect1>
  56     <title>See Also</title>
  57     <para>
  58       <citerefentry><refentrytitle>dconf</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
  59       <citerefentry><refentrytitle>dbus-daemon</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  60       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  61     </para>
  62   </refsect1>
  63 </refentry>