Outil en ligne de commande GConf

GConf contient un outil en ligne de commande, gconftool-2. Cette commande permet d'effectuer les tâches suivantes :

  • Définir des valeurs de clés.
  • Afficher des valeurs de clés.
  • Installer des schémas à partir de fichiers de définition de schémas lors de l'installation d'une application.

Par exemple, la commande ci-après affiche les valeurs de toutes les clés du répertoire et des sous-répertoires de /desktop/gnome.

gconftool-2 --recursive-list /desktop/gnome

Vous trouverez ci-dessous quelques options utilisables avec la commande gconftool-2. Pour plus de détails sur les options de ligne de commande, veuillez consulter man:gconftool-2(1).

Options de la commande gconftool-2
--all-dirs

Énumère tous les sous-répertoires d'un répertoire spécifié.

--all-entries

Affiche les valeurs de toutes les clés d'un répertoire spécifié.

--config-source=source-de-configuration

Utilisez cette option avec l'option --direct pour spécifier l'utilisation d'une source de configuration. Sans indication de source de configuration, cette commande traite toutes les sources de configuration du fichier des chemins.

--direct

Utilisez cette option avec l'option --config-source pour accéder directement à une source de configuration. Avec cette option, GConf court-circuite le serveur. Assurez-vous préalablement que le démon GConf, gconfd-2, n'est pas en cours de fonctionnement.

--dump

Génère une liste contenant toutes les clés de préférences dans un répertoire spécifié du référentiel GConf. La liste contient des descriptions XML de toutes les clés. Elle est contenue dans un élément <gconfentryfile>.

Par exemple, vous pouvez rediriger la sortie de cette option pour produire un fichier énumérant toutes les clés en liaison avec la configuration des tableaux de bord. Vous pouvez ensuite utiliser l'option --load avec ce fichier.

--get

Affiche la valeur de la clé de préférence spécifiée. Affiche également les valeurs des éléments de l'objet de schéma de la clé de schéma spécifiée.

--help

Affiche un message d'aide sur la commande gconftool-2 et ses options.

--load=nom_de_fichier

Cette option permet de définir les valeurs des clés de préférences dans le répertoire courant d'une source de configuration à partir des valeurs contenues dans le fichier spécifié. Ce fichier doit contenir des descriptions XML des clés, dans un élément <gconfentryfile>.

--long-desc=description

Cette option peut être utilisée avec l'option --set-schema pour attribuer une longue description à une clé de schéma.

--makefile-install-rule

Installe des fichiers de définition de schémas pour des applications.

--owner=propriétaire

Cette option peut être utilisée avec l'option --set-schema pour spécifier un propriétaire pour la clé de schéma.

--recursive-list

Affiche les valeurs de toutes les clés de préférences dans tous les sous-répertoires d'un répertoire spécifié.

--recursive-unset

Réinitialise les valeurs de toutes les clés de préférences aux réglages par défaut de la source de configuration, dans tous les sous-répertoires d'un répertoire.

--set

Définit la valeur d'une clé de préférence et écrit la valeur dans la source de configuration de l'utilisateur. Combinée avec l'option --type, cette option permet de spécifier le type de donnée de la valeur à définir. Par exemple, la commande ci-après définit la valeur de la clé /apps/gnome-terminal/profiles/Default/background_color dans la source de configuration de l'utilisateur :

gconftool-2 \
  --set "/apps/gnome-terminal/profiles/Default/background_color" \
  --type string "#000000"

Vous pouvez également combiner cette option avec les options --direct et --config-source pour écrire une valeur dans une autre source de configuration.

--set-schema

Définit la valeur d'un attribut dans une clé de schéma et écrit la valeur dans la source de configuration par défaut.

Utilisez les options suivantes avec l'option --set-schema pour spécifier l'attribut à mettre à jour :

  • --type
  • --short-desc
  • --long-desc
  • --owner

Par exemple, la commande ci-après définit la description courte de la clé de schéma pour la clé /apps/gnome-terminal/profiles/Default/background_color :

gconftool-2 \
  --set-schema  "/schemas/apps/gnome-terminal/profiles/Default/background_color" \
  --short-desc "Couleur d'arrière-plan par défaut du terminal"
--short-desc=description

Utilisez cette option avec l'option --set-schema pour spécifier une courte description d'une clé de schéma.

--shutdown

Arrête le démon GConf.

--type=type_de_donnée

Utilisez cette option pour spécifier le type de donnée au moment de définir une valeur d'une clé de préférence. Cette option est aussi valable lors de la définition d'une valeur d'un attribut d'une clé de schéma. Voici une liste de types de donnée valides :

  • bool
  • float
  • int
  • list
  • pair
  • string
--unset

Réinitialise la valeur d'une clé de préférence au réglage de la source de configuration par défaut.

--usage

Affiche un court message d'aide à propos de la commande gconftool-2 et de ses options.