tput - Datensichtstation initialisieren oder Datenbank terminfo abfragen

(change terminal characteristics)

Dieses Kommando ist nur für die Benutzer sinnvoll, die über rlogin Zugang zur POSIX-Shell erhalten haben.

Mit tput können Sie

• eine Eigenschaft einer Datensichtstation ausgeben (Format 1)

• mehrere Eigenschaften einer Datensichtstation ausgeben (Format 2)

• eine Datensichtstation initialisieren (Format 3)

• eine Datensichtstation zurücksetzen (Format 4)

• den ausführlichen Namen einer Datensichtstation ausgeben (Format 5)

• den Bildschirm löschen (Format 6).

Syntax

Format 1:	tput[ -T typ] capname[ parameter...]
Format 2:	tput -S
Format 3:	tput[ -T typ] init
Format 4:	tput[ -T typ] reset
Format 5:	tput[ -T typ] longname
Format 6:	tput[ -T typ] clear

Eine Eigenschaft einer Datensichtstation ausgeben

Format 1:

tput[ -T typ] capname[ parameter...]

Jeweils eine Eigenschaft einer Datensichtstation wird ausgegeben. Diese Eigenschaften sind in der Datenbank terminfo festgelegt.

-T typ

Für typ geben Sie den Typ der Datensichtstation an, dessen Eigenschaften Sie abfragen wollen. Wenn Sie die Option -T typ verwenden, bleibt der Wert der Shell-Variablen LINES und COLUMNS unverändert, sowie die Größe des Fensters.

-T typ nicht angegeben:
Für typ wird der Wert der Umgebungsvariablen TERM eingesetzt.

capname

(capability name)

capname ist die Kurzbezeichnung einer Eigenschaft der Datensichtstation, wie sie in der Quelldatei für terminfo steht. Um ausgeben zu lassen, ob Ihre Datensichtstation über eine bestimmte Eigenschaft verfügt, müssen Sie die zugehörige Kurzbezeichnung capname angeben.

Je nach Typ der Eigenschaft gibt tput folgendes aus:

• Eigenschaft vom Typ Boolscher Wert: tput liefert nur einen Endestatus zurück und zwar 0 für wahr, wenn die Datensichtstation die entsprechende Eigenschaft hat, und 1 für falsch, wenn die Datensichtstation die Eigenschaft nicht hat.
  In der POSIX-Shell fragen Sie den Endestatus mit echo $? ab.

• Eigenschaft vom Typ Zeichenkette: tput gibt die entsprechende Zeichenkette aus.

• Eigenschaft vom Typ Numerische Angabe: tput gibt eine ganze Zahl aus.

Wenn der durch capname festgelegten Eigenschaft für den angegebenen Datensichtstationstyp in terminfo kein Wert zugewiesen ist, gibt tput -1 aus.

parameter

Wenn die Eigenschaft capname eine Zeichenkette ist, die Parameter benötigt, dann geben Sie diese als parameter an. capname und parameter werden als zusammengesetzte Zeichenkette an tput übergeben. Ein rein numerischer Parameter wird als Zahl übergeben.

Mehrere Eigenschaften einer Datensichtstation ausgeben

Format 2:

tput -S

Mit diesem Aufruf von tput können mehrere Eigenschaften der aktuellen Datensichtstation ausgegeben werden. Sie übergeben die Eigenschaften nicht von der Kommandozeile, sondern von der Standard-Eingabe (siehe Beispiel 4). Es ist nur jeweils eine Eigenschaft der Datensichtstation pro Zeile zulässig. Wenn Sie mit der Option -T typ arbeiten, bleibt der Wert der Shell-Variablen LINES und COLUMNS unverändert. Die Werte 0 und 1 als Endestatus ändern sich (siehe Abschnitt Fehler).

capname

(capability name)

capname ist die Kurzbezeichnung einer Eigenschaft der Datensichtstation, wie sie in der Quelldatei für terminfo steht. Um ausgeben zu lassen, ob Ihre Datensichtstation über eine bestimmte Eigenschaft verfügt, müssen Sie die zugehörige Kurzbezeichnung capname angeben. Je nach Typ der Eigenschaft gibt tput Folgendes aus:

• Eigenschaft vom Typ Boolscher Wert: tput liefert nur einen Endestatus zurück und zwar 0 für wahr, wenn die Datensichtstation die entsprechende Eigenschaft hat, und 1 für falsch, wenn die Datensichtstation die Eigenschaft nicht hat. In der POSIX-Shell fragen Sie den Endestatus mit echo $? ab.

