GSETTINGS(1) GIO GSETTINGS(1)
User Commands User Commands
NAME
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 reset-recursively SCHEMA [:PATH]
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 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.
COMMANDS
get
Gets the value of KEY. The value is printed out as a serialised
GVariant.
- 1 - Formatted: December 22, 2024
GSETTINGS(1) GIO GSETTINGS(1)
User Commands User Commands
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.
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.
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.
- 2 - Formatted: December 22, 2024
