AGETTY(8)

BEZEICHNUNG
agetty - alternativer Linux-Getty

ÜBERSICHT
agetty [Optionen] Port [Baudrate…] [Term]

BESCHREIBUNG
agetty öffnet einen TTY-Port, bittet um einen Anmeldenamen und startet den Befehl /bin/login. Es wird normalerweise durch init(8) aufgerufen. agetty verfügt über mehrere nicht standardisierte Funktionalitäten, die für Stand- und Einwählleitungen nützlich sind:

•   Adapts the tty settings to parity bits and to erase, kill, end-of-line and uppercase characters when it reads a login name. The program can handle 7-bit characters with even, odd, none or space parity, and 8-bit characters with no parity. The following special characters are recognized: Control-U (kill); DEL and backspace (erase); carriage return and line feed (end of line). See also the --erase-chars and --kill-chars options.

•   Ermittelt optional die Baudrate aus den von Hayes(™)-kompatiblen Modems erstellten CONNECT-Nachrichten.

•   Legt optional nicht auf, wenn ihm eine bereits offene Leitung übergeben wird (nützlich für Rückrufanwendungen).

•   Zeigt optional den Inhalt der Datei /etc/issue nicht an.

•   Zeigt optional eine alternative »issue«-Datei statt /etc/issue an.

•   Fragt optional nicht nach einem Login-Namen.

•   Startet optional statt /bin/login ein nicht Standard Login-Programm.

•   Schaltet optional Hardware-Flusssteuerung ein.

•   Erzwingt optional, dass die Leitung lokal und keine Signalerkennung notwendig ist.

Dieses Programm verwendet die Dateien /etc/gettydefs (System V) oder /etc/gettytab (SunOS 4) nicht.

ARGUMENTE

Port
    Ein Pfadname relativ zum Verzeichnis /dev. Falls ein »-« angegeben wurde, nimmt agetty an, dass seine Standardeingabe bereits mit einem TTY-Port verbunden ist und dass die Verbindung zu einem Benutzer in der Ferne bereits aufgebaut wurde.

    Unter System V sollte einem Argument »-« Port die Zeichenkette »--« vorangestellt werden.

Baudrate,…
    Eine kommatagetrennte Liste einer oder mehrerer Baudraten. Jedes Mal, wenn agetty ein BREAK-Zeichen empfängt, schreitet es durch die Liste fort, die so behandelt wird, als ob sie zirkulär wäre.

    Baudraten sollten in absteigender Reihenfolge angegeben werden, so dass das Null-Zeichen (Strg-@) auch für den Wechsel der Baudrate verwandt werden kann.

    Dieses Argument ist optional und für virtuelle Terminals unnötig.

    Die Vorgabe für serielle Terminals ist, die aktuelle Baudrate beizubehalten (siehe --keep-baud) und falls nicht erfolgreich, als Vorgabe »9600« zu verwenden.

Term
    Der Wert, der für die Umgebungsvariable TERM verwendet werden soll. Dies setzt außer Kraft, was auch immer init(8) gesetzt haben könnte und wird an Login und die Shell vererbt.

    Die Vorgabe ist »vt100« oder »linux« für Linux auf einem virtuellen Terminal oder »hurd« für GNU Hurd auf einem virtuellen Terminal.

OPTIONEN

-8, --8bits
    Es wird angenommen, dass das TTY 8-Bit-korrekt ist, daher wird die Paritätserkennung abgeschaltet.

-a, --autologin Benutzername
    Den angegebenen Benutzer automatisch anmelden, ohne nach dem Anmeldenamen und dem Passwort zu fragen. Die Option Benutzername wird standardmäßig zu dem Befehl /bin/login hinzugefügt. Die Optionen für »--login-options« ändern dieses Standardverhalten und dann wird nur \u durch Benutzername ersetzt und es werden keine weiteren Optionen zu der Befehlszeile von Login hinzugefügt.

