'\" t
.\"     Title: setterm
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-03-29
.\"    Manual: Polecenia użytkownika
.\"    Source: util-linux 2.41
.\"  Language: English
.\"
.TH "SETTERM" "1" "2025-03-29" "util\-linux 2.41" "Polecenia użytkownika"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAZWA"
setterm \- ustawia atrybuty terminala
.SH "SKŁADNIA"
.sp
\fBsetterm\fP [opcje]
.SH "OPIS"
.sp
\fBsetterm\fP 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ę \fIterminfo\fP. Część opcji (zaznaczona poniżej jako "tylko konsole wirtualne") nie odpowiada właściwościom \fBterminfo\fP(5). W tych przypadkach, jeśli typ terminala to "con" lub "linux", wypisywany jest łańcuch, który wywołuje pożądane właściwości dla konsoli wirtualnej PC Minix. Opcje niezaimplementowane przez terminal są ignorowane.
.SH "OPCJE"
.sp
Dla opcji logicznych (\fBon\fP lub \fBoff\fP) domyślną wartością jest \fBon\fP (włączone).
.sp
Poniżej, \fIkolor\-8\fP może być: to \fBblack\fP (czarny), \fBred\fP (czerwony), \fBgreen\fP (zielony), \fByellow\fP (żółty), \fBblue\fP (niebieski), \fBmagenta\fP (purpurowy), \fBcyan\fP (niebieskozielony) lub \fBwhite\fP (biały).
.sp
\fIkolor\-16\fP może być to: \fIkolor\-8\fP lub \fBgrey\fP (szary) lub \fBbright\fP (jasno\-), po którym następuje \fBred\fP (czerwony), \fBgreen\fP (zielony), \fByellow\fP (żółty), \fBblue\fP (niebieski), \fBmagenta\fP (purpurowy), \fBcyan\fP (niebieskozielony) lub \fBwhite\fP (biały).
.sp
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 \fB\-\-underline\fP i \fB\-\-half\-bright\fP) zależy od sprzętu.
.sp
W przypadku argumentów opcjonalnych zaleca się korzystanie z "=" (znaku równości) zamiast oddzielać opcję od argumentu spacją. Przykład: \-\-opcja=argument. \fBsetterm\fP może bowiem zinterpretować następny argument niebędący opcją również jako opcjonalny argument.
.sp
\fB\-\-appcursorkeys\fP \fBon\fP|\fBoff\fP
.RS 4
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 \fIvi i klucza kursora\fP w \fIText\-Terminal\-HOWTO\fP, aby przeczytać, jakie to może spowodować problemy dla użytkowników \fBvi\fP. Tylko konsole wirtualne.
.RE
.sp
\fB\-\-append\fP \fInumer_konsoli\fP
.RS 4
Jak \fB\-\-dump\fP, ale dopisuje stan konsoli do pliku zamiast nadpisywać jego zawartość. Działa tylko wtedy, gdy nie podano opcji \fB\-\-dump\fP.
.RE
.sp
\fB\-\-background\fP \fIkolor\-8\fP|\fBdefault\fP
.RS 4
Ustawia kolor tła.
.RE
.sp
\fB\-\-blank\fP[\fB=0\fP\-\fB60\fP|\fBforce\fP|\fBpoke\fP]
.RS 4
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). Tylko konsole wirtualne.
.sp
Argument \fBforce\fP zachowuje wygaszenie ekranu nawet gdy wciśnięto jakiś klawisz.
.sp
Argument \fBpoke\fP likwiduje wygaszenie ekranu.
.RE
.sp
\fB\-\-bfreq\fP[\fB=\fP\fIliczba\fP]
.RS 4
Ustawia częstotliwość dzwonka w Hz. Jeżeli nie podano argumentu, to domyślną wartością jest \fB0\fP. Tylko konsole wirtualne.
.RE
.sp
\fB\-\-blength\fP[\fB=0\fP\-\fB2000\fP]
.RS 4
Ustawia czas trwania dzwonka w milisekundach. Jeżeli nie podano argumentu, to przyjmuje wartość domyślną \- \fB0\fP. Tylko konsole wirtualne.
.RE
.sp
\fB\-\-blink\fP \fBon\fP|\fBoff\fP
.RS 4
Włącza lub wyłącza tryb migania. Poza konsolami wirtualnymi \fB\-\-blink off\fP wyłącza wszystkie atrybuty (wytłuszczenie, półrozjaśnienie, miganie, odwrócenie).
.RE
.sp
\fB\-\-bold\fP \fBon\fP|\fBoff\fP
.RS 4
Włącza lub wyłącza tryb wytłuszczenia (ekstrajasny). Poza konsolami wirtualnymi \fB\-\-bold off\fP wyłącza wszystkie atrybuty (wytłuszczenie, półrozjaśnienie, miganie, odwrócenie).
.RE
.sp
\fB\-\-clear\fP[\fB=all\fP|\fBrest\fP]
.RS 4
Bez argumentu lub z argumentem \fBall\fP, czyszczony jest cały ekran, a kursor jest ustawiany w pozycji początkowej, tak jak po zastosowaniu \fBclear\fP(1). Z argumentem \fBrest\fP ekran jest czyszczony od bieżącej pozycji kursora do końca ekranu.
.RE
.sp
\fB\-\-clrtabs\fP[\fB=\fP\fItab1 tab2 tab3\fP ...]
.RS 4
Czyści ustawienia tabulacji dla podanych pozycji poziomych kursora, w zakresie \fB1\fP\-\fB160\fP. Bez argumentów czyści wszystkie tabulacje. Tylko konsole wirtualne.
.RE
.sp
\fB\-\-cursor\fP \fBon\fP|\fBoff\fP
.RS 4
Włącza lub wyłącza kursor terminala.
.RE
.sp
\fB\-\-default\fP
.RS 4
Ustawia opcje renderujące terminala na wartości domyślne.
.RE
.sp
\fB\-\-dump\fP[\fB=\fP\fInumer\-konsoli\fP]
.RS 4
Zapisuje stan konsoli wirtualnej o podanym numerze do pliku podanego w opcji \fB\-\-file\fP, nadpisując jego zawartość; domyślna nazwa pliku to \fIscreen.dump\fP. Jeśli nie podano argumentu, zapisuje stan obecnej konsoli wirtualnej. Przesłania opcję \fB\-\-append\fP.
.RE
.sp
\fB\-\-file\fP \fInazwa\-pliku\fP
.RS 4
Ustawia nazwę pliku dla opcji \fB\-dump\fP lub \fB\-append\fP podanych w tym samym wierszu polecenia. Jeśli nie podano tej opcji, domyślną nazwą pliku jest \fIscreen.dump\fP w bieżącym katalogu. Ścieżka, której nazwa przekracza systemowe wartości dopuszczalne, jest skracana (wartość ta to \fBPATH_MAX\fP w \fIlinux/limits.h\fP).
.RE
.sp
\fB\-\-foreground\fP \fIkolor\-8\fP|\fBdefault\fP
.RS 4
Ustawia kolor tekstu.
.RE
.sp
\fB\-\-half\-bright\fP \fBon\fP|\fBoff\fP
.RS 4
Włącza lub wyłącza tryb półrozjaśnienia. Poza konsolami wirtualnymi \fB\-\-half\-bright off\fP wyłącza wszystkie atrybuty (wytłuszczenie, półrozjaśnienie, miganie, odwrócenie).
.RE
.sp
\fB\-\-hbcolor\fP \fIkolor\-16\fP
.RS 4
Ustawia kolor znaków półrozjaśnionych.
.RE
.sp
\fB\-\-initialize\fP
.RS 4
Wyświetla łańcuch inicjalizacji terminala, który zwykle ustawia opcje renderujące terminala i inne atrybuty, na wartości domyślne.
.RE
.sp
\fB\-\-inversescreen\fP \fBon\fP|\fBoff\fP
.RS 4
Zamienia kolory pierwszego planu i tła na całym ekranie.
.RE
.sp
\fB\-\-linewrap\fP \fBon\fP|\fBoff\fP
.RS 4
Po wyczerpaniu miejsca w bieżącym wierszu, terminal zawija go do nowego wiersza.
.RE
.sp
\fB\-\-msg\fP \fBon\fP|\fBoff\fP
.RS 4
Włącza lub wyłącza wysyłanie przez jądro komunikatów \fBprintk\fP() do konsoli. Tylko konsole wirtualne.
.RE
.sp
\fB\-\-msglevel\fP \fB0\fP\-\fB8\fP
.RS 4
Ustawia poziom logowania konsoli dla komunikatów jądra \fBprintk()\fP. Będą wypisywane wszystkie komunikaty o wyższym poziomie, tak więc ustawienie poziomu na \fB0\fP da ten sam efekt co \fB\-\-msg on\fP, a logowanie z poziomem \fB8\fP wypisze wszystkie komunikaty jądra. \fBklogd\fP(8) może być bardziej dogodnym interfejsem do ustawiania poziomu logowania komunikatów jądra.
.sp
Tylko konsole wirtualne.
.RE
.sp
\fB\-\-powerdown\fP[\fB=0\fP\-\fB60\fP]
.RS 4
Ustawia czas wyłączenia VESA w minutach. Jeżeli nie podano argumentu, ustawia na domyślną wartość \fB0\fP (wyłączenie tej opcji). Jeżeli konsola jest wygaszona lub gdy monitor jest w trybie uśpienia, to monitor przejdzie odpowiednio w tryb vsync uśpienia lub wyłączenia, gdy ten czas upłynie.
.RE
.sp
\fB\-\-powersave\fP \fItryb\fP
.RS 4
Prawidłowymi wartościami \fItrybu\fP są:
.sp
\fBvsync\fP|\fBon\fP
.RS 4
Ustawia monitor w tryb uśpienia (VESA vsync suspend).
.RE
.sp
\fBhsync\fP
.RS 4
Ustawia monitor w tryb uśpienia (VESA hsync suspend).
.RE
.sp
\fBpowerdown\fP
.RS 4
Ustawia monitor w tryb wyłączenia (VESA powerdown).
.RE
.sp
\fBoff\fP
.RS 4
Wyłącza właściwości zachowywania energii monitora.
.RE
.RE
.sp
\fB\-\-regtabs\fP[\fB=1\fP\-\fB160\fP]
.RS 4
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ą \- \fB8\fP. Tylko konsole wirtualne.
.RE
.sp
\fB\-\-repeat\fP \fBon\fP|\fBoff\fP
.RS 4
Włącza lub wyłącza powtarzanie klawiszy. Tylko konsole wirtualne.
.RE
.sp
\fB\-\-reset\fP
.RS 4
Wyświetla łańcuch resetowania terminala, który zwykle resetuje terminal do stanu włączenia.
.RE
.sp
\fB\-\-resize\fP
.RS 4
Resetuje rozmiar terminala, oceniając ostatni wiersz i kolumnę. Jest to przydatne, gdy faktyczna geometria nie jest zsynchronizowana ze sterownikiem terminala jądra. Użyteczne przede wszystkim na konsolach szeregowych niekorzystających z \fBioctl\fP(2), lecz jedynie przełamań i strumieni bajtowych.
.RE
.sp
\fB\-\-reverse\fP \fBon\fP|\fBoff\fP
.RS 4
Włącza lub wyłącza tryb odwrócenia obrazu. Poza konsolami wirtualnymi \fB\-\-reverse off\fP wyłącza wszystkie atrybuty (wytłuszczenie, półrozjaśnienie, miganie, odwrócenie).
.RE
.sp
\fB\-\-store\fP
.RS 4
Zapisuje bieżące opcje renderujące terminala (kolory czcionki i tła) jako wartości, które będą używane przy resetowaniu do wartości domyślnych. Tylko konsole wirtualne.
.RE
.sp
\fB\-\-tabs\fP[\fB=\fP\fItab1 tab2 tab3\fP ...]
.RS 4
Ustawia poziome pozycje kursora dla tabulacji w zakresie \fB1\fP\-\fB160\fP. Bez argumentów pokazuje obecne ustawienia tabulacji.
.RE
.sp
\fB\-\-term\fP \fInazwa_terminala\fP
.RS 4
Nadpisuje wartość zmiennej środowiskowej \fBTERM\fP.
.RE
.sp
\fB\-\-ulcolor\fP \fIkolor\-16\fP
.RS 4
Ustawia kolor znaków podkreślonych. Tylko konsole wirtualne.
.RE
.sp
\fB\-\-underline\fP \fBon\fP|\fBoff\fP
.RS 4
Włącza lub wyłącza tryb podkreślania.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.SH "OSTRZEŻENIE"
.sp
Korzystanie z \fBsetterm\fP w połączeniu z przekierowaniem standardowego wyjścia może przynieść niezamierzone rezultaty, ponieważ niektóre opcje działają na standardowym wejściu. Aby zapobiec takim problemom, standardowe wejście i wyjście zawsze należy przekierowywać łącznie do tego samego urządzenia.
.SH "ZGODNOŚĆ"
.sp
Od wersji 2.25 \fBsetterm\fP obsługuje długie opcje z dwoma myślnikami np. \fB\-\-help\fP, oprócz dawnych długich opcji z pojedynczym myślnikiem np. \fB\-help\fP. 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.
.SH "USTERKI"
.sp
Nie są udokumentowane różnice między wersjami Miniksa i Linuksa.
.SH "ZOBACZ TAKŻE"
.sp
\fBstty\fP(1), \fBtput\fP(1), \fBtty\fP(4), \fBterminfo\fP(5)
.SH "ZGŁASZANIE BŁĘDÓW"
.sp
Problemy należy zgłaszać w \c
.URL "https://github.com/util\-linux/util\-linux/issues" "systemie śledzenia błędów" "."
.SH "DOSTĘPNOŚĆ"
.sp
Polecenie \fBsetterm\fP jest częścią pakietu util\-linux, który można pobrać ze strony \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Archiwum jądra Linux" "."