1GCONFTOOL-2(1)                   User Commands                  GCONFTOOL-2(1)
2
3
4

NAME

6       gconftool-2 - GNOME configuration tool
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

37       -s, --set
38              Set a key to a value and sync. Use with --type.
39
40       -g, --get
41              Print the value of a key to standard output.
42
43       -u, --unset
44              Unset the keys on the command line.
45
46       --recursive-unset
47              Recursively  unset  all keys at or below the key/directory names
48              on the command line.
49
50       -a, --all-entries
51              Print all key/value pairs in a directory.
52
53       --all-dirs
54              Print all subdirectories in a directory.
55
56       -R, --recursive-list
57              Print all subdirectories and entries under a dir, recursively.
58
59       --dir-exists=STRING
60              Return 0 if the directory exists, 2 if it does not.
61
62       -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
66       --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
70       --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
74       --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
78       --short-desc=DESCRIPTION
79              Specify a short half-line description to go in a schema.
80
81       --long-desc=DESCRIPTION
82              Specify a several-line description to go in a schema.
83
84       --owner=OWNER
85              Specify the owner of a schema.
86
87       --install-schema-file=FILENAME
88              Specify a schema file to be installed
89
90       --config-source=SOURCE
91              Specify a configuration source to use rather  than  the  default
92              path
93
94       --direct
95              Access  the config database directly, bypassing server. Requires
96              that gconfd is not running.
97
98       --set-schema
99              Set a schema  and  sync.  Use  with  --short-desc,  --long-desc,
100              --owner, and --type.
101
102       --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
108       --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
112       --break-directory
113              Torture-test  an application by setting and unsetting a bunch of
114              keys inside the directories on the command line.
115
116       --short-docs
117              Get the short doc string for a key
118
119       --long-docs
120              Get the long doc string for a key
121
122       --get-schema-name
123              Get the name of the schema applied to this key
124
125       --apply-schema
126              Specify the schema name followed by the key to apply the  schema
127              name to
128
129       --unapply-schema
130              Remove any schema name applied to the given keys
131
132       --get-default-source
133              Get the name of the default source.
134
135       --shutdown
136              Shut down gconfd. Don't use this option without good reason.
137
138       -p, --ping
139              Return 0 if gconfd is running, 2 if not.
140
141       --spawn
142              Launch  the  config server (gconfd). (Normally happens automati‐
143              cally when needed.)
144
145       -v, --version
146              Print version
147
148       Help options
149
150       -?, --help
151              Show the help message.
152

EXAMPLES

154       Display the path to the current desktop wallpaper.
155
156              gconftool-2 --get /desktop/gnome/background/picture_filename
157
158       Change the widget font to "Serif 12"
159
160              gconftool-2   --type    string    --set    /desktop/gnome/inter‐
161              face/font_name "Serif 12"
162

AUTHOR

164       GConf was written by Havoc Pennington <hp@redhat.com>.
165

SEE ALSO

167       The GConf web site, http://www.gnome.org/projects/gconf/.
168
169
170
171gconftool-2 2.2.1                February 2006                  GCONFTOOL-2(1)
Impressum