docs/reference/gio/gsettings.xml

   1 <refentry id="gsettings-tool" lang="en">
   2
   3 <refentryinfo>
   4   <title>gsettings</title>
   5   <productname>GIO</productname>
   6   <authorgroup>
   7     <author>
   8       <contrib>Developer</contrib>
   9       <firstname>Ryan</firstname>
  10       <surname>Lortie</surname>
  11     </author>
  12   </authorgroup>
  13 </refentryinfo>
  14
  15 <refmeta>
  16   <refentrytitle>gsettings</refentrytitle>
  17   <manvolnum>1</manvolnum>
  18   <refmiscinfo class="manual">User Commands</refmiscinfo>
  19 </refmeta>
  20
  21 <refnamediv>
  22   <refname>gsettings</refname>
  23   <refpurpose>GSettings configuration tool</refpurpose>
  24 </refnamediv>
  25
  26 <refsynopsisdiv>
  27   <cmdsynopsis>
  28     <command>gsettings</command>
  29     <arg choice="plain">get</arg>
  30     <arg choice="plain"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  31     <arg choice="plain"><replaceable>KEY</replaceable></arg>
  32   </cmdsynopsis>
  33   <cmdsynopsis>
  34     <command>gsettings</command>
  35     <arg choice="plain">monitor</arg>
  36     <arg choice="plain"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  37     <arg choice="opt"><replaceable>KEY</replaceable></arg>
  38   </cmdsynopsis>
  39   <cmdsynopsis>
  40     <command>gsettings</command>
  41     <arg choice="plain">writable</arg>
  42     <arg choice="plain"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  43     <arg choice="plain"><replaceable>KEY</replaceable></arg>
  44   </cmdsynopsis>
  45   <cmdsynopsis>
  46     <command>gsettings</command>
  47     <arg choice="plain">range</arg>
  48     <arg choice="plain"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  49     <arg choice="plain"><replaceable>KEY</replaceable></arg>
  50   </cmdsynopsis>
  51   <cmdsynopsis>
  52     <command>gsettings</command>
  53     <arg choice="plain">set</arg>
  54     <arg choice="plain"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  55     <arg choice="plain"><replaceable>KEY</replaceable></arg>
  56     <arg choice="plain"><replaceable>VALUE</replaceable></arg>
  57   </cmdsynopsis>
  58   <cmdsynopsis>
  59     <command>gsettings</command>
  60     <arg choice="plain">reset</arg>
  61     <arg choice="plain"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  62     <arg choice="plain"><replaceable>KEY</replaceable></arg>
  63   </cmdsynopsis>
  64   <cmdsynopsis>
  65     <command>gsettings</command>
  66     <arg choice="plain">reset-recursively</arg>
  67     <arg choice="plain"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  68   </cmdsynopsis>
  69   <cmdsynopsis>
  70     <command>gsettings</command>
  71     <arg choice="plain">list-schemas</arg>
  72   </cmdsynopsis>
  73   <cmdsynopsis>
  74     <command>gsettings</command>
  75     <arg choice="plain">list-relocatable-schemas</arg>
  76   </cmdsynopsis>
  77   <cmdsynopsis>
  78     <command>gsettings</command>
  79     <arg choice="plain">list-keys</arg>
  80     <arg choice="plain"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  81   </cmdsynopsis>
  82   <cmdsynopsis>
  83     <command>gsettings</command>
  84     <arg choice="plain">list-children</arg>
  85     <arg choice="plain"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  86   </cmdsynopsis>
  87   <cmdsynopsis>
  88     <command>gsettings</command>
  89     <arg choice="plain">list-recursively</arg>
  90     <arg choice="opt"><replaceable>SCHEMA</replaceable><arg choice="opt">:<replaceable>PATH</replaceable></arg></arg>
  91   </cmdsynopsis>
  92   <cmdsynopsis>
  93     <command>gsettings</command>
  94     <arg choice="plain">help</arg>
  95     <arg choice="opt"><replaceable>COMMAND</replaceable></arg>
  96   </cmdsynopsis>
  97 </refsynopsisdiv>
  98
  99 <refsect1><title>Description</title>
 100 <para><command>gsettings</command> offers a simple commandline
 101 interface to <link linkend="GSettings"><type>GSettings</type></link>.
 102 It lets you get, set or monitor an individual key for changes.
 103 </para>
 104 <para>
 105 The <replaceable>SCHEMA</replaceable> and <replaceable>KEY</replaceable>
 106 arguments are required for most commands to specify the schema id and the
 107 name of the key to operate on. The schema id may optionally have a
 108 :<replaceable>PATH</replaceable> suffix. Specifying the path is only needed
 109 if the schema does not have a fixed path.
 110 </para>
 111 <para>
 112 When setting a key, you also need specify a <replaceable>VALUE</replaceable>
 113 The format for the value is that of a serialized
 114 <link linkend="GVariant"><type>GVariant</type></link>,
 115 so e.g. a string
 116 must include explicit quotes: "'foo'". This format is also used when printing
 117 out values.
 118 </para>
 119 </refsect1>
 120
 121 <refsect1><title>Commands</title>
 122 <variablelist>
 123
 124 <varlistentry>
 125 <term><option>get</option></term>
 126 <listitem><para>
 127 Gets the value of <replaceable>KEY</replaceable>.
 128 The value is printed out as a serialised
 129 <link linkend="GVariant"><type>GVariant</type></link>.
 130 </para></listitem>
 131 </varlistentry>
 132
 133 <varlistentry>
 134 <term><option>monitor</option></term>
 135 <listitem><para>
 136 Monitors <replaceable>KEY</replaceable> for changes and prints the changed
 137 values. If no <replaceable>KEY</replaceable> is specified, all keys in the
 138 schema are monitored. Monitoring will continue until the process is terminated.
 139 </para></listitem>
 140 </varlistentry>
 141
 142 <varlistentry>
 143 <term><option>writable</option></term>
 144 <listitem><para>
 145 Finds out whether <replaceable>KEY</replaceable> is writable.
 146 </para></listitem>
 147 </varlistentry>
 148
 149 <varlistentry>
 150 <term><option>range</option></term>
 151 <listitem><para>
 152 Queries the range of valid values for <replaceable>KEY</replaceable>.
 153 </para></listitem>
 154 </varlistentry>
 155
 156 <varlistentry>
 157 <term><option>set</option></term>
 158 <listitem><para>
 159 Sets the value of <replaceable>KEY</replaceable> to
 160 <replaceable>VALUE</replaceable>. The value is specified as a serialised
 161 <link linkend="GVariant"><type>GVariant</type></link>.
 162 </para></listitem>
 163 </varlistentry>
 164
 165 <varlistentry>
 166 <term><option>reset</option></term>
 167 <listitem><para>
 168 Resets <replaceable>KEY</replaceable> to its default value.
 169 </para></listitem>
 170 </varlistentry>
 171
 172 <varlistentry>
 173 <term><option>reset-recursively</option></term>
 174 <listitem><para>
 175 Reset all keys under the given <replaceable>SCHEMA</replaceable>.
 176 </para></listitem>
 177 </varlistentry>
 178
 179 <varlistentry>
 180 <term><option>list-schemas</option></term>
 181 <listitem><para>
 182 Lists the installed, non-relocatable schemas.
 183 See <option>list-relocatable-schemas</option> if you are interested in
 184 relocatable schemas.
 185 </para></listitem>
 186 </varlistentry>
 187
 188 <varlistentry>
 189 <term><option>list-relocatable-schemas</option></term>
 190 <listitem><para>
 191 Lists the installed, relocatable schemas.
 192 See <option>list-schemas</option> if you are interested in
 193 non-relocatable schemas.
 194 </para></listitem>
 195 </varlistentry>
 196
 197 <varlistentry>
 198 <term><option>list-keys</option></term>
 199 <listitem><para>
 200 Lists the keys in <replaceable>SCHEMA</replaceable>.
 201 </para></listitem>
 202 </varlistentry>
 203
 204 <varlistentry>
 205 <term><option>list-children</option></term>
 206 <listitem><para>
 207 Lists the children of <replaceable>SCHEMA</replaceable>.
 208 </para></listitem>
 209 </varlistentry>
 210
 211 <varlistentry>
 212 <term><option>list-recursively</option></term>
 213 <listitem><para>
 214 Lists keys and values, recursively. If no <replaceable>SCHEMA</replaceable>
 215 is given, list keys in all schemas.
 216 </para></listitem>
 217 </varlistentry>
 218
 219 <varlistentry>
 220 <term><option>help</option></term>
 221 <listitem><para>
 222 Prints help and exits.
 223 </para></listitem>
 224 </varlistentry>
 225
 226 </variablelist>
 227
 228 </refsect1>
 229 </refentry>