-c, --noreset
    Terminal-Cflags (Steuermodi) werden nicht zurückgesetzt. Siehe termios(3) für weitere Details.

-E, --remote
    Falls eine Option -H Fake-Rechner angegeben wird, dann wird die Option -r Fake-Rechner zu der Befehlszeile von /bin/login hinzugefügt.

-f, --issue-file Hinweisdatei
    Zeigt den Inhalt der Hinweisdatei statt von /etc/issue an. Dies ermöglicht es, auf verschiedenen Terminals angepasste Meldungen anzuzeigen. Die Option -i setzt diese Option außer Kraft.

-h, --flow-control
    Hardwareflusssteuerung (RTS/CTS) aktivieren. Es bleibt der Anwendung überlassen, Softwareflusssteuerung (XON/XOFF) wo notwendig zu deaktivieren.

-H, --host Anmelderechner
    Schreibt den angegebenen Anmelderechner in die Datei »utmp«. (Normalerweise wird kein Anmelderechner angegeben, da agetty für lokale, festverdrahtete Verbindungen und Konsolen benutzt wird. Diese Option kann allerdings für die Identifizierung von Terminal-Konzentratoren und ähnlichem nützlich sein.)

-i, --noissue
    Zeigt den Inhalt von /etc/issue (oder anderen) vor der Ausgabe der Anmeldeeingabeaufforderung nicht an. Terminals oder Kommunikations-Hardware könnten beim Empfang von vielem Text mit der falschen Baudrate durcheinanderkommen; Einwählskripte könnten fehlschlagen, falls vor der Anmeldeeingabeaufforderung zu viel Text steht.

-I, --init-string Init-Zeichenkette
    Setzt eine initiale Zeichenkette, die an das TTY oder Modem vor dem Senden von allem anderen übertragen werden soll. Dies kann zur Inititialisierung des Modems verwandt werden. Nicht druckbare Zeichen können gesandt werden, indem ihrem oktalen Code ein Rückwärtsschrägstrich (\) vorangestellt wird. Beispielsweise schreiben Sie \012, um ein Zeilenumbruchzeichen (ASCII 10, oktal 012) zu übertragen.

-J, --noclear
    Den Bildschirm nicht löschen, bevor nach dem Anmeldenamen gefragt wird (normalerweise wird der Bildschirm gelöscht).

-l, --login-program Login-Programm
    Ruft ein spezielles Login-Programm statt /bin/login auf. Dies ermöglicht es, ein nicht standardisiertes Login-Programm zu verwenden (beispielsweise eines, das nach einem Einwählpasswort fragt oder das eine andere Passwort-Datei verwendet).

-L, --local-line[=Modus]
    Steuert den Leitungsschalter CLOCAL. Das optionale Argument Modus ist »auto«, »always« oder »never«. Falls das Argument Modus fortgelassen wird ist die Vorgabe »always«. Falls die Option --local-line überhaupt nicht angegeben ist, dann ist die Vorgabe »auto«. Der Modus »always« erzwingt, dass die Leitung lokal und keine Signalerkennung notwendig ist. Dies kann nützlich sein, falls Sie ein lokal angebundenes Terminal haben, bei der die serielle Leitung nicht das Signal »carrier-detect« setzt. Der Modus »never« setzt den Schalter CLOCAL aus den Leitungseinstellungen explizit zurück und das Signal »carrier-detect« wird auf der Leitung erwartet. Der Modus »auto« (Vorgabe von Agetty) verändert die CLOCAL-Einstellung nicht und folgt den Einstellungen, die vom Kernel aktiviert wurden.

-m, --extract-baud
    Versucht, die Baudrate aus der von Hayes™-kompatiblen Modems erstellten CONNECT-Statusmeldung auszulesen. Die Statusmeldungen sind von folgender Form: »<Müll><Geschwindigkeit><Müll>«. agetty nimmt an, dass das Modem die Statusmeldung mit der gleichen Geschwindigkeit ausgibt, wie das mit dem (ersten) Baudrate-Wert auf der Befehlszeile angegeben ist.

    Da die Funktionalität von -m auf stark beschäftigten Systemen fehlschlagen könnte, sollten Sie dennoch die Verarbeitung von BREAK aktivieren, indem Sie alle erwarteten Baudraten auf der Befehlszeile aufzählen.