• Eigenschaft vom Typ Zeichenkette: tput gibt die entsprechende Zeichenkette aus.

• Eigenschaft vom Typ Numerische Angabe: tput gibt eine ganze Zahl aus.

• Es kann eine einfache Eingabeumlenkung gemacht werden:
  tput -S < dateiname
  Jede Zeile von dateiname enthält einen Eintrag in der Form capname[ parameter].Wird nur tput -S angegeben, muss die Eingabe mit CTRL+D oder @@d beendet werden.

Wenn der durch capname festgelegten Eigenschaft für den angegebenen Datensichtstationstyp in terminfo kein Wert zugewiesen ist, gibt tput -1 aus.

parameter

Wenn die Eigenschaft capname eine Zeichenkette ist, die Parameter benötigt, dann geben Sie diese als parameter an. capname und parameter werden als zusammengesetzte Zeichenkette an tput übergeben. Ein rein numerischer Parameter wird als Zahl übergeben.

Datensichtstation initialisieren

Format 3:

tput[ -T typ] init

Wenn die Datenbank terminfo einen Eintrag für die aktuell benutzte Datensichtstation enthält, initialisiert tput diese entsprechend dem Typ, der bei -T typ angegeben ist. Im Einzelnen führt tput folgende Aktionen durch:

Die Zeichenketten für die Initialisierung der Datensichtstation (capname is1, is2, is3, if, iprog) werden ausgegeben, sofern sie vorhanden sind.

Alle eingetragenen Verzögerungen (z.B. Neue-Zeile-Zeichen) werden im Treiber für die Datensichtstation eingestellt.

Tabulatorzeichen werden je nach Eintrag unverändert ausgegeben oder zu Leerzeichen expandiert.

Falls Tabulatorzeichen unverändert ausgegeben werden, werden Standardtabulatorsprünge eingestellt (alle acht Zeichen).

Falls der terminfo-Eintrag die Informationen für eine dieser Aktionen nicht enthält, entfällt diese Aktion ohne Fehlermeldung.

-T typ

Für typ geben Sie den Typ der Datensichtstation an, mit dessen Eigenschaften Sie Ihre Datensichtstation initialisieren wollen.

-T typ nicht angegeben:
Für typ wird der Wert der Umgebungsvariablen TERM eingesetzt.

Datensichtstation zurücksetzen

Format 4:

tput[ -T typ] reset

Statt der Zeichenketten für die Initialisierung werden die Zeichenketten für das Zurücksetzen der Datensichtstation ausgegeben (capname rs1, rs2, rs3, rf). Falls dafür keine Einträge vorhanden sind, jedoch für die Initialisierung, werden die Zeichenketten für die Initialisierung ausgegeben. Ansonsten verhält sich reset wie init.

-T typ

Für typ geben Sie den Typ der Datensichtstation an, mit dessen Eigenschaften Sie Ihre Datensichtstation zurücksetzen wollen.

-T typ nicht angegeben:
Für typ wird der Wert der Umgebungsvariablen TERM eingesetzt.

Ausführlichen Namen einer Datensichtstation ausgeben

Format 5:

tput[ -T typ] longname

Wenn die Datenbasis terminfo existiert und einen Eintrag für die benutzte Datensichtstation (vgl. Format 1, Option -T typ) enthält, wird die ausführliche Bezeichnung der Datensichtstation ausgegeben. Diese ausführliche Bezeichnung ist der letzte Name in der ersten Zeile der Beschreibung der Datensichtstation in der Datenbank terminfo.

Bildschirm löschen

Format 6:

tput[ -T typ] clear

Statt der Zeichenketten für die Initialisierung werden die Zeichenketten für das Löschen des Bildschirms ausgegeben.

-T typ

Für typ geben Sie den Typ der Datensichtstation an, dessen Bildschirm Sie löschen wollen.

-T typ nicht angegeben:
Für typ wird der Wert der Umgebungsvariablen TERM eingesetzt.

Endestatus

capname vom Typ Boolescher Wert und die Option -S nicht gesetzt:

0	wenn der angegebene Datensichtstationstyp die Eigenschaft hat,
1	wenn der angegebene Datensichtstationstyp die Eigenschaft nicht hat.

capname vom Typ Zeichenkette und die Option -S nicht gesetzt:

0	wenn die Eigenschaft capname für diesen Datensichtstationstyp definiert ist.
1	wenn die Eigenschaft capname für diesen Datensichtstationstyp nicht definiert ist (auf die Standard-Ausgabe wird nichts ausgegeben).

