.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "GSETTINGS"  "" ""
.SH NAME
gsettings \- GSettings configuration tool
.\" This has to be duplicated from above to make it machine-readable by `reuse`:
.\" SPDX-FileCopyrightText: 2010, 2011, 2013 Red Hat, Inc.
.\" SPDX-FileCopyrightText: 2011 Colin Walters
.\" SPDX-FileCopyrightText: 2016 Jeremy Whiting
.\" SPDX-FileCopyrightText: 2018 Arnaud Bonatti
.\" SPDX-License-Identifier: LGPL-2.1-or-later
.
.SH SYNOPSIS
.nf
\fBgsettings\fP get \fISCHEMA*[:*PATH\fP] \fIKEY\fP
\fBgsettings\fP monitor \fISCHEMA*[:*PATH\fP] \fIKEY\fP
\fBgsettings\fP writable \fISCHEMA*[:*PATH\fP] \fIKEY\fP
\fBgsettings\fP range \fISCHEMA*[:*PATH\fP] \fIKEY\fP
\fBgsettings\fP describe \fISCHEMA*[:*PATH\fP] \fIKEY\fP
\fBgsettings\fP set \fISCHEMA*[:*PATH\fP] \fIKEY\fP \fIVALUE\fP
\fBgsettings\fP reset \fISCHEMA*[:*PATH\fP] \fIKEY\fP
\fBgsettings\fP reset\-recursively \fISCHEMA*[:*PATH\fP]
\fBgsettings\fP list\-schemas [\-\-print\-paths]
\fBgsettings\fP list\-relocatable\-schemas
\fBgsettings\fP list\-keys \fISCHEMA*[:*PATH\fP]
\fBgsettings\fP list\-children \fISCHEMA*[:*PATH\fP]
\fBgsettings\fP list\-recursively [\fISCHEMA*[:*PATH\fP]]
\fBgsettings\fP help [\fICOMMAND\fP]
.fi
.sp
.SH DESCRIPTION
.sp
\fBgsettings\fP offers a simple commandline interface to \fBGSettings\fP\&. It lets
you get, set or monitor an individual key for changes.
.sp
The \fBSCHEMA\fP and \fBKEY\fP 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 \fB:PATH\fP suffix. Specifying the path is only needed if the
schema does not have a fixed path.
.sp
When setting a key, you also need specify a \fBVALUE\fP\&. The format for the value
is that of a serialized \fBGVariant\fP, so e.g. a string must include explicit
quotes: \fB\(aqfoo\(aq\fP\&. This format is also used when printing out values.
.sp
Note that \fBgsettings\fP needs a D\-Bus session bus connection to write changes to
the dconf database.
.SH COMMANDS
.sp
\fBget\fP
.INDENT 0.0
.INDENT 3.5
Gets the value of \fBKEY\fP\&. The value is printed out as a serialized
\fBGVariant\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBmonitor\fP
.INDENT 0.0
.INDENT 3.5
Monitors \fBKEY\fP for changes and prints the changed values. If no \fBKEY\fP is
specified, all keys in the schema are monitored. Monitoring will continue
until the process is terminated.
.UNINDENT
.UNINDENT
.sp
\fBwritable\fP
.INDENT 0.0
.INDENT 3.5
Finds out whether \fBKEY\fP is writable.
.UNINDENT
.UNINDENT
.sp
\fBrange\fP
.INDENT 0.0
.INDENT 3.5
Queries the range of valid values for \fBKEY\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBdescribe\fP
.INDENT 0.0
.INDENT 3.5
Queries the description of valid values for \fBKEY\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBset\fP
.INDENT 0.0
.INDENT 3.5
Sets the value of \fBKEY\fP to \fBVALUE\fP\&. The value is specified as a serialized
\fBGVariant\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBreset\fP
.INDENT 0.0
.INDENT 3.5
Resets \fBKEY\fP to its default value.
.UNINDENT
.UNINDENT
.sp
\fBreset\-recursively\fP
.INDENT 0.0
.INDENT 3.5
Reset all keys under the given \fBSCHEMA\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBlist\-schemas\fP
.INDENT 0.0
.INDENT 3.5
Lists the installed, non\-relocatable schemas. See \fBlist\-relocatable\-schemas\fP
if you are interested in relocatable schemas. If \fB\-\-print\-paths\fP is given,
the path where each schema is mapped is also printed.
.UNINDENT
.UNINDENT
.sp
\fBlist\-relocatable\-schemas\fP
.INDENT 0.0
.INDENT 3.5
Lists the installed, relocatable schemas. See \fBlist\-schemas\fP if you are
interested in non\-relocatable schemas.
.UNINDENT
.UNINDENT
.sp
\fBlist\-keys\fP
.INDENT 0.0
.INDENT 3.5
Lists the keys in \fBSCHEMA\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBlist\-children\fP
.INDENT 0.0
.INDENT 3.5
Lists the children of \fBSCHEMA\fP\&.
.UNINDENT
.UNINDENT
.sp
\fBlist\-recursively\fP
.INDENT 0.0
.INDENT 3.5
Lists keys and values, recursively. If no \fBSCHEMA\fP is given, list keys in
all schemas.
.UNINDENT
.UNINDENT
.sp
\fBhelp\fP
.INDENT 0.0
.INDENT 3.5
Prints help and exits.
.UNINDENT
.UNINDENT
.\" Generated by docutils manpage writer.
.