Blame docs/reference/gio/html/gsettings-tool.html

Packit ae235b
Packit ae235b
<html>
Packit ae235b
<head>
Packit ae235b
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit ae235b
<title>gsettings: GIO Reference Manual</title>
Packit ae235b
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit ae235b
<link rel="home" href="index.html" title="GIO Reference Manual">
Packit ae235b
<link rel="up" href="tools.html" title="GIO Tools">
Packit ae235b
<link rel="prev" href="gio-querymodules.html" title="gio-querymodules">
Packit ae235b
<link rel="next" href="glib-compile-schemas.html" title="glib-compile-schemas">
Packit ae235b
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
Packit ae235b
<link rel="stylesheet" href="style.css" type="text/css">
Packit ae235b
</head>
Packit ae235b
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit ae235b
Packit ae235b
Packit ae235b
Home
Packit ae235b
Up
Packit ae235b
Prev
Packit ae235b
Next
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b

gsettings

Packit ae235b

gsettings — GSettings configuration tool

Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b

Synopsis

Packit ae235b

gsettings get SCHEMA [:PATH] KEY

Packit ae235b

gsettings monitor SCHEMA [:PATH] [KEY]

Packit ae235b

gsettings writable SCHEMA [:PATH] KEY

Packit ae235b

gsettings range SCHEMA [:PATH] KEY

Packit ae235b

gsettings describe SCHEMA [:PATH] KEY

Packit ae235b

gsettings set SCHEMA [:PATH] KEY VALUE

Packit ae235b

gsettings reset SCHEMA [:PATH] KEY

Packit ae235b

gsettings reset-recursively SCHEMA [:PATH]

Packit ae235b

gsettings list-schemas [--print-paths]

Packit ae235b

gsettings list-relocatable-schemas

Packit ae235b

gsettings list-keys SCHEMA [:PATH]

Packit ae235b

gsettings list-children SCHEMA [:PATH]

Packit ae235b

gsettings list-recursively [SCHEMA [:PATH]]

Packit ae235b

gsettings help [COMMAND]

Packit ae235b
Packit ae235b
Packit ae235b

Description

Packit ae235b

gsettings offers a simple commandline

Packit ae235b
interface to GSettings.
Packit ae235b
It lets you get, set or monitor an individual key for changes.
Packit ae235b

Packit ae235b

Packit ae235b
The SCHEMA and KEY
Packit ae235b
arguments are required for most commands to specify the schema id and the
Packit ae235b
name of the key to operate on. The schema id may optionally have a
Packit ae235b
:PATH suffix. Specifying the path is only needed
Packit ae235b
if the schema does not have a fixed path.
Packit ae235b

Packit ae235b

Packit ae235b
When setting a key, you also need specify a VALUE
Packit ae235b
The format for the value is that of a serialized
Packit ae235b
GVariant,
Packit ae235b
so e.g. a string
Packit ae235b
must include explicit quotes: "'foo'". This format is also used when printing
Packit ae235b
out values.
Packit ae235b

Packit ae235b

Packit ae235b
Note that gsettings needs a D-Bus session bus connection to write changes to
Packit ae235b
the dconf database.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

Commands

Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b

get

Packit ae235b

Packit ae235b
Gets the value of KEY.
Packit ae235b
The value is printed out as a serialised
Packit ae235b
GVariant.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

monitor

Packit ae235b

Packit ae235b
Monitors KEY for changes and prints the changed
Packit ae235b
values. If no KEY is specified, all keys in the
Packit ae235b
schema are monitored. Monitoring will continue until the process is terminated.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

writable

Packit ae235b

Packit ae235b
Finds out whether KEY is writable.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

range

Packit ae235b

Packit ae235b
Queries the range of valid values for KEY.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

describe

Packit ae235b

Packit ae235b
Queries the description of valid values for KEY.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

set

Packit ae235b

Packit ae235b
Sets the value of KEY to
Packit ae235b
VALUE. The value is specified as a serialised
Packit ae235b
GVariant.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

reset

Packit ae235b

Packit ae235b
Resets KEY to its default value.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

reset-recursively

Packit ae235b

Packit ae235b
Reset all keys under the given SCHEMA.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

list-schemas

Packit ae235b

Packit ae235b
Lists the installed, non-relocatable schemas.
Packit ae235b
See list-relocatable-schemas if you are interested in
Packit ae235b
relocatable schemas. If [--print-paths]
Packit ae235b
is given, the path where each schema is mapped is also printed.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

list-relocatable-schemas

Packit ae235b

Packit ae235b
Lists the installed, relocatable schemas.
Packit ae235b
See list-schemas if you are interested in
Packit ae235b
non-relocatable schemas.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

list-keys

Packit ae235b

Packit ae235b
Lists the keys in SCHEMA.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

list-children

Packit ae235b

Packit ae235b
Lists the children of SCHEMA.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

list-recursively

Packit ae235b

Packit ae235b
Lists keys and values, recursively. If no SCHEMA
Packit ae235b
is given, list keys in all schemas.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b

help

Packit ae235b

Packit ae235b
Prints help and exits.
Packit ae235b

Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b
Packit ae235b

Generated by GTK-Doc V1.27
Packit ae235b
</body>
Packit ae235b
</html>