dconf

dconf — Simple tool for manipulating a dconf database

Synopsis

dconf read KEY

dconf list DIR

dconf write KEY VALUE

dconf reset [-f] PATH

dconf update

dconf watch PATH

dconf dump DIR

dconf load DIR

dconf help [COMMAND]

Description

The dconf program can perform various operations on a dconf database, such as reading or writing individual values or entire directories. This tool operates directly on the dconf database and does not read gsettings schema information. Therefore, it cannot perform type and consistency checks on values. The gsettings(1) utility is an alternative if such checks are needed.

The DIR arguments must be directory paths (starting and ending with '/'), the KEY arguments must be key paths (starting, but not ending with '/') and the PATH arguments can be either directory or key paths.

VALUE arguments must be in GVariant format, so e.g. a string must include explicit quotes: "'foo'". This format is also used when printing out values.

Commands

read

Read the value of a key.

list

List the sub-keys and sub-directories of a directory.

write

Write a new value to a key.

reset

Reset a key or an entire directory. For directories, -f must be specified.

update

Update the system dconf databases.

watch

Watch a key or directory for changes.

dump

Dump an entire subpath to stdout. The output is in a keyfile-like format, with values in GVariant syntax.

load

Populate a subpath from stdin. The expected format is the same as produced by dump.

help

Display help and exit. If COMMAND is given, display help for this command.

See Also

dconf(7), gsettings(1), dconf-editor(1)