.\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH join\-dctrl 1 .\" Copyright © 2007 Antti-Juhani Kaijanaho .\" This program is free software; you can redistribute it and/or modify .\" it under the terms of the GNU General Public License as published by .\" the Free Software Foundation; either version 2 of the License, or .\" (at your option) any later version. .\" This program is distributed in the hope that it will be useful, .\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" GNU General Public License for more details. .\" You should have received a copy of the GNU General Public License .\" along with this program; see the file COPYING. If not, write to .\" the Free Software Foundation, Inc., 59 Temple Place - Suite 330, .\" Boston, MA 02111-1307, USA. .SH NOM join\-dctrl \- Réaliser des jointures relationnelles de données au format dctrl .SH SYNOPSIS \fBjoin\-dctrl\fP [ \fIoptions\fP ] \fIfichier\fP \fIfichier\fP .sp \fBjoin\-dctrl\fP \fB\-\-version\fP .sp \fBjoin\-dctrl\fP \fB\-\-help\fP .SH DESCRIPTION \fBjoin\-dctrl\fP réalise une opération de jointure relationnelle sur des données au format de fichiers de contrôle Debian. .PP Un \fIchamp de jointure\fP doit être indiqué en utilisant soit les options \fB\-1\fP et \fB\-2\fP, soit l'option \fB\-j\fP. . 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. .PP 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 \fBsort\-dctrl\fP(1) peut être utilisé pour ce faire. .SH OPTIONS .IP "\fB\-1\fP \fIchamp\fP, \fB\-\-1st\-join\-field=\fP\fIchamp\fP" Indiquer le \fIchamp\fP de jointure du premier fichier d'entrée. .IP "\fB\-2\fP \fIchamp\fP, \fB\-\-2nd\-join\-field=\fP\fIchamp\fP" Indiquer le \fIchamp\fP de jointure du second fichier d'entrée. .IP "\fB\-j \fP\fIchamp\fP, \fB\-\-join\-field=\fP\fIchamp\fP" Indiquer un \fIchamp\fP de jointure commun pour tous les fichiers. .IP "\fB\-a \fP\fInofichier\fP, \fB\-\-unpairable\-from=\fP\fInofichier\fP" Indiquer que les paragraphes non correspondants du premier (si \fB1\fP est donné) ou du second (si \fB2\fP est donné) fichier doivent être affichés. .IP "\fB\-o \fP\fIspecchamp\fP, \fB\-\-output\-fields=\fP\fIspecchamp\fP" Indiquer quels champs sont inclus dans la sortie. . Les champs sont séparés par des virgules (plus d'une option \fB\-o\fP peut aussi être utilisée). . Chaque champ est indiqué au format \fInofichier\fP\fB.\fP\fIchamp\fP dans lequel \fInofichier\fP est le numéro du fichier d'entrée duquel le champ est tiré (soit \fB1\fP soit \fB2\fP), et \fIchamp\fP donne le nom du champ à utiliser. . En particulier, un simple \fB0\fP peut être utilisé à la place de \fInofichier\fP\fB.\fP\fIchamp\fP pour faire référence à la valeur commune des champs de jointure. .IP 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. .IP Par exemple, l'option \fB\-o 0,1.Version:Ancienne\-Version,2.Version\fP indique que le premier champ de n'importe quel enregistrement en sortie devrait être le champ de jointure, le deuxième champ devrait être \fBAncienne\-Version\fP dont les données sont tirées du champ \fBVersion\fP du premier fichier d'entrée, et le troisième champ devrait être le champ \fBVersion\fP 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. .IP Si aucune option \fB\-o\fP n'est donnée, tous les champs de tous les enregistrements joints sont inclus dans la sortie. .IP "\fB\-l \fP\fIniveau\fP, \fB\-\-errorlevel=\fP\fIniveau\fP" Configurer le \fIniveau\fP de journalisation, où \fIniveau\fP est \fBfatal\fP, \fBimportant\fP, \fBinformational\fP ou \fBdebug\fP. La disponibilité de \fBdebug\fP depend des options de compilation. Ces catégories sont ici données dans l'ordre\ : tous les messages émis lorsque \fBfatal\fP est choisi seront affichés pour un niveau d'erreur \fBimportant\fP, etc. Par défaut, \fBimportant\fP est sélectionné. .TP \fB\-V\fP, \fB\-\-version\fP Afficher les informations de version. .TP \fB\-C\fP, \fB\-\-copying\fP 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). .TP \fB\-h\fP, \fB\-\-help\fP Afficher une courte aide. .SH OPÉRANDES \fBjoin\-dctrl\fP traitera chaque fichier nommé sur la ligne de commande comme une table de base de données relationnelle. . Un fichier appelé \fB\-\fP représente le flux d'entrée standard du programme. . Actuellement, exactement deux fichiers doivent être nommés. .SH 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 \fBOPÉRANDES\fP. .SH "FICHIERS D'ENTRÉE" Toutes les entrées de \fBjoin\-dctrl\fP sont au format d'un fichier de contrôle Debian. .PP 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). .PP Chaque fichier d'entrée doit être dans l'ordre croissant de son champ de jointure. .SH "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. .SH "ÉVÉNEMENTS ASYNCHRONES" Les signaux UNIX normalisés ont leur signification habituelle. .SH 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 \fBFICHIERS D'ENTRÉE\fP. . La sortie sera dans l'ordre croissant de son champ de jointure, si ce champ est inclus dans la sortie. .SH "FICHIERS DE SORTIE" Il n'y a aucun fichier de sortie. .SH "CODE DE RETOUR" Cet utilitaire renvoie \fB0\fP 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). .SH "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. .SH EXEMPLES Soit un fichier contenant des données de paquets binaires pour l'architecture AMD64 de la publication Squeeze de Debian (6.0), section \fBmain\fP, nommé \fIPackages\fP dans le répertoire actuel. . Supposons que les commandes sont exécutées sur un système Debian. . Supposons de plus qu'aucun fichier \fIstat\fP ni \fIpkg\fP 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'\fBAncienne\-Version\fP) et la version de Squeeze (en tant que \fBNouvelle\-Version\fP)\ : .nf $ sort\-dctrl \-kPackage /var/lib/dpkg/status > stat $ sort\-dctrl \-kPackage Packages > pkg $ join\-dctrl \-j Package \e \-o 0,1.Version:Ancienne\-Version,2.Version:Nouvelle\-Version \e stat pkg .fi .SH AUTEUR Le programme \fBjoin\-dctrl\fP et cette page de manuel ont été écrits par Antti\-Juhani Kaijanaho. .SH "VOIR AUSSI" \fBgrep\-dctrl\fP(1), \fBsort\-dctrl\fP(1), \fBtbl\-dctrl\fP(1) .SH TRADUCTION Cette traduction est maintenue à l'aide de l'outil .B po4a par l'équipe francophone de traduction de Debian. Elle est maintenue par David Prévot .I david@tilapin.org et les membres de la liste .I debian-l10n-french@lists.debian.org depuis mars 2011. Veuillez signaler toute erreur de traduction en écrivant à .I debian-l10n-french@lists.debian.org ou par un rapport de bogue sur le paquet .IR dctrl-tools . Vous pouvez toujours accéder à la version anglaise de ce document en utilisant la commande .RB "« " "man -L C" .IR "section page_de_man" " »."