capname vom Typ Boolescher Wert oder Zeichenkette und Option -S:

0	wenn alle Zeilen erfolgreich abgearbeitet werden konnten.
1	Endestatus 1 kann niemals vorkommen, da nicht angegeben werden kann, welche Zeilenicht abgearbeitet werden konnte.

capname vom Typ ganze Zahl:

0	Endestatus immer 0. Anhand der Standard-Ausgabe kann entschieden werden, ob capname für den angegebenen Datensichtstationstyp definiert ist oder nicht. Wird -1 auf die Standard-Ausgabe ausgegeben, bedeutet das, dass capname nicht definiert ist.

Fehlersituationen werden durch einen Endestatus 2, 3 oder 4 angezeigt.

Fehler

Je nach Endestatus gibt tput folgende Fehlermeldungen aus:

tput: unknown terminal type

Unbekannter Datensichtstationstyp type oder keine terminfo Datenbasis vorhanden, Endestatus 3

tput: unknown terminfo capability capname

Unbekannte Datensichtstationseigenschaft capname, Endestatus 4.

Variable

TERM

Standard-Wert für den Typ der Datensichtstation, der eingesetzt wird, wenn Sie die Option -T typ nicht angeben.

Datei

/usr/share/lib/terminfo/?/*

Datenbank mit Binärversionen der Beschreibungen für die einzelnen Datensichtstationstypen.

/usr/include/curses.h

Header-Datei von curses()

/usr/include/term.h

Header-Datei von terminfo()

/usr/lib/tabset/*

Information über die Behandlung von Tabulatorzeichen

Internationale Umgebung

Die folgenden Umgebungsvariablen beeinflussen die Ausführung des Kommandos tput:

LANG

Gibt einen Standardwert für die Variablen für die internationale Umgebung an, die nicht gesetzt oder Null sind. Ist LANG nicht gesetzt oder Null, wird der entsprechende Standardwert der internationalen Umgebung verwendet. Enthält eine der Internationalisierungsvariablen eine ungültige Einstellung, verhält sich das Kommando so, als sei keine der Variablen definiert worden.

LC_ALL

Ist diese Variable auf einen Wert gesetzt, d. h. ist sie nicht leer, überschreibt dieser Wert die Werte aller übrigen Internationalisierungsvariablen.

LC_CTYPE

Legt die internationale Umgebung für die Interpretation der Byte-Folgen eines Datentexts als Zeichen fest (z.B. Singlebytezeichen im Unterschied zu Mehrbytezeichen in Argumenten und Eingabedateien) sowie die Einteilung der Zeichen in Groß- und Kleinbuchstaben und deren Übereinstimmung.

LC_MESSAGES

Legt die internationale Umgebung für Format und Inhalt der Diagnosemeldungen fest, die in die Standardfehlerausgabe geschrieben werden.

NLSPATH

Legt den Pfad der Meldungsdateien für LC_MESSAGES fest.

Beispiel 1

Bildschirm initialisieren

$ tput init

Eine Steuerzeichen-Folge, die den Bildschirm initialisiert, wird an die aktuelle Datensichtstation geschickt. Es wird die Steuerzeichenfolge genommen, die für den durch die Umgebungsvariable TERM festgelegten Datensichtstationstyp gilt.

Beispiel 2

Anzahl der Spalten der aktuellen Datensichtstation ausgeben

$ tput cols

80

Beispiel 3

Ist die aktuelle Datensichtstation ein Hardcopy-Terminal?

$ tput hc

$ echo $?

1

hc ist vom Typ Boolescher Wert, tput liefert daher nur einen Endestatus zurück. Diesen Endestatus fragen Sie mit echo $? ab. Der Endestatus ist 1, die aktuelle Datensichtstation ist also kein Hardcopy-Terminal.

Beispiel 4

Mehrere Eigenschaften der Datensichtstation mit einem tput-Aufruf ausgeben

$ tput -S <<here
> clear

> cup 10 10

> bold

> here

Der Bildschirm wird gelöscht, die Schreibmarke auf Position 10, 10 gebracht und verstärkte Darstellung eingeschaltet. here in der letzten Zeile beendet die Liste.

Beispiel 5

Die Datei input hat den Inhalt:

cols
lines

Wird diese Datei als Input z.B. für die Terminaltypen 97801 und 97808 verwendet, dann ergibt der tput-Aufruf folgendes:

$ tput -S <input

89

24

$

Siehe auch

stty, tabs