OLD | NEW |
1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859
-1"><title>xdg-settings</title><meta name="generator" content="DocBook XSL Style
sheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="
#840084" alink="#0000FF"><div class="refentry" title="xdg-settings"><a name="xdg
-settings"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2
><p>xdg-settings — get various settings from the desktop environment</p></
div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cm
dsynopsis"><p><code class="command">xdg-settings</code> { <code class="option">
<em class="replaceable"><code>get</code></em></code> | <code class="option"><
em class="replaceable"><code>check</code></em></code> | <code class="option">
<em class="replaceable"><code>set</code></em></code> } {<code class="option">pro
perty</code>} [<code class="option">value</code>]</p></div><div class="cmdsynops
is"><p><code class="command">xdg-settings</code> { <code class="option">--help<
/code> | <code class="option">--list</code> | <code class="option">--manua
l</code> | <code class="option">--version</code> }</p></div></div><div class=
"refsect1" title="Description"><a name="description"></a><h2>Description</h2><p> | 1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859
-1"><title>xdg-settings</title><meta name="generator" content="DocBook XSL Style
sheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="
#840084" alink="#0000FF"><div class="refentry" title="xdg-settings"><a name="xdg
-settings"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2
><p>xdg-settings — get various settings from the desktop environment</p></
div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cm
dsynopsis"><p><code class="command">xdg-settings</code> { <code class="option">
<em class="replaceable"><code>get</code></em></code> | <code class="option"><
em class="replaceable"><code>check</code></em></code> | <code class="option">
<em class="replaceable"><code>set</code></em></code> } {<code class="option">pro
perty</code>} [<code class="option">subproperty</code>] [<code class="option">va
lue</code>]</p></div><div class="cmdsynopsis"><p><code class="command">xdg-setti
ngs</code> { <code class="option">--help</code> | <code class="option">--lis
t</code> | <code class="option">--manual</code> | <code class="option">--v
ersion</code> }</p></div></div><div class="refsect1" title="Description"><a name
="description"></a><h2>Description</h2><p> |
2 xdg-settings gets various settings from the desktop environment. | 2 xdg-settings gets various settings from the desktop environment. |
3 For instance, desktop environments often provide proxy configuration | 3 For instance, desktop environments often provide proxy configuration |
4 and default web browser settings. Using xdg-settings these parameters | 4 and default web browser settings. Using xdg-settings these parameters |
5 can be extracted for use by applications that do not use the desktop | 5 can be extracted for use by applications that do not use the desktop |
6 environment's libraries (which would use the settings natively). | 6 environment's libraries (which would use the settings natively). |
7 </p><p> | 7 </p><p> |
8 xdg-settings is for use inside a desktop session only. | 8 xdg-settings is for use inside a desktop session only. |
9 It is not recommended to use xdg-settings as root. | 9 It is not recommended to use xdg-settings as root. |
10 </p></div><div class="refsect1" title="Options"><a name="options"></a><h2>Op
tions</h2><div class="variablelist"><dl><dt><span class="term"><code class="opti
on">--help</code></span></dt><dd> | 10 </p></div><div class="refsect1" title="Options"><a name="options"></a><h2>Op
tions</h2><div class="variablelist"><dl><dt><span class="term"><code class="opti
on">--help</code></span></dt><dd> |
11 Show command synopsis. | 11 Show command synopsis. |
12 </dd><dt><span class="term"><code class="option">--list</code></span><
/dt><dd> | 12 </dd><dt><span class="term"><code class="option">--list</code></span><
/dt><dd> |
13 List all properties xdg-settings knows about. | 13 List all properties xdg-settings knows about. |
14 </dd><dt><span class="term"><code class="option">--manual</code></span
></dt><dd> | 14 </dd><dt><span class="term"><code class="option">--manual</code></span
></dt><dd> |
15 Show this manualpage. | 15 Show this manualpage. |
16 </dd><dt><span class="term"><code class="option">--version</code></spa
n></dt><dd> | 16 </dd><dt><span class="term"><code class="option">--version</code></spa
n></dt><dd> |
17 Show the xdg-utils version information. | 17 Show the xdg-utils version information. |
18 </dd></dl></div></div><div class="refsect1" title="Exit Codes"><a name
="exitcodes"></a><h2>Exit Codes</h2><p> | 18 </dd></dl></div></div><div class="refsect1" title="Properties"><a name
="properties"></a><h2>Properties</h2><p> |
| 19 When using xdg-settings to get, check or set a destkop setting, properties |
| 20 and possibly sub-properties are used to specify the setting to be changed. |
| 21 </p><p> |
| 22 Some properties (such as default-web-browser) fully describe the setting |
| 23 to be changed. Other properties (such as default-url-scheme-handler) requi
re |
| 24 more information (in this case the actual scheme to set the default handle
r |
| 25 for) which must be provided in a sub-property. |
| 26 </p></div><div class="refsect1" title="Exit Codes"><a name="exitcodes"></a><
h2>Exit Codes</h2><p> |
19 An exit code of 0 indicates success while a non-zero exit code | 27 An exit code of 0 indicates success while a non-zero exit code |
20 indicates failure. The following failure codes can be returned: | 28 indicates failure. The following failure codes can be returned: |
21 </p><div class="variablelist"><dl><dt><span class="term"><code class="option
">1</code></span></dt><dd> | 29 </p><div class="variablelist"><dl><dt><span class="term"><code class="option
">1</code></span></dt><dd> |
22 Error in command line syntax. | 30 Error in command line syntax. |
23 </dd><dt><span class="term"><code class="option">2</code></span></dt><
dd> | 31 </dd><dt><span class="term"><code class="option">2</code></span></dt><
dd> |
24 One of the files passed on the command line did not exist. | 32 One of the files passed on the command line did not exist. |
25 </dd><dt><span class="term"><code class="option">3</code></span></dt><
dd> | 33 </dd><dt><span class="term"><code class="option">3</code></span></dt><
dd> |
26 A required tool could not be found. | 34 A required tool could not be found. |
27 </dd><dt><span class="term"><code class="option">4</code></span></dt><
dd> | 35 </dd><dt><span class="term"><code class="option">4</code></span></dt><
dd> |
28 The action failed. | 36 The action failed. |
29 </dd></dl></div></div><div class="refsect1" title="Examples"><a name="
examples"></a><h2>Examples</h2><p> | 37 </dd></dl></div></div><div class="refsect1" title="Examples"><a name="
examples"></a><h2>Examples</h2><p> |
30 Get the desktop file name of the current default web browser | 38 Get the desktop file name of the current default web browser |
31 </p><pre class="programlisting"> | 39 </p><pre class="programlisting"> |
32 xdg-settings get default-web-browser | 40 xdg-settings get default-web-browser |
33 </pre><p> | 41 </pre><p> |
34 </p><p> | 42 </p><p> |
35 Check whether the default web browser is firefox.desktop, which can be | 43 Check whether the default web browser is firefox.desktop, which can be |
36 false even if "get default-web-browser" says that is the current value | 44 false even if "get default-web-browser" says that is the current value |
37 (if only some of the underlying settings actually reflect that value) | 45 (if only some of the underlying settings actually reflect that value) |
38 </p><pre class="programlisting"> | 46 </p><pre class="programlisting"> |
39 xdg-settings check default-web-browser firefox.desktop | 47 xdg-settings check default-web-browser firefox.desktop |
40 </pre><p> | 48 </pre><p> |
41 </p><p> | 49 </p><p> |
42 Set the default web browser to google-chrome.desktop | 50 Set the default web browser to google-chrome.desktop |
43 </p><pre class="programlisting"> | 51 </p><pre class="programlisting"> |
44 xdg-settings set default-web-browser google-chrome.desktop | 52 xdg-settings set default-web-browser google-chrome.desktop |
45 </pre><p> | 53 </pre><p> |
| 54 </p><p> |
| 55 Set the default mailto URL scheme handler to be evolution.desktop |
| 56 </p><pre class="programlisting"> |
| 57 xdg-settings set default-url-scheme-handler mailto evolution.desktop |
| 58 </pre><p> |
46 </p></div></div></body></html> | 59 </p></div></div></body></html> |
OLD | NEW |