Provided by: dctrl-tools_2.24-3build3_amd64 
NOM
tbl-dctrl - Créer des tableaux de données exprimées au format dctrl
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).
CONSÉQUENCE DES ERREURS
En cas d'erreur en entrée, la sortie sera partiellement ou complètement incorrecte. En cas d'erreur
d'appel, le programme refusera de fonctionner.
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.
VOIR AUSSI
apt-cache(1), ara(1), dpkg-awk(1), dpkg-query(1), grep-dctrl(1), sort-dctrl(1), dpkg(8)
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 david@tilapin.org et les membres de la liste debian-l10n-
french@lists.debian.org depuis mars 2011.
Veuillez signaler toute erreur de traduction en écrivant à debian-l10n-french@lists.debian.org 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 ».
Projet Debian 2 avril 2006 tbl-dctrl(1)