tput(1)
NÉV
tput - inicializál (beállít) egy terminált vagy lekérdezi a terminfo adatbázist
ÖSSZEFOGLALÓ
tput [-Ttype] capname [parms …]
tput [-Ttype] init
tput [-Ttype] reset
tput [-Ttype] longname
tput -S<<
LEÍRÁS
A tput segédprogram a terminfo-t (terminál adatbázis) használja arra, hogy az egyes terminálfüggő informácókat elérhetővé tegye a shell (ld. sh(1)) számára a terminál beállításához. Képes továbbá visszaadni a kért terminál típus teljes nevét. A tput output-jaként egy karakterláncot ad vissza ha a kért jellemző (capability name) string típusú és egy egész értéket ha az egész szám jellegű. Ha a kért jellemző logikai típusú, akkor a tput egyszerűen beállítja a visszatérési értéket (exit code) (0-TRUE ha a terminál rendelkezik a szóban forgó képességgel, 1-FALSE ha nem) és nem generál kimenő adatot. A felhasználó mielőtt használná a standard output-on visszakapott értéket, ellenőrheti az exit code értékét ($?, ld. sh(1)), hogy az 0-e. (ld. EXIT CODES és DIAGNOSTICS rész). A képességek és a hozzájuk rendelt capname-ek teljes listáját ld.: terminfo(\*n).
-Ttype
a terminál típusát jelzi. Rendes körülmények között ez az opció szükségtelen, mert az alapértelmezett érték a TERM környezeti változóban található. Ha a -T meg van adva, akkor LINES és COLUMNS shell változók nem lesznek figyelembe véve és nem kerül lekérdezésre az aktuális képernyőméret (az operációs rendszertől).
capname
a terminfo adatbázisból kért jellemző neve
parms
Ha a tulajdonság string típusú, ami paramétereket igényel, akkor a parms argumentum átadásra kerül a string-nek. Minden numerikus argumentum mint szám kerül átadásra.
-S lehetővé teszi egynél több jellemző lekérését egy meghívás során. A jellemzők ekkor a standard input-ról jönnek és nem a parancssorból (ld. példa). Egy sorban csak egy capname engedélyezett. Az -S opció megváltoztatja az exit code-okat (ld. EXIT CODES rész).
init
Ha a terminfo adatbázis létezik és van a felhsználó termináljához tartozó bejegyzés (ld. -Ttype fent), akkor a következő történik: (1) a terminál inicializáló string-je (ha van ilyen) lesz az output (is1, is2, is3, if, iprog), (2) egyéb a bejegyzésben meghatározott késedelm (pl. új sor) a tty meghajtóban lesz beállítva, (3) a tabulátor beállítások az adatbázis bejegyzésnek megfelelően kerül ki- vagy bekapcsolásra és (4) ha nincsenek tabulátor beállítások, akkor az alapértelmezett tabulátorpozíciók kerülnek beállításra (minden 8. karakterpozíció). Ha a bejegyzés nem tartakmaz információt a fenti tevékenységek valamelyikéhez, akkor a tevékenység nem hajtódik végre.
reset
az inicializáló string kiadása helyett a terminál reset-stringje kerül a kimenetre (rs1, rs2, rs3, rf) ha az létezik. Ha reset-string nincs, de inicializáló van, akkor az kerül a kimenetre. Egyébként a reset azonos az init-tel.
longname
ha a terminfo adatbázis létezik és van a felhasználó termináljának megfelelő bejegyzés (ld. -Ttype fent), akkor a terminál neve fog megjelenni. A név az utolsó név a terminfo adatbázis terminált leíró első sorbában (ld. term(5)).
PÉLDÁK
tput init
Inicializálja a terminált a TERM környezeti változóban lévő termináltípusnak megfelelően. Ez a sor nem árt ha szerepel a felhasználó .profile állományában azután, hogy a TERM változó exportálásra került, ahogy az a profile(4) oldalon olvasható.
tput -T5620 reset
alapállapotba hoz egy AT&T 5620-as terminált és felülírja a terminál típusát a TERM változóban.
tput cup 0 0
egy olyan szekvenciát küld a terminálnak, amely 0. sor 0. oszlopába (a képernyő bal felső sarka, gyakran “home” pozíció) viszi a kurzort.
tput clear
egy képernyőtörlés szekvenciát küld a termi
nálnaktput cols
kiírja a terminál oszlopainak számát
bold=`tput smso` offbold=`tput rmso`
a bold shell változóba a terminálnak megfelelő “stand-out mód kezdete”, az offbold shell változóba a “stand-out mód vége” szekvenciát teszi. Ezt esetleg követhet egy prompt: echo “${bold} Kerem irja be a nevet: ${offbold}\”
tput hc
az exit kód jelzi, hogy a terminál hardcopy terminál-e
tput cup 23 4
egy olyan szekvenciát küld a terminálnak, ami a kurzort 23, 4 pozícióba mozgatja.
tput longname
a TERM környezeti változóban specifikált terminál típushoz tartozó teljes nevet írja ki a terminfo adatbázis bejegyzéséből.
tput -S<<!
>clear
>cup 10 10
>bold
>!
Példa arra, hogy hogyan lehet több műveletet elvégezni egy hívással. A példa letörli a képernyőt, a 10, 10 pozícióba viszi a kurzort és bekapcsolja a “kiemelt fényesség” módot.
FILE-OK
\*d lefordított terminál leíró adatbázis
/usr/include/curses.h
curses(3X) header file
/usr/include/term.h
terminfo header file
/usr/lib/tabset/*
tabulátorbeállítások a terminálokhoz olyan formátumban, hogy az megfeleljen a terminálon való megjelenítésnek (escape szekvenciák, amelyek beállítják a margókat és a tabulátorpozíciókat); részletesen a “Tabs and Initialization” terminfo(4) részében.
LÁSD MÉG
clear(1), stty(1), tabs(\*n), terminfo(4) System Administrator’s Reference Manual-ban. A Programmer’s Guide 10. fejezetében.
VISSZATÉRÉSI ÉRTÉK (EXIT CODE)
Ha a capname logikai típusú, akkor az érték 0 TRUE esetén és 1 FALSE esetén kivéve, ha a az -S opció be van kapcsolva.
Ha a capname karakterlánc típusú, akkor 0 jelzi, hogy ez a képesség definiálva van ennél a terminál típusnál (az értéke a standard kimeneten jelenik meg); 1 jelzi, hogy ez a képesség nincs definiálva ennél a terminál típusnál (a standard kimeneten 0 jelenik meg).
Ha a capname logikai vagy karakteres típusú és a -S opciót használjuk, akkor 0 jelzi, hogy minden sor sikeres volt. Nem jelzi, hogy melyik sor végrehajtása volt sikertelen, így az 1-es érték sohsem jelenik meg, a 2, 3 és 4 kódok jelentése a szokásos.
Ha a capname egész típusú, akkor az érték mindíg 0 akár definiálva van az adott képesség akár nem. A felhasználó úgy tudhatja ezt meg, hogy ellenőrzi a standard kimenetet. A -1 azt jelzi, hogy a jellemző nincs definiálva az adott terminál típushoz. Bármely más érték valamilyen hibát jelez; ld. a HIBÁK részt.
HIBÁK
A tput a követkző hibaüzeneteket és hozzájuk tartozó exit code-okat adja.
Exit code hibaüzenet
0 a capname egy egész érték, ami nincs meghatározva ehhez a terminálhoz a terminfo(\*n) adatbázisban, pl.
tput -T450 lines és tput -T2621 xmc
1 nem ír ki hibaüzenetet, ld. EXIT CODE-ok rész.
2 használati hiba
3 ismeretlen terminál típus, vagy nincs terminfo adatbázis.
4 ismeretlen terminfo képességnév
ÁTJÁRHATÓSÁG
A longname és -S opciókat valamint a cup példánál használt paraméterezési lehetőségeket a BSD és az AT&T/USD SVr4 előtti verziói nem támogatják.