'\" t .TH tput 1 "" .ds d /usr/share/terminfo .ds n 5 .SH NÉV tput \- inicializál (beállít) egy terminált vagy lekérdezi a terminfo-t adatbázist .SH ÁTTEKINTÉS \fBtput\fR [\fB-T\fR\fItípus\fR] \fIképleír\fR [\fIparaméterek\fR ... ] .br \fBtput\fR [\fB-T\fR\fItípus\fR] \fBinit\fR .br \fBtput\fR [\fB-T\fR\fItípus\fR] \fBreset\fR .br \fBtput\fR [\fB-T\fR\fItípus\fR] \fBteljesnév\fR .br \fBtput -S\fR \fB<<\fR .br .SH LEÍRÁS A \fBtput\fR segédprogram a \fBterminfo\fR-t (terminál adatbázis) használja arra, hogy az egyes terminálfüggő informácókat elérhetővé tegye a shell (ld. \fBsh\fR(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 \fBtput\fR output-jaként egy karakterláncot ad vissza ha a kért jellemző (\fIkép\fResség \fIleíró\fR) 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 \fBtput\fR egyszerűen beállítja a visszatérési értéket (\fB0\fR-IGAZ ha a terminál rendelkezik a szóban forgó képességgel, \fB1\fR-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 [\fB$?\fR, ld. \fBsh\fR(1)], hogy az \fB0\fR-e. (ld. \fKILÉPÉSI ÉRTÉK\fR és \fBDIAGNOSZTIKA\fR részek). A képességek és a hozzájuk rendelt \fIcapname\fR-ek teljes listáját ld.: \fBterminfo\fR(\*n). .TP \fB-T\fR\fItípus\fR 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 \fBTERM\fR környezeti változóban található. Ha a \fB-T\fR meg van adva, akkor a \fBLINES\fR és \fBCOLUMNS\fR 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. .TP \fIképleíró\fR a \fBterminfo\fR adatbázisból kért jellemző neve. .TP \fIparaméterek\fR Ha a tulajdonság string típusú, ami paramétereket igényel, akkor a \fIparaméterek\fR argumentum átadásra kerül a string-nek. Minden numerikus argumentum mint szám kerül átadásra. .TP \fB-S\fR 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 \fIképleíró\fR engedélyezett. Az \fB-S\fR opció megváltoztatja a kilépési értékek jelentését (ld. KILÉPÉSI ÉRTÉKEK rész). .TP \fBinit\fR Ha a \fBterminfo\fR adatbázis létezik és van a felhsználó termináljához tartozó bejegyzés (ld. \fB-T\fR\fItípus\dR, fent), akkor a következő történik: (1) a terminál inicializáló string-je (ha van ilyen) lesz az output (\fBis1\fR, \fBis2\fR, \fBis3\fR, \fBif\fR, \fBiprog\fR), (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. .TP \fBreset\fR az inicializáló string kiadása helyett a terminál reset-stringje kerül a kimenetre (\fBrs1\fR, \fBrs2\fR, \fBrs3\fR, \fBrf\fR) ha az létezik. Ha reset-string nincs, de inicializáló van, akkor az kerül a kimenetre. Egyébként a \fBreset\fR azonos az \fBinit\fR-tel. .TP \fBteljesnév\fR Ha a \fBterminfo\fR adatbázis létezik és van a felhasználó termináljának megfelelő bejegyzés (ld. \fB-T\fR\fItípus\fR, fent), akkor a terminál neve fog megjelenni. A név az utolsó név a \fBterminfo\fR adatbázis terminált leíró első sorbában [ld. \fBterm\fR(5)]. .SH PÉLDÁK .TP 5 \fBtput init\fR Inicializálja a terminált a \fBTERM\fR 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 \fBTERM\fR változó exportálásra került, ahogy az a \fBprofile\fR(4) oldalon olvasható. .TP 5 \fBtput -T5620 reset\fR alapállapotba hoz egy AT&T 5620-as terminált és felülírja a terminál típusát a \fBTERM\fR változóban. .TP 5 \fBtput cup 0 0\fR egy olyan szekvenciát küld a terminálnak, amely \fB0\fR. sor \fB0\fR. oszlopába (a képernyő bal felső sarka, általában "home" pozíciónak nevezik) viszi a kurzort. .TP 5 \fBtput clear\fR egy képernyőtörlés szekvenciát küld a terminálnak. .TP 5 \fBtput cols\fR kiírja az aktuális terminál oszlopainak számát. .TP 5 \fBtput -T450 cols\fR Kiírja a 450-es terminál oszlopainak számát. .TP 5 \fBtput bold=`tput smso` offbold=`tput rmso`\fR a \fBbold\fR shell változóba a terminálnak megfelelő "kiemelt-mód" kezdete karaktersorozatot, az \fBoffbold\fR shell változóba a "kiemelt-mód" vége szekvenciát teszi. Ezt esetleg követheti egy prompt: \fBecho "${bold} Kérem írja be a nevét: ${offbold}\\c"\fR .TP 5 \fBtput hc\fR az kilépési kód jelzi, hogy a terminál hardcopy terminál-e .TP 5 \fBtput cup 23 4\fR egy olyan szekvenciát küld a terminálnak, ami a kurzort 23. sor, 4. pozíciójába mozgatja. .TP 5 \fBtput longname\fR a \fBTERM\fR környezeti változóban specifikált terminál típushoz tartozó teljes nevet írja ki a \fBterminfo\fR adatbázis bejegyzéséből. .TP 0 \fBtput -S < clear\fR .br \fB> cup 10 10\fR .br \fB> bold\fR .br \fB> !\fR .TP 5 \& 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 (\fB!\fR) zárja. .SH FÁJLOK .TP \fB\*d\fR lefordított terminál leíró adatbázis .TP \fB/usr/include/curses.h\fR \fBncurses\fR(3NCURSES) header fájl .TP \fB/usr/include/term.h\fR \fBterminfo\fR header fájl .TP \fB/usr/share/tabset/*\fR 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" \fBterminfo\fR(4) részében. .SH LÁSD MÉG \fBclear\fR(1), \fBstty\fR(1), \fBtabs\fR(\*n). \fBprofile\fR(\*n), \fBterminfo\fR(4) \fIRendszer\fR \fIAdminisztrátorok\fR \fIkézikönyvében\fR. A Programozók Segédlet-ének 10. fejezetében. .SH VISSZATÉRÉSI ÉRTÉK (EXIT CODE) Ha a \fIcapname\fR logikai típusú, akkor az érték \fB0\fR TRUE esetén és \fB1\fR FALSE esetén kivéve, ha a az \fB-S\fR opció be van kapcsolva. Ha a \fIcapname\fR karakterlánc típusú, akkor \fB0\fR jelzi, hogy ez a képesség definiálva van ennél a terminál \fItípusnál\fR (az értéke a szabványos kimeneten jelenik meg); \fB1\fR jelzi, hogy ez a képesség nincs definiálva ennél a terminál \fItípusnál\fR (a szabványos kimeneten 0 jelenik meg). Ha a \fIcapname\fR logikai vagy karakteres típusú és a \fB-S\fR opciót használjuk, akkor \fB0\fR jelzi, hogy minden sor sikeres volt. Nem jelzi, hogy melyik sor végrehajtása volt sikertelen, így az \fB1\fR-es érték sohasem jelenik meg, a \fB2\fR, \fB3\fR és \fB4\fR kódok jelentése a szokásos. Ha a \fIcapname\fR egész típusú, akkor az érték mindig \fB0\fR 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 \fB-1\fR 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. .SH DIAGNOSZTIKÁK A \fBtput\fR a követkző hibaüzeneteket és hozzájuk tartozó kilépési értékeket adja. .TS l l. kilépési érték hibaüzenet \fB0\fR (a \fIcapname\fR egy egész érték, ami nincs meghatározva ehhez a terminálhoz a \fBterminfo\fR(\*n) adatbázisban, pl. \fBtput -T450 lines\fR és \fBtput -T2621 xmc\fR) \fB1\fR nem ír ki hibaüzenetet, ld. \fbKILÉPÉSI ÉRTÉK\fR-ok rész. \fB2\fR használati hiba \fB3\dR ismeretlen terminál \fItípus\fR, vagy nincs \fBterminfo\fR adatbázis. \fB4\fR ismeretlen \fBterminfo\fR képességnév .TE .SH ÁTJÁRHATÓSÁG A \fBlongname\fR és \fB-S\fR opciókat valamint a \fBcup\fR 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. .SH MAGYAR FORDÍTÁS Szalay Attila .\"# .\"# The following sets edit modes for GNU EMACS .\"# Local Variables: .\"# mode:nroff .\"# fill-column:79 .\"# End: