tbl-dctrl(1) erzeugt tabellarische Darstellungen von Daten im Dctrl-Format

ÜBERSICHT

tbl-dctrl [ Optionen ] [ -c Spaltenangabe … ] [ Dateiname ] …

tbl-dctrl --version

tbl-dctrl --help

BESCHREIBUNG

tbl-dctrl erzeugt tabellarische Darstellungen von Daten, die ihm im Format von Debian-Steuerdateien übergeben werden.

Standardmäßig liest tbl-dctrl die ganze Datenbank, sucht den längsten Eintrag in jeder angeforderten Spalte und gibt dann eine Tabelle mit Rändern und Spaltentiteln aus, wobei jede Spalte nur so breit wie der längste Eintrag ist. Die meisten dieser Verhaltensweisen können, wie im Folgenden beschrieben, geändert werden.

Eine Spalte wird durch Angabe des Schalters -c (--column) mit einer Spaltenangabe abgefragt. Die einfachste Art einer Spaltenangabe besteht einzig aus dem Namen eines Feldes. In einem solchen Fall wird tbl-dctrl in die Ausgabe eine Spalte einfügen, deren Titel die wörtliche Spaltenangabe ist und deren Daten aus den Feldern mit diesem Namen bezogen werden. Falls keine -c-Optionen angegeben sind, wird tbl-dctrl alle Felder in der Eingabe in der Reihenfolge verwenden, in der sie zuerst erscheinen.

Es gibt zwei optionale Zusätze für eine Spaltenangabe. Das Voranstellen von Text, gefolgt von einem Gleichzeichen vor den Feldnamen (zum Beispiel -c 'Paketname=Paket') ändert die Spalte so dass der Text vor den Gleichzeichen als Spaltentitel benutzt wird, während der Text dahinter als Name des Feldes genommen wird, aus dem die Daten bezogen werden. Es kann auch ein Doppelpunkt gefolgt von einer positiven Ganzzahl an den Feldnamen angehängt werden. In einem solchen Fall gibt die Zahl hinter dem Doppelpunkt die Spaltenbreite an. Diese beiden Zusätze können getrennt oder zusammen benutzt werden. Falls dort mehr als ein Doppelpunkt ist, ist der letzte maßgeblich. Falls dort mehr als ein Gleichzeichen ist, ist das erste maßgeblich. Andere Doppelpunkte und Gleichzeichen werden einfach als Daten verwandt. Beachten Sie, dass die ganze Spaltenangabe als ein Argument an tbl-dctrl übergeben werden muss, da sie, falls sie Leerzeichen enthält, für die Shell maskiert werden muss.

Falls alle angeforderten Spalten eine angegebene Breite haben, wird tbl-dctrl die Ausgabe sofort erzeugen, ohne darauf zu warten, dass die ganze Eingabe eingelesen ist.

OPTIONEN

-d Trennzeichen, --delimiter=Trennzeichen
benutzt statt hübschen Rahmen um die Tabelle die angegebene Zeichenkette Trennzeichen um Spalten in einer Zeile voneinander zu trennen.
-H, --no-heading
druckt keine Tabellenkopfzeilen (Spaltentitel).
-l Stufe, --errorlevel=Stufe
setzt die Protokollierungsstufe auf Stufe. Stufe ist entweder fatal, important, informational oder debug, 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 fatal in Kraft ist, wird in der Fehlerstufe important ausgegeben und so weiter. Vorgabe ist important.
-V, --version
gibt Versionsinformationen aus.
-C, --copying
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).
-h, --help
gibt eine Zusammenfassung von Hilfetexten aus.

OPERANDEN

tbl-dctrl wird seine Eingabe aus den auf der Befehlszeile benannten Dateinamen in der angegebenen Reihenfolge lesen. Eine Datei namens - steht für den Standardeingabe-Datenstrom eines Programms. Falls keine Dateien benannt wurden, verhält sich das Programm, als wäre nur allein - genannt worden, das heißt, die Eingabe wird vom Standardeingabe-Datenstrom gelesen.

STDIN

Wie im vorhergehenden Abschnitt OPERANDEN angegeben, könnte der Standardeingabe-Datenstrom als Eingabe verwandt werden.

EINGABEDATEIEN

Jegliche Eingabe für tbl-dctrl liegt im Format einer Debian-Steuerdatei vor.

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).

Wenn die Eingabe aus mehreren Dateien gelesen wird, ist implizit zwischen zwei angrenzenden Dateien ein Datensatztrenner.

UMGEBUNGSVARIABLEN

Die Standardsprachumgebung, insbesondere deren Zeichensatzeinstellung, beeinflusst die Interpretation der Ein- und Ausgabe als Zeichendatenströme.

ASYNCHRONE EREIGNISSE

Standard-UNIX-Signale haben ihre gewohnte Bedeutung.

STDOUT

Die komplette Ausgabe wird an den Standardausgabe-Datenstrom gesandt. Die Ausgabe ist eine tabellarische Darstellung der Eingabedatenbank, beschränkt auf die angegebenen Felder. Logischerweise ist die Ausgabe ebenfalls eine Tabelle. Wenn die Option -d verwandt wird, wird diese Tabelle einfach durch Trennung der Spalten in jeder Zeile durch das angegebene Trennzeichen dargestellt; wenn die Option nicht benutzt wird, wird ein Rahmen um die Tabelle gezeichnet. Die Reihenfolge der Spalten ist die Gleiche, wie die der Spaltenangaben auf der Befehlszeile.

AUSGABEDATEIEN

Es gibt dort keine Ausgabedateien.

EXIT-STATUS

Dieses Hilfswerkzeug wird bei Erfolg mit 0 beendet. Es benutzt inkonsistent einen Rückgaberwert ungleich Null, wenn ein Fehler festgestellt wird (dies ist ein Programmfehler).

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.

BEISPIELE

Die folgende Befehlszeilen-Pipe gibt eine Tabelle aller Pakete mit ihren Betreuerdaten aus, sortiert nach den Betreuerdaten, die keinen Inhalt haben:
% grep-available -FInstalled-Size --eq 0 | sort-dctrl -kMaintainer - \
  | tbl-dctrl -cPackage -cMaintainer

AUTOR

Das Programm tbl-dctrl und diese Handbuchseite wurden von Antti-Juhani Kaijanaho geschrieben.

TRADUCTION

Diese Übersetzung wurde mit dem Werkzeug po4a <URL:http://po4a.alioth.debian.org/> durch Chris Leick c.leick@vollbio.de und das deutsche Debian-Übersetzer-Team im Dezember 2011 erstellt.

Bitte melden Sie alle Fehler in der Übersetzung an debian-l10n-german@lists.debian.org oder als Fehlerbericht an das Paket dctrl-tools.

Sie können mit dem folgenden Befehl das englische Original anzeigen »man -L C Abschnitt deutsche_Handbuchseite«.