Provided by: dctrl-tools_2.24-3build3_amd64 
NOM
join-dctrl - Réaliser des jointures relationnelles de données au format dctrl
SYNOPSIS
join-dctrl [ options ] fichier fichier
join-dctrl --version
join-dctrl --help
DESCRIPTION
join-dctrl réalise une opération de jointure relationnelle sur des données au format de fichiers de
contrôle Debian.
Un champ de jointure doit être indiqué en utilisant soit les options -1 et -2, soit l'option -j.
Conceptuellement, le programme crée toutes les paires ordonnées d'enregistrement qui peuvent être formées
en ayant un enregistrement du premier fichier comme premier membre de la paire et un enregistrement du
second fichier comme second membre de la paire ; puis il supprime toutes les paires où les champs de
jointure ne sont pas égaux. En réalité, tous les fichiers d'entrée sont traités comme des tables de base
de données relationnelle.
Tous les fichiers d'entrée doivent être dans l'ordre croissant de leur champ de jointure ; cela permet au
programme de fonctionner plus rapidement. Le programme sort-dctrl(1) peut être utilisé pour ce faire.
OPTIONS
-1 champ, --1st-join-field=champ
Indiquer le champ de jointure du premier fichier d'entrée.
-2 champ, --2nd-join-field=champ
Indiquer le champ de jointure du second fichier d'entrée.
-j champ, --join-field=champ
Indiquer un champ de jointure commun pour tous les fichiers.
-a nofichier, --unpairable-from=nofichier
Indiquer que les paragraphes non correspondants du premier (si 1 est donné) ou du second (si 2 est
donné) fichier doivent être affichés.
-o specchamp, --output-fields=specchamp
Indiquer quels champs sont inclus dans la sortie. Les champs sont séparés par des virgules (plus
d'une option -o peut aussi être utilisée). Chaque champ est indiqué au format nofichier.champ dans
lequel nofichier est le numéro du fichier d'entrée duquel le champ est tiré (soit 1 soit 2), et
champ donne le nom du champ à utiliser. En particulier, un simple 0 peut être utilisé à la place
de nofichier.champ pour faire référence à la valeur commune des champs de jointure.
Le nom du champ (numéro de fichier non compris) est utilisé dans la sortie comme nom du champ.
Cependant, un nom différent spécifique à la sortie peut être indiqué en ajoutant après
l'indication du champ un deux-points suivi du nom choisi pour l'affichage.
Par exemple, l'option -o 0,1.Version:Ancienne-Version,2.Version indique que le premier champ de
n'importe quel enregistrement en sortie devrait être le champ de jointure, le deuxième champ
devrait être Ancienne-Version dont les données sont tirées du champ Version du premier fichier
d'entrée, et le troisième champ devrait être le champ Version dont les données sont tirées du
champ de même nom dans le second fichier d'entrée, et ce sont les seuls champs affichés en sortie.
Si aucune option -o n'est donnée, tous les champs de tous les enregistrements joints sont inclus
dans la sortie.
-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
join-dctrl traitera chaque fichier nommé sur la ligne de commande comme une table de base de données
relationnelle. Un fichier appelé - représente le flux d'entrée standard du programme. Actuellement,
exactement deux fichiers doivent être nommés.
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 join-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).
Chaque fichier d'entrée doit être dans l'ordre croissant de son champ de jointure.
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 au format d'un fichier de
contrôle Debian, précédemment décrit dans la section FICHIERS D'ENTRÉE. La sortie sera dans l'ordre
croissant de son champ de jointure, si ce champ est inclus dans la sortie.
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
Soit un fichier contenant des données de paquets binaires pour l'architecture AMD64 de la publication
Squeeze de Debian (6.0), section main, nommé Packages dans le répertoire actuel. Supposons que les
commandes sont exécutées sur un système Debian. Supposons de plus qu'aucun fichier stat ni pkg n'est déjà
présent dans le répertoire actuel. Les commandes suivantes donnent, pour chaque paquet actuellement
installé et disponible dans Debian Squeeze (6.0), la version actuellement installée (en tant
qu'Ancienne-Version) et la version de Squeeze (en tant que Nouvelle-Version) :
$ sort-dctrl -kPackage /var/lib/dpkg/status > stat
$ sort-dctrl -kPackage Packages > pkg
$ join-dctrl -j Package \
-o 0,1.Version:Ancienne-Version,2.Version:Nouvelle-Version \
stat pkg
AUTEUR
Le programme join-dctrl et cette page de manuel ont été écrits par Antti-Juhani Kaijanaho.
VOIR AUSSI
grep-dctrl(1), sort-dctrl(1), tbl-dctrl(1)
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 ».
join-dctrl(1)