MAN page from PLD ncurses-5.9.20150117-5.x86_64.rpm

tput

Section: User Commands (1)
Updated:
Index

NÉV

tput - inicializál (beállít) egy terminált vagy lekérdezi a terminfo-tadatbázist

ÁTTEKINTÉS

tput [-Ttípus] képleír [paraméterek ... ]
tput [-Ttípus] init
tput [-Ttípus] reset
tput [-Ttípus] teljesnév
tput -S <<

LEÍRÁS

A tput segédprogram a terminfo-t (terminál adatbázis) használjaarra, 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értterminál típus teljes nevét. A tput output-jaként egy karakterláncot advissza ha a kért jellemző (képesség leíró) string típusú vagy egyegé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 haa terminál rendelkezik a szóban forgó képességgel, 1-HAMIS ha nem) és nemgenerál kimenő adatot. A felhasználó mielőtt használná a standard output-onvisszakapott é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 DIAGNOSZTIKArészek). A képességek és a hozzájuk rendelt capname-ek teljes listájátld.: terminfo(5).

-Ttípus: 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óknem lesznek figyelembe véve és nem kerül lekérdezésre az aktuális képernyőméretaz operációs rendszertől.
képleíró: a terminfo adatbázisból kért jellemző neve.
paraméterek: Ha a tulajdonság string típusú, ami paramétereket igényel, akkor aparaméterek argumentum átadásra kerül a string-nek. Minden numerikusargumentum 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őkekkor a standard input-ról jönnek és nem a parancssorból (ld. példa). Egysorban csak egy képleíró engedélyezett. Az -S opció megváltoztatjaa 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. -TtípusR, fent), akkor a következő történik: (1) aterminál inicializáló string-je (ha van ilyen) lesz az output (is1,is2, is3, if, iprog), (2) egyéb a bejegyzésbenmeghatározott késedelem (pl. új sor) a tty meghajtóban lesz beállítva, (3) atabulátor beállítások az adatbázis bejegyzésnek megfelelően kerülnek ki- vagybekapcsolásra és (4) ha nincsenek tabulátor beállítások, akkor azalapé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 fentitevé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 akimenetre (rs1, rs2, rs3, rf) ha az létezik. Hareset-string nincs, de inicializáló van, akkor az kerül a kimenetre. Egyébkénta reset azonos az init-tel.
teljesnév: Ha a terminfo adatbázis létezik és van a felhasználó termináljánakmegfelelő bejegyzés (ld. -Ttípus, fent), akkor a terminál nevefog megjelenni. A név az utolsó név a terminfo adatbázis termináltleí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áta 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 akurzort.
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" kezdetekaraktersorozatot, az offbold shell változóba a "kiemelt-mód" végeszekvenciát teszi. Ezt esetleg követheti egy prompt: echo "${bold} Kérem írjabe 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ábamozgatja.
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. Apélda letörli a képernyőt, a 10. sor 10. pozíciójába viszi a kurzort ésbekapcsolja 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 aterminálon való megjelenítésnek (escape szekvenciák, amelyek beállítják amargókat és a tabulátorpozíciókat); részletesen a "Tabulátorok ésInicializálás" terminfo(4) részében.

LÁSD MÉG

clear(1), stty(1), tabs(5). profile(5),terminfo(4) Rendszer Adminisztrátorok kézikönyvében. AProgramozó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 és1 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égdefiniálva van ennél a terminál típusnál (az értéke a standard kimenetenjelenik meg); 1 jelzi, hogy ez a képesség nincs definiálva ennél aterminál típusnál (a standard kimeneten 0 jelenik meg).

Ha a capname logikai vagy karakteres típusú és a -S opcióthasználjuk, akkor 0 jelzi, hogy minden sor sikeres volt. Nem jelzi, hogymelyik sor végrehajtása volt sikertelen, így az 1-es érték sohasemjelenik 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álvavan az adott képesség akár nem. A felhasználó úgy tudhatja ezt meg, hogyellenőrzi a standard kimenetet. A -1 azt jelzi, hogy a jellemző nincsdefiniá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ékeketadja.

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 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áltparaméterezési lehetőségeket a BSD és az AT&T/USD SVr4 előtti verziói nemtámogatják.

MAGYAR FORDÍTÁS

Szalay Attila <sasaAATTsophia.jpte.hu>

This document was created byman2html,using the manual pages.