Provided by:
manpages-hu_20010119-5_all 
NÉV
tput - inicializál (beállít) egy terminált vagy lekérdezi a terminfo-t
adatbázist
ÁTTEKINTÉS
tput [-Ttpus] kpler [paramterek ... ]
tput [-Ttpus] init
tput [-Ttpus] reset
tput [-Ttpus] teljesnév
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ő (kpesség ler) string
típusú vagy 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 (0-IGAZ ha a terminál rendelkezik a szóban forgó
képességgel, 1-HAMIS ha nem) és nem generál kimenő adatot. A
felhasználó mielőtt használná a szabványos kimeneten visszakapott
értéket, ellenőrizni kell a kilépési értékét [$?, ld. sh(1)], hogy az
0-e. (ld. ILÉPÉSI ÉRTÉK és DIAGNOSZTIKA részek). A képességek és a
hozzájuk rendelt capname-ek teljes listáját ld.: terminfo(5).
-Ttpus
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 a 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.
kpler
a terminfo adatbázisból kért jellemző neve.
paramterek
Ha a tulajdonság string típusú, ami paramétereket igényel, akkor
a paramterek 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 szabványos bemenetről jönnek és nem a
parancssorból (ld. példa). Egy sorban csak egy kpler
engedélyezett. Az -S opció megváltoztatja a kilépési értékek
jelentését (ld. KILÉPÉSI ÉRTÉKEK rész).
init Ha a terminfo adatbázis létezik és van a felhsználó
termináljához tartozó bejegyzés (ld. -TtpusR, fent), akkor a
kvetkez trtnik: (1) a terminl inicializl string-je (ha
van ilyen) lesz az output (is1, is2, is3, if, iprog), (2) egyéb
a bejegyzésben meghatározott késedelem (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ülnek 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.
teljesnév
Ha a terminfo adatbázis létezik és van a felhasználó
termináljának megfelelő bejegyzés (ld. -Ttpus, 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ó 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, általában "home" pozíciónak
nevezik) viszi a kurzort.
tput clear
egy képernyőtörlés szekvenciát küld a terminálnak.
tput cols
kiírja az aktuális terminál oszlopainak számát.
tput -T450 cols
Kiírja a 450-es terminál oszlopainak számát.
tput bold=`tput smso` offbold=`tput rmso`
a bold shell változóba a terminálnak megfelelő "kiemelt-mód"
kezdete karaktersorozatot, az offbold shell változóba a "kiemelt-
mód" vége szekvenciát teszi. Ezt esetleg követheti egy prompt:
echo "${bold} Kérem írja be a nevét: ${offbold}\c"
tput hc
az kilépési 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. sor,
4. pozíciójá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
> !
Ez egy 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. sor 10. pozíciójába
viszi a kurzort és bekapcsolja a félkövér (kiemelt fényesség)
módot. A felsorolást a külön sorba írt felkiáltójel (!) zárja.
FÁJLOK
/usr/share/terminfo
lefordított terminál leíró adatbázis
/usr/include/curses.h
ncurses(3NCURSES) header fájl
/usr/include/term.h
terminfo header fájl
/usr/share/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 "Tabulátorok és
Inicializálás" terminfo(4) részében.
LÁSD MÉG
clear(1), stty(1), tabs(5). profile(5), terminfo(4) Rendszer
Adminisztrtorok kziknyvben. A Programozók Segédlet-ének 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 tpusnl (az értéke a szabványos
kimeneten jelenik meg); 1 jelzi, hogy ez a képesség nincs definiálva
ennél a terminál tpusnl (a szabványos 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 sohasem 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 mindig 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 szabványos 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; lásd a HIBÁK részt.
DIAGNOSZTIKÁK
A tput a követkző hibaüzeneteket és hozzájuk tartozó kilépési értékeket
adja.
kilépési érték hibaüzenet
0 (a capname egy egész érték, ami nincs meghatározva ehhez a
terminálhoz a terminfo(5) adatbázisban, pl.
tput -T450 lines és tput -T2621 xmc)
1 nem ír ki hibaüzenetet, ld. KILÉPÉSI ÉRTÉK-ok rész.
2 használati hiba
3R ismeretlen terminál tpus, 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.
MAGYAR FORDÍTÁS
Szalay Attila <sasa@sophia.jpte.hu>
tput(1)