1GCONFTOOL-2(1) User Commands GCONFTOOL-2(1)
2
6 gconftool-2 - GNOME configuration tool
7
9 gconftool-2 [-?] [-?|--help] [--usage] [-s|--set] [-g|--get]
10 [--set-schema] [-u|--unset] [--recursive-unset] [-a|--all-entries]
11 [--all-dirs] [--dump] [--load=STRING] [-R|--recursive-list]
12 [--dir-exists=STRING] [--shutdown] [-p|--ping] [--spawn] [-t|--type
13 int|bool|float|string|list|pair] [-T|--get-type] [--get-list-size]
14 [--get-list-element] [--list-type=int|bool|float|string]
15 [--car-type=int|bool|float|string] [--cdr-type=int|bool|float|string]
16 [--short-desc=DESCRIPTION] [--long-desc=DESCRIPTION] [--owner=OWNER]
17 [--install-schema-file=FILENAME] [--config-source=SOURCE] [--direct]
18 [--makefile-install-rule] [--makefile-uninstall-rule] [--break-key]
19 [--break-directory] [--short-docs] [--long-docs] [--get-schema-name]
20 [--apply-schema] [--unapply-schema] [--get-default-source] [-v|--ver‐
21 sion]
22
24 Each preference in the GConf repository is expressed as a key-value
25 pair. A GConf preference key is an element in the GConf repository that
26 corresponds to an application preference. Preference keys typically
27 have simple values such as strings, integers, or lists of strings and
28 integers. The default key-value pairs are installed on the system, and
29 are known as schemas. gconftool-2 is the command-line interface tool
30 that enables you to set the values of keys, display the values of keys,
31 and install schemas from schema definition files when you install an
32 application. The GConf preference keys are stored and managed by the
33 GConf daemon (gconfd-2). These keys are cached in memory, and saved to
34 disk in XML format when appropriate.
35
37 -s, --set
38 Set a key to a value and sync. Use with --type.
39 -g, --get
41 Print the value of a key to standard output.
42 -u, --unset
44 Unset the keys on the command line.
45 --recursive-unset
47 Recursively unset all keys at or below the key/directory names
48 on the command line.
49 -a, --all-entries
51 Print all key/value pairs in a directory.
52 --all-dirs
54 Print all subdirectories in a directory.
55 -R, --recursive-list
57 Print all subdirectories and entries under a dir, recursively.
58 --dir-exists=STRING
60 Return 0 if the directory exists, 2 if it does not.
61 -t, --type=int|bool|float|string|list|pair
63 Specify the type of the value being set, or the type of the
64 value a schema describes. Unique abbreviations are allowed.
65 --list-type=int|bool|float|string
67 Specify the type of the list value being set, or the type of the
68 value a schema describes. Unique abbreviations are allowed.
69 --car-type=int|bool|float|string
71 Specify the type of the car pair value being set, or the type of
72 the value a schema describes. Unique abbreviations are allowed.
73 --cdr-type=int|bool|float|string
75 Specify the type of the cdr pair value being set, or the type of
76 the value a schema describes. Unique abbreviations are allowed.
77 --short-desc=DESCRIPTION
79 Specify a short half-line description to go in a schema.
80 --long-desc=DESCRIPTION
82 Specify a several-line description to go in a schema.
83 --owner=OWNER
85 Specify the owner of a schema.
86 --install-schema-file=FILENAME
88 Specify a schema file to be installed
89 --config-source=SOURCE
91 Specify a configuration source to use rather than the default
92 path
93 --direct
95 Access the config database directly, bypassing server. Requires
96 that gconfd is not running.
97 --set-schema
99 Set a schema and sync. Use with --short-desc, --long-desc,
100 --owner, and --type.
101 --makefile-install-rule
103 Properly installs schema files on the command line into the
104 database. GCONF_CONFIG_SOURCE environment variable should be set
105 to a non-default config source or set to the empty string to use
106 the default.
107 --break-key
109 Torture-test an application by setting and unsetting a bunch of
110 values of different types for keys on the command line.
111 --break-directory
113 Torture-test an application by setting and unsetting a bunch of
114 keys inside the directories on the command line.
115 --short-docs
117 Get the short doc string for a key
118 --long-docs
120 Get the long doc string for a key
121 --get-schema-name
123 Get the name of the schema applied to this key
124 --apply-schema
126 Specify the schema name followed by the key to apply the schema
127 name to
128 --unapply-schema
130 Remove any schema name applied to the given keys
131 --get-default-source
133 Get the name of the default source.
134 --shutdown
136 Shut down gconfd. Don't use this option without good reason.
137 -p, --ping
139 Return 0 if gconfd is running, 2 if not.
140 --spawn
142 Launch the config server (gconfd). (Normally happens automati‐
143 cally when needed.)
144 -v, --version
146 Print version
147 Help options
149 -?, --help
151 Show the help message.
152
154 Display the path to the current desktop wallpaper.
155 gconftool-2 --get /desktop/gnome/background/picture_filename
157 Change the widget font to "Serif 12"
159 gconftool-2 --type string --set /desktop/gnome/inter‐
161 face/font_name "Serif 12"
162
164 GConf was written by Havoc Pennington <hp@redhat.com>.
165
167 The GConf web site, http://www.gnome.org/projects/gconf/.
168gconftool-2 2.2.1 February 2006 GCONFTOOL-2(1)