confmodule(3) Communiquer avec l'interface de configuration système Debian

SYNOPSIS


  #!/bin/sh -e
  . /usr/share/debconf/confmodule
  db_version 2.0
  db_capb 'backup'
  CAPB=$RET
  db_input 'toto/titi' || true
  db_go || true

DESCRIPTION

C'est une bibliothèque de fonctions shell qui facilite la communication avec le gestionnaire de configuration système Debian. Elle peut communiquer avec une interface via le protocole debconf. Chaque commande du protocole est représentée par une fonction de cette bibliothèque. Le nom de la fonction est le même que celui de la commande, excepté qu'il est préfixé avec « db_ » et est en minuscules. Appelez la fonction et transmettez-lui les paramètres que vous voulez pour la commande. Un code de retour textuel de l'interface vous sera renvoyé dans la variable $RET, et le code de retour numérique de l'interface sera renvoyé comme code de retour (ces codes de retour doivent être pris en compte ou ignorés).

NOTES

Une fois cette bibliothèque chargée, tout texte émis par la suite le sera sur la sortie d'erreur standard, plutôt que sur la sortie standard. C'est une bonne chose en général, car le texte envoyé à la sortie standard est interprété par l'interface comme une commande. Si vous voulez envoyer une commande directement à l'interface, vous devez l'envoyer vers le descripteur de fichier 3, comme ceci :
  echo GET toto/titi >&3

La bibliothèque s'assure qu'elle communique réellement avec une interface en examinant la variable DEBIAN_HAS_FRONTEND. Si elle est définie, une interface est supposée être lancée. Sinon, la bibliothèque en devient une et lance une copie du script qui chargea la bibliothèque et se connecta à elle. Cela signifie que si vous chargez cette bibliothèque, vous devez le faire presque au début de votre script, parce que tout ce qui a été fait avant le chargement de la bibliothèque sera peut-être exécuté une fois de plus.

AUTEUR

Joey Hess <[email protected]>

TRADUCTION

Julien Louis <[email protected]>, 2005
Cyril Brulebois <[email protected]>, 2006

Veuillez signaler toute erreur de traduction en écrivant à <[email protected]> ou par un rapport de bogue sur le paquet debconf.