SYNOPSIS

tbl-dctrl [ options ] [ -c colonne ... ] [ fichier ] ...

tbl-dctrl --version

tbl-dctrl --help

DESCRIPTION

tbl-dctrl crée des tableaux à partir de données exprimées au format de fichiers de contrôle Debian.

Par défaut, tbl-dctrl lit l'ensemble de la base de données, à la recherche de la plus longue entrée de chaque colonne indiquée. Il affiche ensuite le tableau, avec des cadres et des titres de colonne, où chaque colonne est juste assez large pour afficher la plus longue entrée. Ce comportement peut être personnalisé conformément aux descriptions suivantes.

Une colonne est demandée en indiquant l'option -c (--column) suivie d'une spécification de colonne. Le nom d'un champ est la spécification de colonne la plus simple. Dans ce cas, tbl-dctrl inclura dans la sortie une colonne dont le titre est le nom de colonne indiqué et dont les données sont tirées des champs de ce nom. En absence d'option -c, tbl-dctrl utilisera tous les champs en entrée dans l'ordre où ils sont apparus pour la première fois.

Deux ajouts facultatifs peuvent être faits à une spécification de colonne. Précéder le nom de champ avec du texte suivi d'un signe égal (par exemple -c 'Nom de paquet=Package') modifie la colonne pour que le texte précédant le signe égal soit utilisé en titre de colonne, alors que le texte qui le suit est utilisé comme nom de champ à partir duquel les données sont tirées. Un deux-points suivi d'un entier positif peut être ajouté au nom de champ. Dans ce cas, le nombre qui suit le deux-points indique la largeur de la colonne. Ces deux ajouts peuvent être utilisés séparément ou ensemble. S'il y a plus d'un deux-point, seul le dernier est pris en compte. S'il y a plus d'un signe égal, seul le premier est pris en compte. Les autres deux-points et signes égal sont simplement utilisés comme des données. Remarquez que la totalité de la spécification de colonne doit être donnée à tbl-dctrl comme un argument, donc si elle contient des espaces, il faut les protéger pour l'interpréteur.

Si toutes les colonnes demandées ont une largeur indiquée, tbl-dctrl affichera le résultat directement, sans attendre d'avoir lu toute l'entrée.

OPTIONS

-d délimiteur, --delimiter=délimiteur

Au lieu de dessiner de jolis cadres pour le tableau, utiliser le délimiteur indiqué pour séparer les colonnes sur chaque ligne.

-H, --no-heading

Ne pas afficher d'en-tête (titres de colonne).

-l niveau, --errorlevel=niveau

Configurer le niveau de journalisation, où niveau est fatal, important, informational ou debug. La disponibilité de debug depend des options de compilation. Ces catégories sont ici données dans l'ordre : tous les messages émis lorsque fatal est choisi seront affichés pour un niveau d'erreur important, etc. Par défaut, important est sélectionné.

-V, --version

Afficher les informations de version.

-C, --copying

Afficher la licence. La sortie est particulièrement longue, veuillez la rediriger quelque part, ou utiliser un tube (vers votre afficheur de texte préféré par exemple).

-h, --help

Afficher une courte aide.

OPÉRANDES

tbl-dctrl lira son entrée à partir des fichiers nommés sur la ligne de commande, dans l'ordre indiqué. Un fichier appelé - représente le flux d'entrée standard du programme. Si aucun fichier n'est indiqué, le programme se comporte comme si seul - avait été nommé, c'est-à-dire que l'entrée est lue depuis le flux d'entrée standard.

STDIN

Le flux d'entrée standard peut être utilisé comme entrée du programme conformément à l'indication précédente dans la section OPÉRANDES.

FICHIERS D'ENTRÉE

Toutes les entrées de tbl-dctrl sont au format d'un fichier de contrôle Debian.

Un fichier de contrôle Debian (dctrl) est une base de données semi-structurée avec une seule table conservée dans un fichier texte analysable par une machine. Une telle base est constituée d'un ensemble d'enregistrements ; chaque enregistrement est une association de noms de champ et de contenus de champ. Le fichier texte présente les enregistrements séparés par des lignes vides, tandis que chaque champ est constitué d'une ou plusieurs lignes non vides à l'intérieur d'un enregistrement. Un champ commence par son nom, suivi d'un deux-points, suivi par le contenu du champ. Les deux-points doivent rester sur la première ligne du champ, et la première ligne ne doit pas commencer par un espace. Les lignes suivantes, au contraire, doivent commencer par un espace (un ou plusieurs caractères espace ou tabulation).

Quand l'entrée est lue depuis plusieurs fichiers, un séparateur est implicite entre deux fichiers adjacents.

VARIABLES D'ENVIRONNEMENT

Les paramètres régionaux de l'environnement, en particulier la configuration du jeu de caractères, a une incidence sur l'interprétation des flux de caractères en entrée et en sortie.

ÉVÉNEMENTS ASYNCHRONES

Les signaux UNIX normalisés ont leur signification habituelle.

STDOUT

Toute la sortie est envoyée sur le flux de sortie standard. La sortie est un tableau qui représente la base de données en entrée limitée aux champs indiqués. Lorsque l'option -d est utilisée, le tableau est simplement représenté en séparant les colonnes de chaque ligne par le délimiteur indiqué, sinon, un cadre est dessiné autour du tableau. L'ordre des colonnes est le même que l'ordre des spécifications de colonne sur la ligne de commande.

FICHIERS DE SORTIE

Il n'y a aucun fichier de sortie.

CODE DE RETOUR

Cet utilitaire renvoie 0 lors d'une exécution réussie. Un code de retour non nul incohérent est renvoyé si une erreur est détectée (c'est un bogue).

EXEMPLES

La commande suivante renvoie le tableau de tous les paquets sans contenu, avec leur responsable, ordonnés par responsable.

% grep-available -FInstalled-Size --eq 0 | sort-dctrl -kMaintainer - \
  | tbl-dctrl -cPackage -cMaintainer

AUTEUR

Le programme tbl-dctrl et cette page de manuel ont été écrits par Antti-Juhani Kaijanaho.

TRADUCTION

Cette traduction est maintenue à l'aide de l'outil po4a <URL:http://po4a.alioth.debian.org/> par l'équipe francophone de traduction de Debian.

Elle est maintenue par David Prévot [email protected] et les membres de la liste [email protected] depuis mars 2011.

Veuillez signaler toute erreur de traduction en écrivant à [email protected] ou par un rapport de bogue sur le paquet dctrl-tools.

Vous pouvez toujours accéder à la version anglaise de ce document en utilisant la commande « man -L C section page_de_man ».