Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 10, 2021

glib-compile-schemas (1)


glib-compile-schemas - GSettings schema compiler


glib-compile-schemas [OPTION...] {DIRECTORY}


GLIB-COMPILE-SCHEM(1)            User Commands           GLIB-COMPILE-SCHEM(1)

       glib-compile-schemas - GSettings schema compiler

       glib-compile-schemas [OPTION...] {DIRECTORY}

       glib-compile-schemas compiles all the GSettings XML schema files in
       DIRECTORY into a binary file with the name gschemas.compiled that can
       be used by GSettings. The XML schema files must have the filename
       extension .gschema.xml. For a detailed description of the XML file
       format, see the GSettings documentation.

       At runtime, GSettings looks for schemas in the glib-2.0/schemas
       subdirectories of all directories specified in the XDG_DATA_DIRS
       environment variable. The usual location to install schema files is

       In addition to schema files, glib-compile-schemas reads 'vendor
       override' files, which are key files that can override default values
       for keys in the schemas. The group names in the key files are the
       schema id, and the values are written in serialized GVariant form.
       Vendor override files must have the filename extension

       By convention, vendor override files begin with nn_ where nn is a
       number from 00 to 99. Higher numbered files have higher priority (eg:
       if the same override is made in a file numbered 10 and then again in a
       file numbered 20, the override from 20 will take precedence).

       -h, --help
           Print help and exit

           Print program version and exit

           Store gschemas.compiled in the TARGET directory instead of

           Abort on any errors in schemas. Without this option, faulty schema
           files are simply omitted from the resulting compiled schema.

           Don't write gschemas.compiled. This option can be used to check
           .gschema.xml sources for errors.

           Do not enforce restrictions on key names. Note that this option is
           purely to facility the transition from GConf, and will be removed
           at some time in the future.

   SMF Management and IPS Packaging
       In Oracle Solaris, the transient glib-compile-schemas service runs
       glib-compile-schemas when necessary to update the gschemas.compiled
       file with information about the installed GSettings XML schema and
       vendor override files. An example of when the glib-compile-schemas
       service runs is when a package that specifies the
       svc:/application/desktop-cache/glib-compile-schemas service as the
       value of a restart_fmri attribute on is being installed. A package that
       installs a GSettings schema XML file should have such an attribute. See
       the glib-compile-schemas(8s) man page for details about the
       glib-compile-schemas service. See the smf(7) man page for information
       about the Oracle Solaris Service Management Facility.

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

       |Availability   | library/glib2    |
       |Stability      | Uncommitted      |

       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://wiki.gnome.org/Projects/GLib/.

GIO                                                      GLIB-COMPILE-SCHEM(1)