1GSETTINGS(1)                     User Commands                    GSETTINGS(1)
2
3
4

NAME

6       gsettings - GSettings configuration tool
7

SYNOPSIS

9       gsettings get SCHEMA [:PATH]  KEY
10
11       gsettings monitor SCHEMA [:PATH]  [KEY]
12
13       gsettings writable SCHEMA [:PATH]  KEY
14
15       gsettings range SCHEMA [:PATH]  KEY
16
17       gsettings describe SCHEMA [:PATH]  KEY
18
19       gsettings set SCHEMA [:PATH]  KEY VALUE
20
21       gsettings reset SCHEMA [:PATH]  KEY
22
23       gsettings reset-recursively SCHEMA [:PATH]
24
25       gsettings list-schemas [--print-paths]
26
27       gsettings list-relocatable-schemas
28
29       gsettings list-keys SCHEMA [:PATH]
30
31       gsettings list-children SCHEMA [:PATH]
32
33       gsettings list-recursively [SCHEMA [:PATH]]
34
35       gsettings help [COMMAND]
36

DESCRIPTION

38       gsettings offers a simple commandline interface to GSettings. It lets
39       you get, set or monitor an individual key for changes.
40
41       The SCHEMA and KEY arguments are required for most commands to specify
42       the schema id and the name of the key to operate on. The schema id may
43       optionally have a :PATH suffix. Specifying the path is only needed if
44       the schema does not have a fixed path.
45
46       When setting a key, you also need specify a VALUE The format for the
47       value is that of a serialized GVariant, so e.g. a string must include
48       explicit quotes: "'foo'". This format is also used when printing out
49       values.
50
51       Note that gsettings needs a D-Bus session bus connection to write
52       changes to the dconf database.
53

COMMANDS

55       get
56           Gets the value of KEY. The value is printed out as a serialised
57           GVariant.
58
59       monitor
60           Monitors KEY for changes and prints the changed values. If no KEY
61           is specified, all keys in the schema are monitored. Monitoring will
62           continue until the process is terminated.
63
64       writable
65           Finds out whether KEY is writable.
66
67       range
68           Queries the range of valid values for KEY.
69
70       describe
71           Queries the description of valid values for KEY.
72
73       set
74           Sets the value of KEY to VALUE. The value is specified as a
75           serialised GVariant.
76
77       reset
78           Resets KEY to its default value.
79
80       reset-recursively
81           Reset all keys under the given SCHEMA.
82
83       list-schemas
84           Lists the installed, non-relocatable schemas. See
85           list-relocatable-schemas if you are interested in relocatable
86           schemas. If [--print-paths] is given, the path where each schema is
87           mapped is also printed.
88
89       list-relocatable-schemas
90           Lists the installed, relocatable schemas. See list-schemas if you
91           are interested in non-relocatable schemas.
92
93       list-keys
94           Lists the keys in SCHEMA.
95
96       list-children
97           Lists the children of SCHEMA.
98
99       list-recursively
100           Lists keys and values, recursively. If no SCHEMA is given, list
101           keys in all schemas.
102
103       help
104           Prints help and exits.
105
106
107
108GIO                                                               GSETTINGS(1)
Impressum