packages icon



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

                                Feburary 2006



 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|--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 prefer-ence.  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



                                    - 1 -      Formatted:  December 19, 2018






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

                                Feburary 2006



           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



                                    - 2 -      Formatted:  December 19, 2018






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

                                Feburary 2006



           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.



                                    - 3 -      Formatted:  December 19, 2018






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

                                Feburary 2006



      --usage
           Display brief usage 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/.


































                                    - 4 -      Formatted:  December 19, 2018