~3v1n0/unity-settings-daemon/redirect-fdo-screensaver-calls

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
<?xml version='1.0'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<refentry id="unity-settings-daemon">

        <refentryinfo>
                <title>unity-settings-daemon</title>
                <productname>Unity</productname>

                <authorgroup>
                        <author>
                                <contrib>Maintainer</contrib>
                                <firstname>Bastien</firstname>
                                <surname>Nocera</surname>
                                <email>hadess@hadess.net</email>
                        </author>
                </authorgroup>

        </refentryinfo>

        <refmeta>
                <refentrytitle>unity-settings-daemon</refentrytitle>
                <manvolnum>1</manvolnum>
                <refmiscinfo class="manual">User Commands</refmiscinfo>
        </refmeta>

        <refnamediv>
                <refname>unity-settings-daemon</refname>
                <refpurpose>Unity settings daemon</refpurpose>
        </refnamediv>

        <refsynopsisdiv>
                <cmdsynopsis>
                        <command>unity-settings-daemon <arg choice="opt" rep="repeat">OPTION</arg></command>
                </cmdsynopsis>
        </refsynopsisdiv>

        <refsect1>
                <title>Description</title>

                <para><command>unity-settings-daemon</command> provides many
                session-wide services and functions that require a
                long-running process.
                Among the services implemented by unity-settings-daemon
                are an XSettings manager, which provides theming, font
                and other settings to GTK+ applications, and a clipboard
                manager, which preserves clipboard contents when an
                application exits.
                Many user interface elements of
                <command>unity</command> and
                <command>unity-control-center</command> rely on
                unity-settings-daemon for their functionality.
                </para>

                <para>The internal architecture of unity-settings-daemon
                consists of a number of plugins, which provide functionality
                such as printer notifications, software update monitoring,
                background changing, etc. For debugging purposes, these
                plugins can be individually disabled by changing the
                gsettings key <literal>org.gnome.settings-daemon.plugins.<replaceable>plugin-name</replaceable>.active</literal>, where
                <replaceable>plugin-name</replaceable> is
                the name of the plugin. To see a list of all plugins,
                use the command
                <userinput>
                gsettings list-children org.gnome.settings-daemon.plugins
                </userinput>
                </para>

                <para>unity-settings-daemon takes the name
                org.gnome.SettingsDaemon on the session bus to ensure
                that only one instance is running. Some plugins export
                objects under this name to make their functionality
                available to other applications. The interfaces of
                these objects should generally be considered private
                and unstable.</para>

                <para>unity-settings-daemon is a required component of
                the Unity desktop, i.e. it is listed in the
                RequiredComponents field of
                <filename>/usr/share/gnome-session/sessions/gnome.session</filename>.
                It is started in the initialization phase of the session,
                and <command>gnome-session</command> will restart it
                if it crashes.
                </para>

        </refsect1>

        <refsect1>
                <title>Options</title>

                <variablelist>
                        <varlistentry>
                                <term><option>-h</option>, <option>--help</option></term>

                                <listitem><para>Prints a short help
                                text and exits.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><option>--debug</option></term>

                                <listitem><para>Enables debugging code.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><option>--timed-exit</option></term>

                                <listitem><para>Exits after a timeout (30 seconds) for debugging.</para></listitem>
                        </varlistentry>

                </variablelist>
        </refsect1>

        <refsect1>
                <title>Files</title>
                <variablelist>
                        <varlistentry>
                                <term><filename>/usr/share/gnome-session/sessions/ubuntu.session</filename></term>

                                <listitem><para>Unity session definition file where unity-settings-daemon is listed as a required component.</para></listitem>
                        </varlistentry>
                        <varlistentry>
                                <term><filename>/etc/xdg/autostart/unity-settings-daemon.desktop</filename></term>

                                <listitem><para>Autostart file for unity-settings-daemon, where its autostart phase is set.</para></listitem>
                        </varlistentry>
                </variablelist>
        </refsect1>

        <refsect1>
                <title>See Also</title>
                <para>
                        <citerefentry><refentrytitle>unity</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>unity-control-center</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>gnome-session</refentrytitle><manvolnum>1</manvolnum></citerefentry>
                </para>
        </refsect1>

</refentry>