SETTERM(1) Polecenia uzytkownika SETTERM(1) NAZWA setterm - ustawia atrybuty terminala SKLADNIA setterm [opcje] OPIS setterm wypisuje na standardowe wyjscie lancuch znakow, ktory wykonuje podane wlasciwosci terminala. Tam, gdzie mozliwe, do znalezienia lancucha uzywa sie terminfo. Czesc opcji (zaznaczona ponizej jako "tylko konsole wirtualne") nie odpowiada wlasciwosciom terminfo(5). W tych przypadkach, jesli typ terminala to "con" lub "linux", wypisywany jest lancuch, ktory wywoluje pozadane wlasciwosci dla konsoli wirtualnej PC Minix. Opcje niezaimplementowane przez terminal sa ignorowane. OPCJE Dla opcji logicznych (on lub off) domyslna wartoscia jest on (wlaczone). Ponizej, kolor-8 moze byc: to black (czarny), red (czerwony), green (zielony), yellow (zolty), blue (niebieski), magenta (purpurowy), cyan (niebieskozielony) lub white (bialy). kolor-16 moze byc to: kolor-8 lub grey (szary) lub bright (jasno-), po ktorym nastepuje red (czerwony), green (zielony), yellow (zolty), blue (niebieski), magenta (purpurowy), cyan (niebieskozielony) lub white (bialy). Rozne opcje zwiazane z kolorami moga byc ustawione niezaleznie, przynajmniej na konsolach wirtualnych, chociaz wynik ustawienia wielu trybow (na przyklad --underline i --half-bright) zalezy od sprzetu. W przypadku argumentow opcjonalnych zaleca sie korzystanie z "=" (znaku rownosci) zamiast oddzielac opcje od argumentu spacja. Przyklad: --opcja=argument. setterm moze bowiem zinterpretowac nastepny argument niebedacy opcja rowniez jako opcjonalny argument. --appcursorkeys on|off Wlacza lub wylacza tryb Cursor Key Application. Gdy jest on wlaczony, dla klawiszy kursora beda wysylane ESC O A, ESC O B, itd. zamiast ESC [ A, ESC [ B, itd. Patrz sekcja vi i klucza kursora w Text-Terminal-HOWTO, aby przeczytac, jakie to moze spowodowac problemy dla uzytkownikow vi. Tylko konsole wirtualne. --append numer_konsoli Jak --dump, ale dopisuje stan konsoli do pliku zamiast nadpisywac jego zawartosc. Dziala tylko wtedy, gdy nie podano opcji --dump. --background kolor-8|default Ustawia kolor tla. --blank[=0-60|force|poke] Ustawia czas nieaktywnosci, w minutach, po ktorym ekran zostanie automatycznie wygaszony (przy uzyciu APM, jesli jest dostepne). Bez argumentu, sprawdza status wygaszania (zwraca terminal, ktory zostal wygaszony lub zero w przypadku niewygaszonego vt). Tylko konsole wirtualne. Argument force zachowuje wygaszenie ekranu nawet gdy wcisnieto jakis klawisz. Argument poke likwiduje wygaszenie ekranu. --bfreq[=liczba] Ustawia czestotliwosc dzwonka w Hz. Jezeli nie podano argumentu, to domyslna wartoscia jest 0. Tylko konsole wirtualne. --blength[=0-2000] Ustawia czas trwania dzwonka w milisekundach. Jezeli nie podano argumentu, to przyjmuje wartosc domyslna - 0. Tylko konsole wirtualne. --blink on|off Wlacza lub wylacza tryb migania. Poza konsolami wirtualnymi --blink off wylacza wszystkie atrybuty (wytluszczenie, polrozjasnienie, miganie, odwrocenie). --bold on|off Wlacza lub wylacza tryb wytluszczenia (ekstrajasny). Poza konsolami wirtualnymi --bold off wylacza wszystkie atrybuty (wytluszczenie, polrozjasnienie, miganie, odwrocenie). --clear[=all|rest] Bez argumentu lub z argumentem all, czyszczony jest caly ekran, a kursor jest ustawiany w pozycji poczatkowej, tak jak po zastosowaniu clear(1). Z argumentem rest ekran jest czyszczony od biezacej pozycji kursora do konca ekranu. --clrtabs[=tab1 tab2 tab3 ...] Czysci ustawienia tabulacji dla podanych pozycji poziomych kursora, w zakresie 1-160. Bez argumentow czysci wszystkie tabulacje. Tylko konsole wirtualne. --cursor on|off Wlacza lub wylacza kursor terminala. --default Ustawia opcje renderujace terminala na wartosci domyslne. --dump[=numer-konsoli] Zapisuje stan konsoli wirtualnej o podanym numerze do pliku podanego w opcji --file, nadpisujac jego zawartosc; domyslna nazwa pliku to screen.dump. Jesli nie podano argumentu, zapisuje stan obecnej konsoli wirtualnej. Przeslania opcje --append. --file nazwa-pliku Ustawia nazwe pliku dla opcji -dump lub -append podanych w tym samym wierszu polecenia. Jesli nie podano tej opcji, domyslna nazwa pliku jest screen.dump w biezacym katalogu. Sciezka, ktorej nazwa przekracza systemowe wartosci dopuszczalne, jest skracana (wartosc ta to PATH_MAX w linux/limits.h). --foreground kolor-8|default Ustawia kolor tekstu. --half-bright on|off Wlacza lub wylacza tryb polrozjasnienia. Poza konsolami wirtualnymi --half-bright off wylacza wszystkie atrybuty (wytluszczenie, polrozjasnienie, miganie, odwrocenie). --hbcolor kolor-16 Ustawia kolor znakow polrozjasnionych. --initialize Wyswietla lancuch inicjalizacji terminala, ktory zwykle ustawia opcje renderujace terminala i inne atrybuty, na wartosci domyslne. --inversescreen on|off Zamienia kolory pierwszego planu i tla na calym ekranie. --linewrap on|off Po wyczerpaniu miejsca w biezacym wierszu, terminal zawija go do nowego wiersza. --msg on|off Wlacza lub wylacza wysylanie przez jadro komunikatow printk() do konsoli. Tylko konsole wirtualne. --msglevel 0-8 Ustawia poziom logowania konsoli dla komunikatow jadra printk(). Beda wypisywane wszystkie komunikaty o wyzszym poziomie, tak wiec ustawienie poziomu na 0 da ten sam efekt co --msg on, a logowanie z poziomem 8 wypisze wszystkie komunikaty jadra. klogd(8) moze byc bardziej dogodnym interfejsem do ustawiania poziomu logowania komunikatow jadra. Tylko konsole wirtualne. --powerdown[=0-60] Ustawia czas wylaczenia VESA w minutach. Jezeli nie podano argumentu, ustawia na domyslna wartosc 0 (wylaczenie tej opcji). Jezeli konsola jest wygaszona lub gdy monitor jest w trybie uspienia, to monitor przejdzie odpowiednio w tryb vsync uspienia lub wylaczenia, gdy ten czas uplynie. --powersave tryb Prawidlowymi wartosciami trybu sa: vsync|on Ustawia monitor w tryb uspienia (VESA vsync suspend). hsync Ustawia monitor w tryb uspienia (VESA hsync suspend). powerdown Ustawia monitor w tryb wylaczenia (VESA powerdown). off Wylacza wlasciwosci zachowywania energii monitora. --regtabs[=1-160] Czysci wszystkie tabulacje, a potem ustawia regularny wzorzec tabulacji z jedna tabulacja dla kazdej okreslonej liczby pozycji. Bez argumentow przyjmuje wartosc domyslna - 8. Tylko konsole wirtualne. --repeat on|off Wlacza lub wylacza powtarzanie klawiszy. Tylko konsole wirtualne. --reset Wyswietla lancuch resetowania terminala, ktory zwykle resetuje terminal do stanu wlaczenia. --resize Resetuje rozmiar terminala, oceniajac ostatni wiersz i kolumne. Jest to przydatne, gdy faktyczna geometria nie jest zsynchronizowana ze sterownikiem terminala jadra. Uzyteczne przede wszystkim na konsolach szeregowych niekorzystajacych z ioctl(2), lecz jedynie przelaman i strumieni bajtowych. --reverse on|off Wlacza lub wylacza tryb odwrocenia obrazu. Poza konsolami wirtualnymi --reverse off wylacza wszystkie atrybuty (wytluszczenie, polrozjasnienie, miganie, odwrocenie). --store Zapisuje biezace opcje renderujace terminala (kolory czcionki i tla) jako wartosci, ktore beda uzywane przy resetowaniu do wartosci domyslnych. Tylko konsole wirtualne. --tabs[=tab1 tab2 tab3 ...] Ustawia poziome pozycje kursora dla tabulacji w zakresie 1-160. Bez argumentow pokazuje obecne ustawienia tabulacji. --term nazwa_terminala Nadpisuje wartosc zmiennej srodowiskowej TERM. --ulcolor kolor-16 Ustawia kolor znakow podkreslonych. Tylko konsole wirtualne. --underline on|off Wlacza lub wylacza tryb podkreslania. -h, --help Wyswietla ten tekst i wychodzi. -V, --version Wyswietla wersje i wychodzi. OSTRZEZENIE Korzystanie z setterm w polaczeniu z przekierowaniem standardowego wyjscia moze przyniesc niezamierzone rezultaty, poniewaz niektore opcje dzialaja na standardowym wejsciu. Aby zapobiec takim problemom, standardowe wejscie i wyjscie zawsze nalezy przekierowywac lacznie do tego samego urzadzenia. ZGODNOSC Od wersji 2.25 setterm obsluguje dlugie opcje z dwoma myslnikami np. --help, oprocz dawnych dlugich opcji z pojedynczym myslnikiem np. -help. W skryptach zaleca sie uzywanie zgodnego wstecznie zapisu z pojedynczym myslnikiem. Obecnie nie ma planow, ani tez dobrych powodow, aby zarzucic obsluge opcji z pojedynczym myslnikiem. USTERKI Nie sa udokumentowane roznice miedzy wersjami Miniksa i Linuksa. ZOBACZ TAKZE stty(1), tput(1), tty(4), terminfo(5) ZGLASZANIE BLEDOW Problemy nalezy zglaszac w systemie sledzenia bledow . DOSTEPNOSC Polecenie setterm jest czescia pakietu util-linux, ktory mozna pobrac ze strony Archiwum jadra Linux . util-linux 2.41 2025-03-29 SETTERM(1)