Working With the GConf Command-Line Tool
GConf includes a command-line tool, gconftool-2.
You can use the gconftool-2 command to perform
the following tasks:
Set the values of keys
Display the values of keys
Install schemas from schema definition files when
you install an application
For example, you
would use the following command to display the values
of all keys in the /desktop/gnome directory and
subdirectories.
# gconftool-2 --recursive-list /desktop/gnome
The following table describes some of the options that you can
use with the gconftool-2 command. For detailed
command-line options, see the gconftool-2(1) man page.
Table 2-1 gconftool-2 Command-Line
Options | |
|---|
--all-dirs
| Lists all subdirectories in the specified directory.
|
--all-entries
| Displays the values of all keys in the specified directory.
|
--config-source=configuration-source
| Use this option with the --direct option
to specify a configuration source to use. Note - 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. Note - 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 the specified
GConf repository directory. 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 the specified preference key. Also displays the
values of the elements in the schema object for the specified schema
key.
|
--help
| Displays a help message about the gconftool-2 command,
and the options that you can use with the gconftool-2 command.
|
--load=filename
| Set
s the values of preference keys
in the current directory in a configuration source to the
values in a specified
file. 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 the specified directory.
|
--recursive-unset
| Resets the values of all preference keys in all subdirectories
in a directory
to the settings 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 valid
data types are
: 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.
|
|
Note - In a multiuser environment, you can set up a server such
that the server provides desktop environments to multiple clients,
such as Sun Ray clients or VNC viewers. The desktop environment provided
to clients can be optimized for better performance and usability.
The optimizations for the desktop environment are available
in the group/feature/multi-user-desktop image
packaging system (IPS) package. You must install this IPS package
on the server to enable optimizations for the desktop. For detailed
information, see Optimizing the Oracle Solaris Desktop for a Multi-User Environment
.