gsettings

GIO Reference Manual

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 set SCHEMA [:PATH] KEY VALUE

gsettings reset SCHEMA [:PATH] KEY

gsettings list-schemas

gsettings list-relocatable-schemas

gsettings list-keys SCHEMA [:PATH]

gsettings list-children SCHEMA [:PATH]

gsettings list-recursively SCHEMA [:PATH]

gsettings help [COMMAND]

Description

gsettings offers a simple commandlineinterface to GSettings.It lets you get, set or monitor an individual key for changes.

The SCHEMA and KEYarguments are required for most commands to specify the schema id and thename of the key to operate on. The schema id may optionally have a:PATH suffix. Specifying the path is only neededif the schema does not have a fixed path.

When setting a key, you also need specify a VALUEThe format for the value is that of a serializedGVariant,so e.g. a stringmust include explicit quotes: "'foo'". This format is also used when printingout values.

Commands

get	Gets the value of KEY.The value is printed out as a serialisedGVariant.
monitor	Monitors KEY for changes and prints the changedvalues. Monitoring will continue until the process is terminated.
writable	Finds out whether KEY is writable.
range	Queries the range of valid values for KEY.
set	Sets the value of KEY toVALUE. The value is specified as a serialisedGVariant.
reset	Resets KEY to its default value.
list-schemas	Lists the installed, non-relocatable schemas.See list-relocatable-schemas if you are interested inrelocatable schemas.
list-relocatable-schemas	Lists the installed, relocatable schemas.See list-schemas if you are interested innon-relocatable schemas.
list-keys	Lists the keys in SCHEMA.
list-children	Lists the children of SCHEMA.
list-recursively	Lists keys and values, recursively.
help	Prints help and exits.