Havoc Pennington

Red Hat Advanced Development Labs

This document may be distributed subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/ )

Abstract

GConf is a system for storing configuration information, that is, key-value pairs. GConf provides a notification service so applications can be notified when a key's value is changed. GConf also allows for pluggable storage mechanisms (text files, databases, etc.); allows administrators to install default values; and allows application authors to document their configuration keys for the benefit of administrators.


Table of Contents

Introduction to GConf
Motivation
Terms and Concepts
Namespace
GConf Data Types
Configuration Sources
Schemas
C Language Client Library
Error Handling
The GConfEngine object
The GConfValue Datatype
Accessing GConfValue
Creating/destroying a GConfValue
Reading/Writing Configuration Values
Reading
Writing
GConfClient higher-level API
A Complete Example
GConf Conventions
Namespace division
gconftool Utility Program
Schema Files
Schema File Format
Installing Schemas
Schema File DTD
Checklist/Summary
GConf Reference Documentation
GObject Wrapper Reference (GConfClient)
GConf Internal Reference