BEZEICHNUNG¶
tbl-dctrl - 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.
SIEHE AUCH¶
apt-cache(1),
ara(1),
dpkg-awk(1),
dpkg-query(1),
grep-dctrl(1),
sort-dctrl(1),
dpkg(8)
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«.