.\"******************************************************************* .\" .\" 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 BEZEICHNUNG join\-dctrl \- stellt eine Beziehungsverknüpfung zu Daten im Dctrl\-Format her .SH ÜBERSICHT \fBjoin\-dctrl\fP [ \fIOptionen\fP ] \fIDateiname\fP \fIDateiname\fP .sp \fBjoin\-dctrl\fP \fB\-\-version\fP .sp \fBjoin\-dctrl\fP \fB\-\-help\fP .SH BESCHREIBUNG \fBjoin\-dctrl\fP führt anhand von Beziehungen eine Verknüpfungsoperation zu Daten her, die im Debian\-Steuerdateiformat vorliegen. .PP Ein \fIVerknüpfungsfeld\fP muss unter Benutzung der Schalter \fB\-1\fP, \fB\-2\fP oder \fB\-j\fP angegeben werden. . Begrifflich erstellt das Programm alle gegliederten Datensatzpaare, die aus einem Datensatz der ersten Datei als erstes und einem einem Datensatz der zweiten Datei als zweites Mitglied des Paares gebildet werden können; dann löscht es all die Paare, bei denen die Verbindungsfelder nicht gleich sind. . Im Grunde wird jede Eingabedatei als relationale Datenbanktabelle betrachtet. .PP Jede Eingabedatei muss in ihrem Verbindungsfeld in aufsteigender Reihenfolge sortiert sein, damit das Programm schnell arbeiten kann. . Dazu kann das Programm \fBsort\-dctrl\fP(1) verwandt werden. .SH OPTIONEN .IP "\fB\-1 \fP\fIFeld\fP, \fB\-\-1st\-join\-field=\fP\fIFeld\fP" gibt das Verbindungs\-\fIFeld\fP der ersten Eingabedatei an. .IP "\fB\-2 \fP\fIFeld\fP, \fB\-\-2nd\-join\-field=\fP\fIFeld\fP" gibt das Verbindungs\-\fIFeld\fP der zweiten Eingabedatei an. .IP "\fB\-j \fP\fIFeld\fP, \fB\-\-join\-field=\fP\fIFeld\fP" gibt das übliche Verbindungs\-\fIFeld\fP für alle Dateien an. .IP "\fB\-a \fP\fIDateinummer\fP, \fB\-\-unpairable\-from=\fP\fIDateinummer\fP" gibt an, dass nicht passende Abschnitte von der ersten (falls \fB1\fP angegeben ist) oder der zweiten (falls \fB2\fP angegeben ist) Datei ausgegeben werden. .IP "\fB\-o \fP\fIFeldangabe\fP, \fB\-\-output\-fields=\fP\fIFeldangabe\fP" gibt an, welche Felder in die Ausgabe einfließen. . Felder werden durch Kommas getrennt (es kann auch mehr als eine \fB\-o\fP\-Option benutzt werden). . Jedes Feld wird im Format \fIDateinummer\fP\fB.\fP\fIFeld\fP angegeben, wobei \fIDateinummer\fP die Aufzählungsnummer der Eingabedatei ist, von der das Feld abgerufen wird (entweder \fB1\fP oder \fB2\fP) und \fIFeld\fP gibt den Namen des zu verwendenden Feldes an. . Als Sonderfall kann einfach \fB0\fP anstelle von \fIDateinummer\fP\fB.\fP\fIFeld\fP benutzt werden, um Bezug auf den üblichen Wert der Verbindungsfelder zu nehmen. .IP Der Name des Feldes (der nicht die Dateinummer einschließt) wird in der Ausgabe als Name des Feldes benutzt. . Zu Ausgabezwecken kann jedoch ein anderer Name durch Anhängen eines Doppelpunkts und des bevorzugten sichtbaren Namens an die Feldangabe angegeben werden. .IP Die Option \fB\-o 0,1.Version:Alte\-Version,2.Version\fP gibt zum Beispiel an, dass das erste Feld in jeder Ausgabe das Verbindungsfeld sein sollte, das zweite Feld sollte \fBAlte\-Version\fP sein und seine Daten vom Feld \fBVersion\fP der ersten Eingabedatei beziehen und das dritte Feld sollte \fBVersion\fP sein und seine Daten von dem Feld mit gleichem Namen in der zweiten Eingabedatei beziehen. Dies sind die einzigen Felder im Ausgabedatensatz. .IP Falls die Option \fB\-o\fP angegeben wurde, werden alle Felder aller Datensätze, die verknüpft sind, in die Ausgabe einfließen. .IP "\fB\-l \fP\fIStufe\fP, \fB\-\-errorlevel=\fP\fIStufe\fP" setzt die Protokollierungsstufe auf \fIStufe\fP. \fIStufe\fP ist entweder \fBfatal\fP, \fBimportant\fP, \fBinformational\fP oder \fBdebug\fP, aber Letzteres ist, abhängig von den Optionen zur Kompilierzeit, möglicherweise nicht verfügbar. Diese Kategorien sind hier in ihrer Reihenfolge angegeben; jede Nachricht, die ausgegeben wird, während \fBfatal\fP in Kraft ist, wird in der Fehlerstufe \fBimportant\fP ausgegeben und so weiter. Vorgabe ist \fBimportant\fP. .TP \fB\-V\fP, \fB\-\-version\fP gibt Versionsinformationen aus. .TP \fB\-C\fP, \fB\-\-copying\fP gibt die Copyright\-Lizenz aus. Dies produziert eine große Ausgabe; stellen Sie sicher, dass Sie sie irgendwohin um\- oder weiterleiten (wie etwa Ihren bevorzugten Dateibetrachter). .TP \fB\-h\fP, \fB\-\-help\fP gibt eine Zusammenfassung von Hilfetexten aus. .SH OPERANDEN \fBjoin\-dctrl\fP wird jede Datei, die auf der Befehlszeile benannt wird, als relationale Datenbanktabelle betrachten. . Eine Datei namens \fB\-\fP steht für den Standardeingabe\-Datenstrom eines Programms. . Derzeit müssen exakt zwei Dateien benannt werden. .SH STDIN Wie im vorhergehenden Abschnitt \fBOPERANDEN\fP angegeben, könnte der Standardeingabe\-Datenstrom als Eingabe verwandt werden. .SH EINGABEDATEIEN Jegliche Eingabe für \fBjoin\-dctrl\fP hat das Format einer Debian\-Steuerdatei. .PP Eine Debian\-Steuerdatei (dctrl) ist eine halbwags strukturierte Datenbank aus einer Tabelle, die in einer maschinenauswertbaren Textdatei gespeichert wird. . Einer derartige Datenbank besteht aus einer Zusammenstellung von Datensätzen; jeder Datensatz ist eine Abbildung von Feldnamen auf Feldinhalt. . Textlich werden Datensätze durch leere Zeilen getrennt, während jedes Feld als eine oder mehrere nicht leere Zeilen innerhalb eines Datensatzes kodiert ist. . Ein Feld beginnt mit seinem Namen, gefolgt von einem Doppelpunkt, gefolgt vom Feldinhalt. . Der Doppelpunkt muss in der ersten Zeile des Feldes liegen und die erste Zeile darf nicht mit einem Leerraum beginnen. . In Gegensatz dazu beginnen nachfolgende Zeilen immer mit einem Leerraum (einem oder mehrere Leerzeichen oder Tabulatoren). .PP Jede Eingabedatei muss in aufsteigender Reihenfolge ihres Verbindungsfelds sortiert sein. .SH UMGEBUNGSVARIABLEN Die Standardsprachumgebung, insbesondere deren Zeichensatzeinstellung, beeinflusst die Interpretation der Ein\- und Ausgabe als Zeichendatenströme. .SH "ASYNCHRONE EREIGNISSE" Standard\-UNIX\-Signale haben ihre gewohnte Bedeutung. .SH STDOUT Die komplette Ausgabe wird an den Standardausgabe\-Datenstrom gesandt. . Die Ausgabe hat das Format einer Debian\-Steuerdatei, wie sie im vorhergehenden Abschnitt \fBEINGABEDATEIEN\fP beschrieben wurde. . Die Ausgabe wird in absteigender Reihenfolge des Verbindungsfelds sortiert, falls es in der Ausgabe enthalten ist. .SH AUSGABEDATEIEN Es gibt dort keine Ausgabedateien. .SH EXIT\-STATUS Dieses Hilfswerkzeug wird bei Erfolg mit \fB0\fP beendet. Es benutzt inkonsistent einen Rückgaberwert ungleich Null, wenn ein Fehler festgestellt wird (dies ist ein Programmfehler). .SH "FOLGEN VON FEHLERN" Im Fall von Fehlern in der Eingabe wird die Ausgabe teilweise oder komplett Müll sein. Im Fall von Fehlern im Aufruf wird das Programm die Funktion verweigern. .SH BEISPIELE Angenommen, diese Datei enthält Daten über Binärpakete für die AMD64\-Architektur, die in der Debian\-Squeeze\-Veröffentlichung (6.0) im Abschnitt \fBmain\fP enthalten sind. Sie liegt im aktuellen Verzeichnis und heißt \fIPackages\fP. . Angenommen, es wird derzeit auf einem Debian\-System gearbeitet. . Außerdem angenommen, dass das aktuelle Verzeichnis keine Dateien mit Namen \fIstat\fP und \fIpkg\fP enthält. . Die folgenden Befehle geben für jedes derzeit installierte und verfügbare Paket in Debian\-Squeeze (6.0) seine installierte Version (als Alte\-Version) und die Version in Squeeze (als Neue\-Version) aus: .nf $ sort\-dctrl \-kPackage /var/lib/dpkg/status > stat $ sort\-dctrl \-kPackage Packages > pkg $ join\-dctrl \-j Package \e \-o 0,1.Version:Alte\-Version,2.Version:Neue\-Version \e stat pkg .fi .SH AUTOR Das Programm \fBjoin\-dctrl\fP und diese Handbuchseite wurden von Antti\-Juhani Kaijanaho geschrieben. .SH "SIEHE AUCH" \fBgrep\-dctrl\fP(1), \fBsort\-dctrl\fP(1), \fBtbl\-dctrl\fP(1) .SH TRADUCTION Diese Übersetzung wurde mit dem Werkzeug .B po4a durch Chris Leick .I c.leick@vollbio.de und das deutsche Debian-Übersetzer-Team im Dezember 2011 erstellt. Bitte melden Sie alle Fehler in der Übersetzung an .I debian-l10n-german@lists.debian.org oder als Fehlerbericht an das Paket .IR dctrl-tools . Sie können mit dem folgenden Befehl das englische Original anzeigen .RB » "man -L C" .IR "Abschnitt deutsche_Handbuchseite" «.