'\" t
.\"     Title: agetty
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: Administracja systemem
.\"    Source: util-linux 2.42.3
.\"  Language: English
.\"
.TH "AGETTY" "8" "2026-09-02" "util\-linux 2.42.3" "Administracja systemem"
.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"
agetty \- alternatywne linuksowe getty
.SH "SKŁADNIA"
.sp
\fBagetty\fP [opcje] \fIport\fP [\fIszybkość\-w\-bodach\fP.\|.\|.] [\fIterm\fP]
.SH "OPIS"
.sp
\fBagetty\fP otwiera port tty, prosi o login i wywołuje polecenie /bin/login. Jest zwykle przywoływany przez \fBinit\fP(8).
.sp
\fBagetty\fP ma wiele \fIniestandardowych\fP funkcji przydatnych przy liniach połączonych bezpośrednio i wdzwanianych:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Dostosowuje ustawienia tty do bitów parzystości oraz znaków kasowania, usuwania wiersza, końca wiersza oraz wielkich liter, przy odczytywaniu loginu. Program może obsłużyć znaki 7\-bitowe z parzystością ustawioną na parzystość, nieparzystość, brak albo pseudoparzystość z bitem zerowym (ang. space parity) oraz znaki 8\-bitowe bez parzystości. Obsługiwane są następujące znaki specjalne: Control\-U (usunięcie wiersza); DEL oraz backspace (kasowanie); powrót karetki i wysuw wiersza (koniec wiersza). Zob. też opcje \fB\-\-erase\-chars\fP i \fB\-\-kill\-chars\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Opcjonalnie dedukuje szybkość w bodach na podstawie komunikatów CONNECT wypisywanych przez modemy kompatybilne z Hayes(tm).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Opcjonalnie nie rozłącza się gdy linia jest już otwarta (przydatne przy aplikacji oddzwaniania).
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Opcjonalnie nie wyświetla zawartości pliku \fI/etc/issue\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Opcjonalnie wyświetla alternatywne pliki lub katalogi issue, zamiast \fI/etc/issue\fP lub \fI/etc/issue.d\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Opcjonalnie nie pyta o login.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Opcjonalnie wywołuje niestandardowy program logowania zamiast \fI/bin/login\fP.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Opcjonalnie włącza sprzętową kontrolę przepływu.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
Opcjonalnie wymusza traktowanie linii jako lokalnej, bez konieczności wykrywania nośnej.
.RE
.sp
Niniejszy program nie korzysta z plików \fI/etc/gettydefs\fP (System V) lub \fI/etc/gettytab\fP (SunOS 4).
.SH "ARGUMENTY"
.sp
\fIport\fP
.RS 4
Ścieżka względna do katalogu \fI/dev\fP. Jeśli poda się "\-", \fBagetty\fP przyjmuje że jego standardowe wejście jest już połączone z portem tty i że połączenie ze zdalnym użytkownikiem zostało już nawiązane.
.sp
W Systemie V, argument \fIport\fP równy "\-" trzeba poprzedzić łańcuchem "\-\-".
.RE
.sp
\fIszybkość\-w\-bodach\fP,.\|.\|.
.RS 4
Lista jednej lub więcej szybkości w bodach, rozdzielonych przecinkiem. Za każdym razem, gdy \fBagetty\fP otrzyma znak BREAK, przechodzi do następnej pozycji w liście, traktowanej jako zapętlona.
.sp
Szybkości w bodach powinno się podawać w kolejności malejącej, dzięki czemu do przełączania szybkości można stosować też znak null (Ctrl\-@).
.sp
Argument opcjonalny i zbędny w przypadku \fBterminali wirtualnych\fP.
.sp
Domyślnym ustawieniem dla \fBterminali szeregowych\fP jest utrzymanie obecnej szybkości w bodach (zob. \fB\-\-keep\-baud\fP), a jeśli to się nie powiedzie, zastosowanie wartości domyślnej "9600".
.RE
.sp
\fIterm\fP
.RS 4
Wartość jaką przyjmie zmienna środowiskowa \fBTERM\fP. Przesłania wartość, jaką mógł ustawić \fBinit\fP(1); jest ona dziedziczona przez login i powłokę.
.sp
Domyślnie jest to "vt100", albo "linux" w przypadku Linuksa na terminalu wirtualnym, albo "hurd" w przypadku GNU Hurd na terminalu wirtualnym.
.RE
.SH "OPCJE"
.sp
\fB\-8\fP, \fB\-\-8bits\fP
.RS 4
Przyjmuje, że tty jest 8\-bitowy, zatem wyłącza wykrywanie parzystości.
.RE
.sp
\fB\-a\fP, \fB\-\-autologin\fP \fInazwa\-użytkownika\fP
.RS 4
Automatycznie loguje podanego użytkownika bez pytania o jego nazwę i hasło. Zastosowanie tej opcji powoduje, że do wiersza polecenia \fB/bin/login\fP dodawana jest opcja i argument \fB\-f\fP \fInazwa\-użytkownika\fP. Zob. opcję \fB\-\-login\-options\fP, którą można zmodyfikować zachowanie tej opcji.
.sp
Proszę zauważyć, że opcja \fB\-\-autologin\fP może wpłynąć na sposób inicjowania przez \fBgetty\fP linii szeregowej, ponieważ przy automatycznym logowaniu, \fBagetty\fP nie odczytuje z linii i nie ma okazji do optymalizacji jej ustawień.
.RE
.sp
\fB\-c\fP, \fB\-\-noreset\fP
.RS 4
Nie resetuje cflag terminala (trybów kontroli). Więcej szczegółów w podręczniku \fBtermios\fP(3).
.RE
.sp
\fB\-E\fP, \fB\-\-remote\fP
.RS 4
Zwykle polecenie \fBlogin\fP(1) otrzymuje zdalną nazwę stacji (hostname) przy wywoływaniu przez coś takiego jak \fBtelnetd\fP(8). Niniejsza opcja pozwala na przekazanie przez \fBagetty\fP tego, co używa on jako nazwę stacji do programu \fBlogin\fP(1) w celu zastosowania w \fButmp\fP(5). Zob. \fB\-\-host\fP, \fBlogin\fP(1) i \fButmp\fP(5).
.sp
Jeśli poda się opcję \fB\-\-host\fP \fIfałszywa\-stacja\fP, to do wiersza polecenia \fI/bin/login\fP dodawana jest opcja i argument \fB\-h\fP \fIfałszywa\-stacja\fP.
.sp
Jeśli poda się opcję \fB\-\-nohostname\fP, to do wiersza polecenia \fB/bin/login\fP dodawana jest opcja \fB\-H\fP.
.sp
Zob. \fB\-\-login\-options\fP.
.RE
.sp
\fB\-f\fP, \fB\-\-issue\-file\fP \fIścieżka\fP
.RS 4
Określa listę plików i katalogów rozdzielonych znakiem ":", które będą wyświetlone zamiast \fI/etc/issue\fP (lub odpowiednika). Wyświetlane są wszystkie podane pliki i katalogi, a brakujące lub puste pliki są po cichu ignorowane. Jeśli podana ścieżka jest katalogiem, to wyświetla wszystkie pliki z rozszerzeniem \fI.issue\fP w tym katalogu, w kolejności numeru wersji. Można w ten sposób wyświetlać dostosowane komunikaty na różnych terminalach. Opcja \fB\-\-noissue\fP przesłoni niniejszą opcję.
.RE
.sp
\fB\-\-show\-issue\fP
.RS 4
Wyświetla aktualny plik issue (lub odpowiednik) na bieżącym terminalu i wychodzi. Opcja ta służy do sprawdzenia aktualnego ustawienia, nie została zaprojektowana do żadnego innego celu. Proszę zauważyć, że wynik może używać jaki informacji domyślnych lub niepełnych, a prawidłowe wyjście zależy od terminala i wiersza polecenia \fBagetty\fP.
.RE
.sp
\fB\-h, \-\-flow\-control\fP
.RS 4
Włącza sprzętową (RTS/CTS) kontrolę przepływu. Wyłączenie programowej (XON/XOFF) kontroli przepływu, tam gdzie to konieczne, pozostawia się aplikacji.
.RE
.sp
\fB\-H\fP, \fB\-\-host\fP \fIfałszywa\-stacja\fP
.RS 4
Zapisuje podaną \fIfałszywą\-stację\fP do pliku utmp. Zwykle nie podaje się stacji logowania, ponieważ \fBagetty\fP jest stosowany do lokalnych, stałych połączeń i konsol. Jednak opcja może być przydatna do identyfikacji koncentratorów terminali i tym podobnych.
.RE
.sp
\fB\-i\fP, \fB\-\-noissue\fP
.RS 4
Nie wyświetla zawartości \fI/etc/issue\fP (lub odpowiednika) przed wypisaniem zachęty logowania. Sprzętowe terminale lub urządzenia do komunikacji mogą być zmylone dużą ilością tekstu otrzymaną z nieprawidłową szybkością w bodach; skrypty wdzwaniania mogą zawieść, gdy zachęta logowania jest poprzedzona przez zbyt wiele tekstu.
.RE
.sp
\fB\-I\fP, \fB\-\-init\-string\fP \fIłańcuch\-inicjowania\fP
.RS 4
Ustawia początkowy łańcuch wysyłany do tty lub modemu przed wysłaniem czegokolwiek innego. Można w ten sposób zainicjować modem. Wysłanie znaków niedrukowalnych jest możliwe poprzez zapisanie ich ósemkowego kodu poprzedzonego odwrotnym ukośnikiem (\(rs). Na przykład aby wysłać znak wysuwu strony (kod 10 w ASCII, ósemkowe 012), należy zapisać \(rs12.
.RE
.sp
\fB\-J\fP, \fB\-\-noclear\fP
.RS 4
Nie czyści ekranu przed zapytaniem o login. Domyślnie ekran jest czyszczony.
.RE
.sp
\fB\-l\fP, \fB\-\-login\-program\fP \fIprogram\-logowania\fP
.RS 4
Wywołuje podany \fIprogram\-logowania\fP zamiast /bin/login. Można w ten sposób zastosować niestandardowy program logowania. Taki program może np. pytać o hasło wdzwaniania lub stosować inny plik z hasłami. Zob. \fB\-\-login\-options\fP.
.RE
.sp
\fB\-L\fP, \fB\-\-local\-line\fP[\fB=\fP\fItryb\fP]
.RS 4
Kontroluje flagę linii CLOCAL. Opcjonalnym argumentem \fItryb\fP może być \fBauto\fP, \fBalways\fP lub \fBnever\fP. Jeśli pominie się argument \fItryb\fP, domyślnie przyjmowany jest \fBalways\fP. Jeśli natomiast w ogóle nie poda się opcji \fB\-\-local\-line\fP, domyślnym ustawieniem jest \fBauto\fP.
.sp
\fIalways\fP
.RS 4
Wymusza ustawienie linii jako linii lokalnej, bez konieczności wykrywania nośnej. Może być przydatne, gdy posiada się terminal podłączony lokalnie, gdzie linia szeregowa nie ustawia sygnału wykrywania nośnej.
.RE
.sp
\fInever\fP
.RS 4
Jawnie czyści flagę CLOCAL z ustawienia linii; na linii oczekuje się występowania sygnału wykrywania nośnej.
.RE
.sp
\fIauto\fP
.RS 4
Domyślne ustawienie \fBagetty\fP. Nie modyfikuje ustawienia CLOCAL i stosuje ustawienie wybrane przez jądro.
.RE
.RE
.sp
\fB\-m\fP, \fB\-\-extract\-baud\fP
.RS 4
Próbuje wyodrębnić szybkość w bodach z komunikatu stanu CONNECT tworzonego przez modemy kompatybilne z Hayes(tm). Omawiane komunikaty stanu mają postać: "<śmieci><szybkość><śmieci>". \fBagetty\fP przyjmuje, że modem emituje swój komunikat stanu z taką samą prędkością, jako podano w (pierwszej) wartości \fIszybkość\-w\-bodach\fP w wierszu polecenia.
.sp
Jako że funkcja \fB\-\-extract\-baud\fP może zawieść na mocno obciążonych systemach, powinno się wciąż włączyć przetwarzanie BREAK poprzez wypisanie wszystkich oczekiwanych szybkości w bodach w wierszu polecenia.
.RE
.sp
\fB\-\-list\-speeds\fP
.RS 4
Wyświetla obsługiwane szybkości w bodach. Określa się je w trakcie kompilacji.
.RE
.sp
\fB\-n\fP, \fB\-\-skip\-login\fP
.RS 4
Nie pyta użytkownika o login. Można stosować łącznie z opcją \fB\-\-login\-program\fP do wywoływania niestandardowego procesu logowania, takiego jak systemu BBS. Proszę zauważyć, że przy opcji \fB\-\-skip\-login\fP, \fBagetty\fP nie otrzymuje wejścia od logującego się użytkownika, zatem nie będzie w stanie wykryć parzystości, rozmiaru znaku ani sposobu przetwarzania nowego wiersza w połączeniu. Domyślnie stosowana jest pseudoparzystość z bitem zerowym (ang. space parity), znaki 7\-bitowe oraz znak CR ASCII (13) jako znak końca wiersza. Proszę być świadomym, że program uruchamiany przez \fBagetty\fP (zwykle /bin/login) działa jako root.
.RE
.sp
\fB\-N\fP, \fB\-\-nonewline\fP
.RS 4
Nie wypisuje nowego wiersza przed zawartością \fI/etc/issue\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-login\-options\fP \fIopcje\-logowania\fP
.RS 4
Opcje i argumenty przekazywane do \fBlogin\fP(1), gdzie \(rsu jest zastępowane loginem. Przykład:
.sp
\fB\-\-login\-options \*(Aq\-h darkstar \-\- \(rsu\*(Aq\fP
.sp
Zob. \fB\-\-autologin\fP, \fB\-\-login\-program\fP i \fB\-\-remote\fP.
.sp
Przed zastosowaniem tej opcji proszę zapoznać się z rozdziałem \fBZASTRZEŻENIE ZWIĄZANE Z BEZPIECZEŃSTWEM\fP
.RE
.sp
\fB\-p\fP, \fB\-\-login\-pause\fP
.RS 4
Czeka na dowolny klawisz przed przejściem do zachęty logowania. Można łączyć z \fB\-\-autologin\fP aby zaoszczędzić pamięć przez leniwe tworzenie powłok.
.RE
.sp
\fB\-r\fP, \fB\-\-chroot\fP \fIkatalog\fP
.RS 4
Zmienia katalog główny na podany.
.RE
.sp
\fB\-R\fP, \fB\-\-hangup\fP
.RS 4
Wywołuje \fBvhangup\fP(2) w celu wykonania wirtualnego rozłączenia się na podanym terminalu.
.RE
.sp
\fB\-s\fP, \fB\-\-keep\-baud\fP
.RS 4
Stara się utrzymać istniejącą szybkość w bodach. Szybkości w bodach z wiersza polecenia są stosowane, gdy \fBagetty\fP otrzyma znak BREAK. Jeśli podano inne szybkości w bodach, pierwotna jest zachowywana i trafia na koniec listy pożądanych szybkości. W ten sposób można powrócić do pierwotnej szybkości w bodach, po otrzymaniu nieoczekiwanych znaków BREAK.
.RE
.sp
\fB\-t\fP, \fB\-\-timeout\fP \fIczas\-przeterminowania\fP
.RS 4
Przerywa, gdy nie można odczytać nazwy użytkownika przez \fIczas\-przeterminowania\fP sekund. Nie zaleca się stosowania tej opcji na stałych liniach terminalowych.
.RE
.sp
\fB\-U\fP, \fB\-\-detect\-case\fP
.RS 4
Włącza obsługę wykrywania terminala z wyłącznie znakami drukowanymi. To ustawienie wykryje nazwę loginu zawierającą wyłącznie wielkie litery jako wskazówkę terminala stosującego wyłącznie znaki drukowane, włączając pewne konwersje z wielkich na małe litery. Proszę zauważyć, że brak tu obsługi jakichkolwiek znaków Unikodu.
.RE
.sp
\fB\-w\fP, \fB\-\-wait\-cr\fP
.RS 4
Czeka na wysłanie przez użytkownika lub modem znaku powrotu karetki lub wysuwu strony przed wysłaniem pliku \fI/etc/issue\fP (lub innych) oraz zachęty logowania. Przydatne z opcją \fB\-\-init\-string\fP.
.RE
.sp
\fB\-\-nohints\fP
.RS 4
Nie wypisuje podpowiedzi dotyczących klawiszy Num Lock, Caps Lock i Scroll Lock.
.RE
.sp
\fB\-\-nohostname\fP
.RS 4
Domyślnie wypisywana jest nazwa stacji (hostname). Po włączeniu tej opcji, nazwa stacji nie jest pokazywana. Takie ustawienie można też uzyskać opcją LOGIN_PLAIN_PROMPT w pliku konfiguracyjnym \fI/etc/login.defs\fP (więcej szczegółów poniżej).
.RE
.sp
\fB\-\-long\-hostname\fP
.RS 4
Domyślnie nazwa stacji jest wypisywana jedynie do pierwszej kropki. Po włączeniu tej opcji wypisywane jest w pełni kwalifikowalna nazwa stacji z \fBgethostname\fP(3P) lub (jeśli nie znaleziono) z \fBgetaddrinfo\fP(3).
.RE
.sp
\fB\-\-erase\-chars\fP \fIłańcuch\fP
.RS 4
Opcja określa dodatkowe znaki interpretowane jako backspace ("zignoruj poprzedni znak") gdy użytkownik wpisuje swój login. Domyślnym dodatkowym znakiem "usuwania" był niegdyś "#", jednak od util\-linux 2.23 domyślnie nie są włączane żadne dodatkowe znaki usuwania.
.RE
.sp
\fB\-\-kill\-chars\fP \fIłańcuch\fP
.RS 4
Opcja określa dodatkowe znaki interpretowane jako usuwanie wiersza \- kill ("ignoruj wszystkie poprzednie znaki") gdy użytkownik wpisuje swój login. Domyślnym dodatkowym znakiem "kill" był niegdyś \*(Aq@\*(Aq, jednak od util\-linux 2.23 domyślnie nie są włączane żadne dodatkowe znaki usuwania wiersza.
.RE
.sp
\fB\-\-chdir\fP \fIkatalog\fP
.RS 4
Zmienia katalog przed logowaniem.
.RE
.sp
\fB\-\-delay\fP \fIliczba\fP
.RS 4
Przerwa w sekundach przez otwarciem tty.
.RE
.sp
\fB\-\-nice\fP \fIliczba\fP
.RS 4
Uruchamia login ze wskazanym priorytetem.
.RE
.sp
\fB\-\-reload\fP
.RS 4
Prosi wszystkie działające instancje \fBagetty\fP o przeładowanie i zaktualizowanie swoich wyświetlanych zachęt, jeśli użytkownik jeszcze nie rozpoczął logowania się. Następnie polecenie zakończy się. Funkcja może być nieobsługiwana w systemach bez linuksowego \fBinotify\fP(7).
.RE
.sp
\fB\-\-help\fP
.RS 4
Wyświetla ten tekst i wychodzi.
.RE
.sp
\fB\-\-version\fP
.RS 4
Wyświetla wersję i wychodzi.
.RE
.SH "ELEMENTY PLIKU KONFIGURACYJNEGO"
.sp
\fBagetty\fP odczytuje plik konfiguracyjny \fI/etc/login.defs\fP (zob. \fBlogin.defs\fP(5)). Proszę zauważyć, że plik konfiguracyjny może być dostarczany przez inny pakiet (zwykle shadow\-utils). Następujące pozycje konfiguracyjne są istotne dla \fBagetty\fP:
.sp
\fBLOGIN_PLAIN_PROMPT\fP (wartość logiczna)
.RS 4
Nakazuje \fBagetty\fP, aby nie wypisywało nazwy stacji w zachęcie login:. Alternatywa dla opcji wiersza poleceń \fB\-\-nohostname\fP. Domyślna wartość to \fIno\fP (nie).
.RE
.SH "PRZYKŁAD"
.sp
Rozdział zawiera przykładowe pola procesu dla wpisu w pliku \fI/etc/inittab\fP. Trzeba je poprzedzić prawidłowymi wartościami innych pól. Więcej szczegółów w podręczniku \fBinittab\fP(5).
.sp
W przypadku linii połączonej bezpośrednio lub konsoli tty:
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty 9600 ttyS1\fP
.br
.RE
.ll
.sp
W przypadku bezpośrednio połączonego terminala bez prawidłowego okablowania pozwalającego na wykrycie nośnej (do wypróbowania, gdy terminal zatrzymuje się, zamiast wyświetlać zachętę hasło:):
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty \-\-local\-line 9600 ttyS1 vt100\fP
.br
.RE
.ll
.sp
W przypadku tradycyjnej linii wdzwanianej z modemem o 9600/2400/1200 bodach:
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty \-\-extract\-baud \-\-timeout 60 ttyS1 9600,2400,1200\fP
.br
.RE
.ll
.sp
W przypadku modemu Hayesa o stałym interfejsie 115200 bps z komputerem (przykładowy łańcuch inicjujący wyłącza odbijanie modemu /echo/ i kodów wynikowych, ustawia śledzenie DCD modem/modem przez DCD modem/komputer, wykonuje DTR drop powodujące rozłączenie i włącza automatyczną odpowiedź po jednym sygnale):
.RS 3
.ll -.6i
.sp
\fB/sbin/agetty \-\-wait\-cr \-\-init\-string \*(AqATE0Q1&D2&C1S0=1\(rs015\*(Aq 115200 ttyS1\fP
.br
.RE
.ll
.SH "ZASTRZEŻENIE ZWIĄZANE Z BEZPIECZEŃSTWEM"
.sp
Jeśli korzysta się z opcji \fB\-\-login\-program\fP i \fB\-\-login\-options\fP należy być świadomym, że złośliwy użytkownik może zechcieć wprowadzać loginy z osadzonymi opcjami, które są następnie przekazywane do stosowanego programu logowania. \fBagetty\fP sprawdza pod kątem początkowego "\-" i upewnia się, że login jest przekazywany jako pojedynczy parametr (a więc osadzone spacje nie utworzą kolejnego parametru), lecz w zależności od sposobu przetwarzania wiersza polecenia przez plik wykonywalny login może być to niewystarczające. Proszę sprawdzić, czy używany program login nie może być w ten sposób nadużywany.
.sp
Niektóre programy używają "\-\-" do wskazania, że reszty wiersza polecenia nie należy interpretować jako opcji. Proszę korzystać z tej funkcji, jeśli jest dostępna, przekazując "\-\-" przed przekazywaną za pomocą \(rsu nazwą użytkownika.
.SH "PLIKI ISSUE"
.sp
Domyślnym plikiem issue jest \fI/etc/issue\fP. Jeśli plik istnieje, \fBagetty\fP sprawdzi także katalog \fI/etc/issue.d\fP. Katalog jest opcjonalnym rozszerzeniem domyślnego pliku issue, a jego zawartość jest wypisywana po zawartości pliku \fI/etc/issue\fP. Jeśli plik \fI/etc/issue\fP nie istnieje, to katalog jest ignorowany. Wszystkie pliki \fBz rozszerzeniem .issue\fP są wypisywane w kolejności sortowania wersji. Katalog można stosować do zarządzania komunikatami zewnętrznymi, niezależnie od podstawowego, systemowego pliku \fI/etc/issue\fP.
.sp
Od wersji 2.35, obsługiwane są dodatkowe położenia pliku i katalogu issue. \fBagetty\fP szuka pliku \fI/run/issue\fP i katalogu \fI/run/issue.d\fP, a następnie pliku \fI/usr/lib/issue\fP i katalogu \fI/usr/lib/issue.d\fP. Oczekuje się, że w katalogu \fI/etc\fP występuje konfiguracja typowa dla danego komputera, w \fI/run\fP treść generowana, a \fI/usr/lib\fP jest stosowane dla statycznej konfiguracji utrzymywanej przez dystrybucję.
.sp
Proszę zauważyć, że od wersji 2.35 do 2.40, dodatkowe położenia były odczytywane jedynie, gdy domyślny plik \fI/etc/issue\fP nie istniał. Od wersji 2.41 dodatkowe położenia są odczytywane zawsze, niezależnie od występowania pliku \fI/etc/issue\fP. Zmiana pozwala na domyślne generowanie plików issue.
.sp
Domyślne ścieżki można całkowicie przesłonić opcją \fB\-\-issue\-file\fP. W takim przypadku podana ścieżka musi być plikiem lub katalogiem, a wszystkie domyślne położenia pliku i katalogu issue są ignorowane.
.sp
Funkcję pliku issue można całkowicie wyłączyć opcją \fB\-\-noissue\fP.
.sp
Można przejrzeć aktualny plik issue, wykonując polecenie \fBagetty \-\-show\-issue\fP na bieżącym terminalu.
.sp
Pliki issue mogą zawierać określone sekwencje specjalne, wyświetlające nazwę systemu, datę, czas itd. Wszystkie sekwencje specjalne składają się z odwrotnego ukośnika (\(rs), bezpośrednio po którym występuje jeden ze znaków podanych poniżej.
.sp
4 lub 4{\fIinterfejs\fP}
.RS 4
Umieszcza adres IPv4 podanego interfejsu sieciowego (np. \(rs4{eth0}). Jeśli nie poda się argumentu \fIinterfejs\fP, wybiera pierwszy całkowicie skonfigurowany interfejs (UP, niebędący LOCALBACK, RUNNING). Jeśli nie uda się odnaleźć skonfigurowanego interfejsu, wyświetla adres IP nazwy stacji.
.RE
.sp
6 lub 6{\fIinterfejs\fP}
.RS 4
Jak \(rs4 lecz dotyczy adresu IPv6.
.RE
.sp
a
.RS 4
Wstawia listę "dobrych" adresów IP dla wszystkich interfejsów. Wyświetla adresy IP będące najlepszymi kandydatami do zdalnego logowania: adresy globalne i stron; jeśli nie są dostępne, tymczasowe adresy o najdłuższym czasie istnienia, jeśli nie są dostępne, adresy łączenia. Proszę zauważyć, że adresy łączenia są wypisywane z nazwą interfejsu lokalnego, jednak przy ich zastosowaniu konieczne będzie użycie nazwy interfejsu na komputerze, na którym będą używane.
.RE
.sp
A
.RS 4
Wstawia listę wszystkich adresów IP dla wszystkich interfejsów.
.RE
.sp
b
.RS 4
Wstawia szybkość w bodach bieżącej linii.
.RE
.sp
d
.RS 4
Wstawia aktualną datę.
.RE
.sp
e lub e{\fInazwa\fP}
.RS 4
Tłumaczy \fInazwę\fP czytelną dla człowieka na sekwencję specjalną i wstawia ją (np. \(rse{red}Tekst alertu.\(rse{reset}). Jeśli nie poda się argumentu \fInazwa\fP, wstawia \(rs033. Obecnie obsługiwane są następujące nazwy: black, blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, magenta, red, reset, reverse, yellow oraz white. Wszystkie nieznane nazwy są po cichu ignorowane.
.RE
.sp
s
.RS 4
Wstawia nazwę systemu (nazwę systemu operacyjnego). Odpowiada poleceniu "uname \-s". Zob. też sekwencję specjalną \(rsS.
.RE
.sp
S or S{ZMIENNA}
.RS 4
Wstawia dane ZMIENNEJ z \fI/etc/os\-release\fP. Jeśli plik ten nie istnieje, korzysta z \fI/usr/lib/os\-release\fP. Jeśli nie poda się argumentu ZMIENNA, stosuje PRETTY_NAME z pliku albo nazwę systemu (zob. \(rss). Ta sekwencja specjalna może posłużyć do utrzymywania wydania i dystrybucji \fI/etc/issue\fP jako niezależnych. Proszę zauważyć, że \(rsS{ANSI_COLOR} jest konwertowane na faktyczną sekwencję specjalną terminala.
.RE
.sp
l
.RS 4
Wstawia nazwę bieżącej linii tty.
.RE
.sp
m
.RS 4
Wstawia identyfikator architektury komputera. Równoważny \fBuname \-m\fP.
.RE
.sp
n
.RS 4
Wstawia nazwę węzła komputera, inaczej nazwę stacji (hostname). Równoważna \fBuname \-n\fP.
.RE
.sp
o
.RS 4
Wstawia nazwę domeny NIS komputera. Równoważna \fBhostname \-d\fP.
.RE
.sp
O
.RS 4
Wstawia nazwę domeny DNS komputera.
.RE
.sp
r
.RS 4
Wstawia numer wydania systemu operacyjnego. Równoważny \fBuname \-r\fP.
.RE
.sp
t
.RS 4
Wstawia aktualny czas.
.RE
.sp
u
.RS 4
Wstawia liczbę aktualnie zalogowanych użytkowników.
.RE
.sp
U
.RS 4
Wstawia łańcuch "1 użytkownik" lub "<n> użytkownicy"/"<n> użytkowników" gdzie <n> jest liczbą aktualnie zalogowanych użytkowników.
.RE
.sp
v
.RS 4
Wstawia wersję systemu operacyjnego tj. datę zbudowania itp.
.RE
.sp
Przykład. Na systemie autora podręcznika następujący plik \fI/etc/issue\fP:
.sp
.if n .RS 4
.nf
.fam C
Tu \(rsn.\(rso (\(rss \(rsm \(rsr) \(rst
.fam
.fi
.if n .RE
.sp
wyświetlał się jako:
.sp
.if n .RS 4
.nf
.fam C
Tu thingol.orcan.dk (Linux i386 1.1.9) 18:29:30
.fam
.fi
.if n .RE
.SH "PLIKI"
.sp
\fI/var/run/utmp\fP
.RS 4
systemowy plik stanu.
.RE
.sp
\fI/etc/issue\fP
.RS 4
wypisywane przed zachętą logowania.
.RE
.sp
\fI/etc/os\-release /usr/lib/os\-release\fP
.RS 4
dane identyfikujące system operacyjny.
.RE
.sp
\fI/dev/console\fP
.RS 4
dzienniki błędów (jeśli nie jest stosowany \fBsyslog\fP(3)).
.RE
.sp
\fI/etc/inittab\fP
.RS 4
plik konfiguracyjny \fBinit\fP(8) demona init w stylu SysV.
.RE
.SH "DANE UWIERZYTELNIAJĄCE"
.sp
\fBagetty\fP obsługuje konfigurację za pomocą poświadczeń systemd (zob. \c
.URL "https://systemd.io/CREDENTIALS/" "" ")."
\fBagetty\fP odczytuje następujące poświadczenia systemd:
.sp
\fBagetty.autologin\fP (łańcuch)
.RS 4
Jeśli ustawione, konfiguruje \fBagetty\fP w celu automatycznego logowania się jako podany użytkownik, bez pytania o login i hasło, podobnie do opcji \fB\-\-autologin\fP.
.RE
.SH "USTERKI"
.sp
Funkcja wykrywania szybkości w bodach (opcja \fB\-\-extract\-baud\fP) wymaga, aby \fBagetty\fP otrzymał czas procesora wystarczająco szybko po ukończeniu połączenia wdzwaniania (do 30 ms w przypadku modemów komunikujących się z szybkością 2400 bodów). Dla pewności działania, należy zawsze stosować opcję wiersza polecenia \fB\-\-extract\-baud\fP wraz z kilkoma szybkościami w bodach, dzięki czemu włączone jest przetwarzanie BREAK.
.sp
Tekst z pliku \fI/etc/issue\fP (lub innego) i zachęta logowania są zawsze wypisywane jako znaki 7\-bitowe z pseudoparzystością z bitem zerowym (ang. space parity).
.sp
Funkcja wykrywania szybkości w bodach (opcja \fB\-\-extract\-baud\fP) wymaga, aby modem wyemitował swój komunikat stanu \fIpo\fP podniesieniu linii DCD.
.SH "DIAGNOSTYKA"
.sp
W zależności od sposobu konfiguracji programu, wszelka diagnostyka jest wypisywana na urządzenie konsoli albo zgłaszana poprzez \fBsyslog\fP(3). Błędy są tworzone, gdy argument \fIport\fP nie określa urządzenia terminala; gdy brak wpisu utmp dla bieżącego procesu (tylko System V) itd.
.SH "AUTORZY"
.sp
.MTO "werner\(atsuse.de" "Werner Fink" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.sp
Autorem pierwotnego \fBagetty\fP do terminali szeregowych był \c
.MTO "wietse\(atwzv.win.tue.nl" "W.Z. Venema" ","
a port na Linuksa napisał
.MTO "poe\(atdaimi.aau.dk" "Peter Orbaek" "."
.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 \fBagetty\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" "."