-n, --skip-login
    Fragt den Benutzer nicht nach einem Anmeldenamen. Dies kann für Verbindngen mit der Option -l verwandt werden, um einen nicht standardmäßigen Anmeldeprozess wie eine Mailbox (BBS) aufzurufen. Beachten Sie, dass mit der Option -n agetty keine Eingabezeichen von dem Benutzer erhält, der sich anmeldet, und daher nicht die Parität, Zeichenbreite und die Verarbeitung von Zeilenumbrüchen in der Verbindung erkennen kann. Als Vorgabe wird Space-Parität, 7-Bit-Zeichen und ASCII-CR (13) Zeilenumbruchzeichen verwandt. Achtung: Das von agetty gestartete Program (normalerweise /bin/login) wird als root ausgeführt.

-N, --nonewline
    Keinen Zeilenumbruch vor dem Schreiben von /etc/issue ausgeben.

-o, --login-options "Anmeldeoptionen"
    Optionen, die an das Anmeldeprogramm weitergegeben werden. \u wird durch den Anmeldenamen ersetzt. Die standardmäßige Befehlszeile für /bin/login lautet »/bin/login -- <Benutzername>«. Bitte lesen Sie unten den SICHERHEITSHINWEIS, falls Sie dies benutzen möchten.

-p, --login-pause
    Wartet auf einen Tastendruck, bevor eine Anmeldeaufforderung ausgegeben wird. Kann mit --autologin kombiniert werden, um durch träges Erzeugen von Shells Speicher zu sparen.

-r, --chroot Verzeichnis
    Ändert das Wurzelverzeichnis auf das angegebene Verzeichnis.

-R, --hangup
    Ruft vhangup() auf, um auf dem angegebenen Terminal virtuell aufzulegen.

-s, --keep-baud
    Versucht, die bestehende Baudrate beizubehalten. Die Baudraten von der Befehlszeile werden verwandt, wenn Agetty ein »BREAK«-Zeichen empfängt.

-t, --timeout Dauer
    Beendet sich, falls der Benutzername nicht innerhalb von Dauer Sekunden eingelesen werden konnte. Diese Option sollte wahrscheinlich nicht mit festverdrahteten Leitungen verwandt werden.

-U, --detect-case
    Schaltet die Unterstützung für die Erkennung von Terminals ein, die nur Großschreibung beherrschen. Diese Einstellung wird einen Anmeldenamen, der nur Großbuchstaben enthält, erkennen und daraus ein Terminal erschließen, das nur Großbuchstaben beherrscht und dann einige Groß-zu-Kleinbuchstaben-Umwandlungen aktivieren. Beachten Sie, dass dabei keine Unterstützung für Unicode-Zeichen vorhanden ist.

-w, --wait-cr
    Warten, bis der Benutzer oder das Modem ein Zeilenumbruch- oder Wagenrücklaufzeichen gesandt hat, bevor die (oder eine andere) Datei /etc/issue und eine Eingabeaufforderung gesandt wird. Sehr nützlich in Verbindung mit der Option »-I«.

--nohints
    Do not print hints about Num, Caps and Scroll Locks.

--nohostname
    Standardmäßig wird der Rechnername ausgegeben. Wird diese Option aktiviert, wird überhaupt kein Rechnername ausgegeben.

--long-hostname
    Standardmäßig wird der Rechnername nur bis zum ersten Punkt ausgegeben. Wird diese Option aktiviert, dann wird der vollqualifizierte Rechnername durch gethostname() oder (falls nicht gefunden) durch getaddrinfo() angezeigt.

