GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GCONFTOOL-2 (1)

NAME

gconftool-2 - GNOME configuration tool

CONTENTS

Synopsis
Description
Options
Examples
Author

SYNOPSIS

gconftool-2 [-?] [-?|--help] [--usage] [-s|--set] [-g|--get] [--set-schema] [-u|--unset] [--recursive-unset] [-a|--all-entries] [--all-dirs] [--dump] [--load=STRING] [-R|--recursive-list] [--dir-exists=STRING] [--shutdown] [-p|--ping] [--spawn] [-t|--type int|bool|float|string|list|pair] [-T|--get-type] [--get-list-size] [--get-list-element] [--list-type=int|bool|float|string] [--car-type=int|bool|float|string] [--cdr-type=int|bool|float|string] [--short-desc=DESCRIPTION] [--long-desc=DESCRIPTION] [--owner=OWNER] [--install-schema-file=FILENAME] [--config-source=SOURCE] [--direct] [--makefile-install-rule] [--makefile-uninstall-rule] [--break-key] [--break-directory] [--short-docs] [--long-docs] [--get-schema-name] [--apply-schema] [--unapply-schema] [--get-default-source] [-v|--version]

DESCRIPTION

Each preference in the GConf repository is expressed as a key-value pair. A GConf preference key is an element in the GConf repository that corresponds to an application preference. Preference keys typically have simple values such as strings, integers, or lists of strings and integers. The default key-value pairs are installed on the system, and are known as schemas. gconftool-2 is the command-line interface tool that enables you to set the values of keys, display the values of keys, and install schemas from schema definition files when you install an application. The GConf preference keys are stored and managed by the GConf daemon (gconfd-2). These keys are cached in memory, and saved to disk in XML format when appropriate.

OPTIONS

-s, --set Set a key to a value and sync. Use with --type.
-g, --get Print the value of a key to standard output.
-u, --unset
  Unset the keys on the command line.
--recursive-unset
  Recursively unset all keys at or below the key/directory names on the command line.
-a, --all-entries
  Print all key/value pairs in a directory.
--all-dirs
  Print all subdirectories in a directory.
-R, --recursive-list
  Print all subdirectories and entries under a dir, recursively.
--dir-exists=STRING
  Return 0 if the directory exists, 2 if it does not.
-t, --type=int|bool|float|string|list|pair
  Specify the type of the value being set, or the type of the value a schema describes. Unique abbreviations are allowed.
--list-type=int|bool|float|string
  Specify the type of the list value being set, or the type of the value a schema describes. Unique abbreviations are allowed.
--car-type=int|bool|float|string
  Specify the type of the car pair value being set, or the type of the value a schema describes. Unique abbreviations are allowed.
--cdr-type=int|bool|float|string
  Specify the type of the cdr pair value being set, or the type of the value a schema describes. Unique abbreviations are allowed.
--short-desc=DESCRIPTION
  Specify a short half-line description to go in a schema.
--long-desc=DESCRIPTION
  Specify a several-line description to go in a schema.
--owner=OWNER
  Specify the owner of a schema.
--install-schema-file=FILENAME
  Specify a schema file to be installed
--config-source=SOURCE
  Specify a configuration source to use rather than the default path
--direct
  Access the config database directly, bypassing server. Requires that gconfd is not running.
--set-schema
  Set a schema and sync. Use with --short-desc, --long-desc, --owner, and --type.
--makefile-install-rule
  Properly installs schema files on the command line into the database. GCONF_CONFIG_SOURCE environment variable should be set to a non-default config source or set to the empty string to use the default.
--break-key
  Torture-test an application by setting and unsetting a bunch of values of different types for keys on the command line.
--break-directory
  Torture-test an application by setting and unsetting a bunch of keys inside the directories on the command line.
--short-docs
  Get the short doc string for a key
--long-docs
  Get the long doc string for a key
--get-schema-name
  Get the name of the schema applied to this key
--apply-schema
  Specify the schema name followed by the key to apply the schema name to
--unapply-schema
  Remove any schema name applied to the given keys
--get-default-source
  Get the name of the default source.
--shutdown
  Shut down gconfd. Don’t use this option without good reason.
-p, --ping Return 0 if gconfd is running, 2 if not.
--spawn Launch the config server (gconfd). (Normally happens automatically when needed.)
-v, --version
  Print version
Help options
-?, --help
  Show the help message.

EXAMPLES

Display the path to the current desktop wallpaper.
gconftool-2 --get /desktop/gnome/background/picture_filename
Change the widget font to "Serif 12"
gconftool-2 --type string --set /desktop/gnome/interface/font_name "Serif 12"

AUTHOR

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

SEE ALSO

The GConf web site, http://www.gnome.org/projects/gconf/.
Search for    or go to Top of page |  Section 1 |  Main Index


gconftool-2 2.2.1 GCONFTOOL-2 (1) February 2006

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.