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:
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 |
Sets 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.