--erase-chars Zeichenkette
    Diese Option legt zusätzliche Zeichen fest, die als Rückschritt (»das letzte Zeichen ignorieren«) interpretiert werden sollen, wenn der Benutzer den Anmeldenamen eingibt. Standardmäßig war »#« das zusätzliche »erase« (löschen), aber seit Util-Linux 2.23 werden keine zusätzlichen Löschzeichen standardmäßig aktiviert.

--kill-chars Zeichenkette
    Diese Option legt zusätzliche Zeichen fest, die als Bereinigen (»alle vorherigen Zeichen ignorieren«) interpretiert werden sollen, wenn der Benutzer den Anmeldenamen eingibt. Standardmäßig war »@« das zusätzliche »kill« (bereinigen), aber seit Util-Linux 2.23 werden keine zusätzlichen Bereinigungszeichen standardmäßig aktiviert.

--chdir Verzeichnis
    Vor dem Anmelden das Verzeichnis wechseln.

--delay Nummer
    Wartet Sekunden, bevor ein TTY geöffnet wird.

--nice Nummer
    Login mit dieser Priorität ausführen.

--reload
    Fordert alle laufenden Instanzen von Agetty auf, sich neu zu laden und ihre angezeigten Anmeldeaufforderungen zu aktualisieren, falls der Benutzer noch nicht mit der Anmeldung begonnen hat. Danach wird sich der Befehl beenden. Diese Funktionalität könnte auf Systemen ohne das Linux inotify(7) nicht unterstützt sein.

--version
    zeigt Versionsinformationen an und beendet das Programm.

--help
    zeigt diese Hilfe an und beendet das Programm.

BEISPIELE
This section shows examples for the process field of an entry in the /etc/inittab file. You'll have to prepend appropriate values for the other fields. See inittab(5) for more details. Für eine hartverdrahtete Leitung oder ein Konsolen-TTY:
    /sbin/agetty 9600 ttyS1
Für ein direkt verbundenes Terminal ohne korrekte »carrier-detect«-Verkabelung (versuchen Sie das, falls Ihr Terminal nicht reagiert, statt Ihnen eine »password«-Eingabeaufforderung anzuzeigen).
    /sbin/agetty -L 9600 ttyS1 vt100
Für eine altertümliche Einwählleitung mit einem 9600/2400/1200-Baud-Modem:
    /sbin/agetty -mt60 ttyS1 9600,2400,1200
For a Hayes modem with a fixed 115200 bps interface to the machine (the example init string turns off modem echo and result codes, makes modem/computer DCD track modem/modem DCD, makes a DTR drop cause a disconnection, and turns on auto-answer after 1 ring):
    /sbin/agetty -w -I 'ATE0Q1&D2&C1S0=1\015' 115200 ttyS1

SICHERHEITSHINWEIS
If you use the --login-program and --login-options options, be aware that a malicious user may try to enter lognames with embedded options, which then get passed to the used login program. Agetty does check for a leading "-" and makes sure the logname gets passed as one parameter (so embedded spaces will not create yet another parameter), but depending on how the login binary parses the command line that might not be sufficient. Check that the used login program can not be abused this way.

Some programs use "--" to indicate that the rest of the commandline should not be interpreted as options. Use this feature if available by passing "--" before the username gets passed by \u.

MASKIERUNGEN IN ISSUE
Die issue-Datei (/etc/issue oder die mit der Option -f gesetzte Datei) kann bestimmte Maskierungscodes enthalten, um den Systemnamen, das Datum, die Zeit usw. anzuzeigen. Alle Maskierungscodes bestehen aus einem Rückwärtsschrägstrich (\), der sofort von einem der unten aufgeführten Zeichen gefolgt wird.

4 oder 4{Schnittstelle}
    Insert the IPv4 address of the specified network interface (for example: \4{eth0}). If the interface argument is not specified, then select the first fully configured (UP, non-LOCALBACK, RUNNING) interface. If not any configured interface is found, fall back to the IP address of the machine's hostname.

