-
--all-dirs
Lists all subdirectories in a
directory that you specify.
-
--all-entries
Displays the values of all keys
in a directory that you specify.
-
--config-source=configuration-source
Use this option with the --direct option
to specify a configuration source to use. If you do not specify a configuration
source with this option, the command runs on all configuration sources in
the path file.
-
--direct
Use this option with the --config-source option to access a configuration source directly.
When you use this option, GConf bypasses the server.
Ensure that the GConf daemon, gconfd-2, is not running before you use this option.
-
--dump
-
Generates a list that contains all preference
keys in a GConf repository directory that you specify.
The list contains XML descriptions of all the keys. The list is contained
in a <gconfentryfile> element.
For example,
you can redirect the output from this option to generate a file that lists
all keys that are related to your panel configuration. You can use the --load option with this file.
-
--get
Displays the value of a preference key that you specify.
Also displays the values of the elements in the schema object for a schema
key that you specify.
-
--help
Displays a help message about the gconftool-2 command, and the options that you can use with the gconftool-2 command.
-
--load=filename
Use this option to sets the values of preference keys in the current directory
in a configuration source to the values in the file that you specify. The
file that you specify must contain XML descriptions of the keys, in a <gconfentryfile> element.
-
--long-desc=description
Use this option with the --set-schema
option to specify a long description for a schema key.
-
--makefile-install-rule
Installs schema definition files to applications.
-
--owner=owner
Use this option with the --set-schema option to specify
an owner for a schema key.
-
--recursive-list
Displays the values of all preference keys in all
subdirectories in a directory that you specify.
-
--recursive-unset
Resets
the values of all preference keys, in all subdirectories in a directory, from
the user setting to the setting in the default configuration source.
-
--set
-
Sets the value of a preference key, and writes the value
to the user configuration source. Use the --type option
with the --set option to specify the data type of the value
that you want to set. For example, the following command sets the value of
the /apps/gnome-terminal/profiles/Default/background_color
key in the user configuration source:
gconftool-2 \
--set "/apps/gnome-terminal/profiles/Default/background_color" \
--type string "#000000"
You can also use the --direct option and the --config-source option
with the --set option to write a value to another configuration
source.
-
--set-schema
-
Sets the value of an attribute
in a schema key, and writes the value to the default configuration source.
Use the following options with the --set-schema
option to specify the attribute that you want to update:
--type
--short-desc
--long-desc
--owner
For example, the following command sets the short description
in the schema key for the /apps/gnome-terminal/profiles/Default/background_color key:
gconftool-2 \
--set-schema "/schemas/apps/gnome-terminal/profiles/Default/background_color" \
--short-desc "Default background color of terminal"
-
--short-desc=description
Use this option with the --set-schema
option to specify a short description for a schema key.
-
--shutdown
Terminates the GConf daemon.
-
--type=data-type
-
Use this option to specify the data type when you set a
value of a preference key. You can also use this option when you set the value
of an attribute in a schema key. The following is a list of valid data types:
bool
float
int
list
pair
string
-
--unset
Resets the value of a preference
key from the user setting to the setting in the default configuration source.
-
--usage
Displays a brief help message
about the gconftool-2 command, and the options that you
can use with the gconftool-2 command.
