gsettings
gsettings — GSettings configuration tool
|
|
Synopsis
gsettings get SCHEMA [:PATH] KEY
gsettings monitor SCHEMA [:PATH] [KEY]
gsettings writable SCHEMA [:PATH] KEY
gsettings range SCHEMA [:PATH] KEY
gsettings describe SCHEMA [:PATH] KEY
gsettings set SCHEMA [:PATH] KEY VALUE
gsettings reset SCHEMA [:PATH] KEY
gsettings reset-recursively SCHEMA [:PATH]
gsettings list-schemas [--print-paths]
gsettings list-relocatable-schemas
gsettings list-keys SCHEMA [:PATH]
gsettings list-children SCHEMA [:PATH]
gsettings list-recursively [SCHEMA [:PATH]]
Description
gsettings offers a simple commandline
interface to GSettings.
It lets you get, set or monitor an individual key for changes.
The SCHEMA and KEY
arguments are required for most commands to specify the schema id and the
name of the key to operate on. The schema id may optionally have a
:PATH suffix. Specifying the path is only needed
if the schema does not have a fixed path.
When setting a key, you also need specify a VALUE
The format for the value is that of a serialized
GVariant,
so e.g. a string
must include explicit quotes: "'foo'". This format is also used when printing
out values.
Note that gsettings needs a D-Bus session bus connection to write changes to
the dconf database.
Commands
get
|
Gets the value of KEY.
The value is printed out as a serialised
GVariant.
|
monitor
|
Monitors KEY for changes and prints the changed
values. If no KEY is specified, all keys in the
schema are monitored. Monitoring will continue until the process is terminated.
|
writable
|
Finds out whether KEY is writable.
|
range
|
Queries the range of valid values for KEY.
|
describe
|
Queries the description of valid values for KEY.
|
set
|
Sets the value of KEY to
VALUE. The value is specified as a serialised
GVariant.
|
reset
|
Resets KEY to its default value.
|
reset-recursively
|
Reset all keys under the given SCHEMA.
|
list-schemas
|
Lists the installed, non-relocatable schemas.
See list-relocatable-schemas if you are interested in
relocatable schemas. If [--print-paths]
is given, the path where each schema is mapped is also printed.
|
list-relocatable-schemas
|
Lists the installed, relocatable schemas.
See list-schemas if you are interested in
non-relocatable schemas.
|
list-keys
|
Lists the keys in SCHEMA.
|
list-children
|
Lists the children of SCHEMA.
|
list-recursively
|
Lists keys and values, recursively. If no SCHEMA
is given, list keys in all schemas.
|
help
|
Prints help and exits.
|