Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 10, 2021

gsettings-data-convert (1)


gsettings-data-convert - GConf to GSettings data migration


gsettings-data-convert [option...]


GSETTINGS-DATA-CON(1)            User Commands           GSETTINGS-DATA-CON(1)

       gsettings-data-convert - GConf to GSettings data migration

       gsettings-data-convert [option...]

       gsettings-data-convert reads values out of the users GConf database and
       stores them in GSettings.

       The information about the mapping from GConf keys to GSettings keys is
       taken from files in /usr/share/GConf/gsettings. Each file in that
       directory is read as a key file, with sections for each GSettings
       schema that is being converted. The entries in each section map
       GSettings keys to paths in the GConf database. Currently,
       gsettings-data-convert supports all basic GConf types as well as lists
       of strings and lists of integers.

       A simple example might look like this:

           antialiasing = /desktop/gnome/font_rendering/antialiasing
           dpi = /desktop/gnome/font_rendering/dpi
           hinting = /desktop/gnome/font_rendering/hinting
           rgba_order = /desktop/gnome/font_rendering/rgba_order

       If the GSettings schema does not have a fixed path, you must specify
       the path in the group name, separated by a colon character:


       gsettings-data-convert keeps a list of the key files it has already
       converted, so it is safe to run it repeatedly to handle newly appeared
       key files. The expected use of this utility is to make each application
       install a key file for the GConf keys that it wants to be migrated, and
       run gsettings-data-convert every time a user logs in.

       -h, --help
           Print help and exit

           Do not make any changes, just report what would be done

           Show verbose messages

       See attributes(7) for descriptions of the following attributes:

       |ATTRIBUTE TYPE |        ATTRIBUTE VALUE         |
       |Availability   | gnome/config/gconf             |
       |Stability      | Obsolete pass-through volatile |
       gsettings-schema-convert(1) is a related command that helps with the
       conversion of schemas from GConf to GSettings.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from

       Further information about this software can be found on the open source
       community website at https://projects.gnome.org/gconf/.

User Commands                     01/21/2013             GSETTINGS-DATA-CON(1)