6 oder 6{Schnittstelle}
    Identisch zu \4 aber für IPv6.

b   Insert the baudrate of the current line.

d   Das aktuelle Datum einfügen.

e oder e{name}
    Translate the human-readable name to an escape sequence and insert it (for example: \e{red}Alert text.\e{reset}). If the name argument is not specified, then insert \033. The currently supported names are: black, blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, magenta, red, reset, reverse, and yellow. All unknown names are silently ignored.

s   Den Systemnamen (den Namen des Betriebssystems) einfügen. Identisch zu »uname -s«. Siehe auch die Maskierungscodes.

S oder S{VARIABLE}
    Insert the VARIABLE data from /etc/os-release. If this file does not exist then fall back to /usr/lib/os-release. If the VARIABLE argument is not specified, then use PRETTY_NAME from the file or the system name (see \s). This escape code allows to keep /etc/issue distribution and release independent. Note that \S{ANSI_COLOR} is converted to the real terminal escape sequence.

l   Den Name der aktuellen TTY-Leitung einfügen.

m   Den Architekturkennzeichner der Maschine einfügen. Identisch zu »uname -m«.

n   Den Knotennamen der Maschine (auch als Rechnername oder Hostname bekannt) einfügen. Identisch zu »uname -n«.

o   Den NIS-Domain-Namen der Maschine einfügen. Identisch zu »hostname -d«.

O   Den DNS-Domain-Namen der Maschine einfügen.

r   Die Release-Nummer des Betriebssystems einfügen. Identisch zu »uname -r«.

t   Die aktuelle Zeit einfügen.

u   Die Anzahl der aktuell angemeldeten Benutzer einfügen.

U   Die Zeichenkette »1 user« oder »<n> users« einfügen, wobei <n> die Anzahl der derzeit angemeldeten Benutzer ist.

v   Die Version des Betriebssystems einfügen, z.B. das Baudatum usw.

Beispielsweise führt die folgende Datei /etc/issue auf meinem System

    Dies ist \n.\o (\s \m \r) \t

zu der Ausgabe:

    Dies ist thingol.orcan.dk (Linux i386 1.1.9) 18:29:30

DATEIEN

/var/run/utmp
    ist die Systemstatusdatei.

/etc/issue
    wird vor der Anmeldeeingabeaufforderung ausgegeben.

/etc/os-release /usr/lib/os-release
    enthält die Identifikationsdaten des Betriebssystems.

/dev/console
    berichtet Probleme (falls syslog(3) nicht verwandt wird).

/etc/inittab
    ist die init(8)-Konfigurationsdatei für einen SysV-artigen Init-Daemon.

FEHLER
The baud-rate detection feature (the -m option) requires that agetty be scheduled soon enough after completion of a dial-in call (within 30 ms with modems that talk at 2400 baud). For robustness, always use the -m option in combination with a multiple baud rate command-line argument, so that BREAK processing is enabled. The text in the /etc/issue file (or other) and the login prompt are always output with 7-bit characters and space parity. The baud-rate detection feature (the -m option) requires that the modem emits its status message after raising the DCD line.

DIAGNOSE
Depending on how the program was configured, all diagnostics are written to the console device or reported via the syslog(3) facility. Error messages are produced if the port argument does not specify a terminal device; if there is no utmp entry for the current process (System V only); and so on.

AUTOREN
Werner Fink (werner@suse.de)
Karel Zak (kzak@redhat.com)

Das ursprüngliche agetty für serielle Terminals wurde von W.Z. Venema <wietse@wzv.win.tue.nl> geschrieben und von Peter Orbaek <poe@daimi.aau.dk> nach Linux portiert.

VERFÜGBARKEIT
Der Befehl agetty ist Teil des Pakets util-linux und kann von ftp://ftp.kernel.org/pub/linux/utils/util-linux/ heruntergeladen werden.

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <debian-l10n-german@lists.debian.org>.