gconftool-2 man page on ElementaryOS

Man page or keyword search:  
man Server   4994 pages
apropos Keyword Search (all sections)
Output format
ElementaryOS logo
[printable version]

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

NAME
       gconftool-2 - GNOME configuration tool

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|--ver‐
       sion]

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 automati‐
	      cally 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/inter‐
	      face/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/.

gconftool-2 2.2.1		 February 2006			GCONFTOOL-2(1)
[top]

List of man pages available for ElementaryOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net