setterm - ustawia atrybuty terminala
setterm wypisuje na standardowe wyjście
łańcuch znaków, który wykonuje podane
właściwości terminala. Tam, gdzie możliwe, do
znalezienia łańcucha używa się terminfo.
Część opcji jednak (zaznaczona poniżej jako
"tylko konsole wirtualne") nie odpowiada
właściwościom terminfo(5). W tym wypadku,
jeśli typ terminala to "con" lub "linux",
drukowany jest łańcuch, który wywołuje
pożądane właściwości dla sterownika
konsoli wirtualnej PC Minix. Opcje niezaimplementowane przez terminal
są ignorowane.
Dla opcji logicznych (on lub off)
domyślną wartością jest on.
Poniżej kolor-8 może być to
black (czarny), red (czerwony), green (zielony),
yellow (żółty), blue (niebieski),
magenta (purpurowy), cyan (niebieskozielony) lub white
(biały).
kolor-16 może być to kolor-8 lub
grey (szary) lub bright (jasno-), po którym
następuje red (czerwony), green (zielony),
yellow (żółty), blue (niebieski),
magenta (purpurowy), cyan (niebieskozielony) lub white
(biały).
Różne opcje związane z kolorami mogą
być ustawione niezależnie, przynajmniej na konsolach
wirtualnych, chociaż wynik ustawienia wielu trybów (na
przykład --underline i --half-bright) zależy od
sprzętu.
- -appcursorkeys
[on|off] (tylko konsole wirtualne)
- Włącza lub wyłącza tryb Cursor Key
Application. Gdy jest on włączony dla klawiszy kursora
będą wysyłane ESC O A, ESC O B, itd. zamiast ESC [ A,
ESC [ B, itd. Patrz sekcja vi i klucza kursora w
Text-Terminal-HOWTO, aby przeczytać, jakie to może
spowodować problemy dla użytkowników vi.
- --append
[numer_konsoli]
- Jak --dump, ale dopisuje stan konsoli do pliku zamiast
nadpisywać jego zawartość. Działa tylko wtedy,
gdy nie podano opcji --dump.
- --background
kolor-8|default
- Ustawia kolor tła.
- --blank
[0-60|force|poke] (tylko konsole wirtualne)
- Ustawia czas nieaktywności, w minutach, po którym ekran
zostanie automatycznie wygaszony (przy użyciu APM, jeśli
jest dostępne). Bez argumentu, sprawdza status wygaszania (zwraca
terminal, który został wygaszony lub zero w przypadku
niewygaszonego vt).
- Opcja force zachowuje wygaszenie ekranu nawet gdy
wciśnięto jakiś klawisz.
- Opcja poke likwiduje wygaszenie.
- --bfreq
[liczba] (tylko konsole wirtualne)
- Ustawia częstotliwość dzwonka w Hz. Jeżeli nie
podano argumentu, to domyślną wartością jest
0.
- --blength
[0-2000] (tylko konsole wirtualne)
- Ustawia czas trwania dzwonka w milisekundach. Jeżeli nie podano
argumentu, to przyjmuje wartość domyślną -
0.
- --blink
[on|off]
- Włącza lub wyłącza tryb migania. Poza
konsolami wirtualnymi --blink off wyłącza wszystkie
atrybuty (wytłuszczenie, półrozjaśnienie,
miganie, odwrócenie).
- --bold
[on|off]
- Włącza lub wyłącza tryb wytłuszczenia
(ekstrajasny). Poza konsolami wirtualnymi --bold off
wyłącza wszystkie atrybuty (wytłuszczenie,
półrozjaśnienie, miganie, odwrócenie).
- --clear
[all|rest]
- Bez argumentu lub z argumentem all, czyszczony jest cały
ekran, a kursor jest ustawiany w pozycji początkowym, tak jak po
zastosowaniu clear(1). Z argumentem rest ekran jest
czyszczony od bieżącej pozycji kursora do końca
ekranu.
- --clrtabs
[tab1 tab2 tab3 ...] (tylko konsole wirtualne)
- Czyści ustawienia tabulacji dla podanych pozycji poziomych kursora,
w zakresie 1-160. Bez argumentów czyści
wszystkie tabulacje.
- --cursor
[on|off]
- Włącza lub wyłącza kursor terminala.
- --default
- Ustawia opcje renderujące terminala na wartości
domyślne.
- --dump
[numer_konsoli]
- Zapisuje stan konsoli wirtualnej o podanym numerze do pliku podanego w
opcji --file, nadpisując jego zawartość;
domyślna nazwa pliku to screen.dump. Jeśli nie podano
argumentu, zapisuje stan obecnej konsoli wirtualnej. Przesłania
opcję --append.
- --file
nazwa-pliku
- Ustawia nazwę pliku dla opcji -dump lub -append
podanych w tej samej linii poleceń. Jeśli nie podano tej
opcji, domyślną nazwą pliku jest screen.dump w
bieżącym katalogu. Ścieżka której nazwa
przekracza systemowe wartości dopuszczalne jest skracana
(wartość ta to PATH_MAX w linux/limits.h).
- --foreground
kolor-8|default
- Ustawia kolor tekstu.
- --half-bright
[on|off]
- Włącza lub wyłącza tryb
półrozjaśnienia. Poza konsolami wirtualnymi
-half-bright off wyłącza wszystkie atrybuty
(wytłuszczenie, półrozjaśnienie, miganie,
odwrócenie).
- --hbcolor
kolor-16
- Ustawia kolor znaków pogrubionych.
- --initialize
- Wyświetla łańcuch inicjacji terminala, który
zwykle ustawia opcje terminala na wartości domyślne.
- --inversescreen
[on|off]
- Zamienia kolory pierwszego planu i tła na całym
ekranie.
- --linewrap
[on|off]
- Po wyczerpaniu miejsca w bieżącym wierszu, terminal zawija
go do nowego wiersza.
- --msg
[on|off] (tylko konsole wirtualne)
- Włącza lub wyłącza wysyłanie przez
jądro komunikatów printk() do konsoli.
- --msglevel
0-8 (tylko konsole wirtualne)
- Ustawia poziom logowania konsoli dla wiadomości jądra
printk(). Będą wypisywane wszystkie wiadomości
o wyższym poziomie, tak więc ustawienie poziomu na 0
da ten sam efekt co --msg on, a logowanie z poziomem 8
wypisze wszystkie komunikaty jądra. klogd(8) może
być bardziej dogodnym interfejsem do ustawiania poziomu logowania
komunikatów jądra.
- --powerdown
[0-60]
- Ustawia czas wyłączenia VESA w minutach. Jeżeli nie
podano argumentu, ustawia na domyślną wartość
0 (wyłączenie tej opcji). Jeżeli konsola jest
wygaszona lub gdy monitor jest w trybie suspend, to monitor przejdzie
odpowiednio w tryb vsync suspend lub wyłączenia, gdy ten
czas upłynie.
- --powersave
off
- Wyłącza właściwości zachowywania
energii monitorów zgodnych z VESA.
- --powersave
on|vsync
- Ustawia monitor w tryb VESA vsync suspend.
- --powersave
powerdown
- Ustawia monitor w tryb VESA powerdown.
- --powersave
hsync
- Ustawia monitor w tryb VESA hsync suspend.
- --regtabs
[1-160] (tylko konsole wirtualne)
- Czyści wszystkie tabulacje, a potem ustawia regularny wzorzec
tabulacji z jedną tabulacją dla każdej
określonej liczby pozycji. Bez argumentów przyjmuje
wartość domyślną - 8.
- --repeat
[on|off] (tylko konsole wirtualne)
- Włącza lub wyłącza powtarzanie klawiszy.
- --reset
- Wyświetla łańcuch resetowania terminala, który
zwykle resetuje terminal do stanu włączenia.
- --reverse
[on|off]
- Włącza lub wyłącza tryb odwrócenia
obrazu. Poza konsolami wirtualnymi -reverse off
wyłącza wszystkie atrybuty (wytłuszczenie,
półrozjaśnienie, miganie, odwrócenie).
- --store (tylko
konsole wirtualne)
- Zapisuje bieżące opcje renderujące terminala (kolory
czcionki i tła) jako wartości domyślne.
- --tabs [tab1 tab2
tab3 ...]
- Ustawia poziome pozycje kursora dla tabulacji w zakresie 1-160. Bez
argumentów pokazuje obecne ustawienia tabulacji.
- --term
nazwa_terminala
- Nadpisuje wartość zmiennej środowiskowej TERM.
- --ulcolor
kolor-16 (tylko konsole wirtualne)
- Ustawia kolor znaków podkreślonych.
- --underline
[on|off]
- Włącza lub wyłącza tryb
podkreślania.
- --version
- Wypisuje informację o wersji programu i wychodzi.
- --help
- Wyświetla pomoc i wychodzi.
Od wersji 2.25 setterm obsługuje długie opcje
z dwoma myślnikami np. --help, oprócz dawnych
długim opcji z pojedynczym myślnikiem np. -help. W
skryptach zaleca się używanie zgodnego wstecznie zapisu
z pojedynczym myślnikiem. Obecnie nie ma planów, ani
też dobrych powodów, aby
zarzucić obsługę opcji z pojedynczym
myślnikiem.
Nie są udokumentowane różnice między
wersjami Miniksa i Linuksa.
Autorami polskiego tłumaczenia niniejszej strony
podręcznika man są: Przemek Borys (PTM)
<pborys@dione.ids.pl>, Robert Luberda (PTM) <robert@debian.org>
i Michał Kułach <michal.kulach@gmail.com>.
Polskie tłumaczenie jest częścią
projektu manpages-pl; uwagi, pomoc, zgłaszanie
błędów na stronie
http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją
2.28 oryginału.