Merge branch '1454-gvdb-corruption' into 'master'
[dconf.git] / docs / dconf-service.xml
blob507c14d8b5fae4c522740c15a1ebacd27fe42a85
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">
5 <refentry id="dconf-service">
6   <refentryinfo>
7     <title>dconf-service</title>
8     <productname>dconf</productname>
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>
19   </refentryinfo>
21   <refmeta>
22     <refentrytitle>dconf-service</refentrytitle>
23     <manvolnum>1</manvolnum>
24     <refmiscinfo class="manual">User Commands</refmiscinfo>
25   </refmeta>
27   <refnamediv>
28     <refname>dconf-service</refname>
29     <refpurpose>D-Bus service for writes to the dconf database</refpurpose>
30   </refnamediv>
32   <refsynopsisdiv>
33     <cmdsynopsis>
34       <command>dconf-service</command>
35     </cmdsynopsis>
36   </refsynopsisdiv>
38   <refsect1>
39     <title>Description</title>
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>
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>
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>