OS Manuals

/usr/bin/agetty

agetty program from util-linux

From agetty 2.42.4-r2 (os), captured 2026-11-05 by running agetty --help (exit 0). permalink

Usage:
 agetty [options] <line> [<baud_rate>,...] [<termtype>]
 agetty [options] <baud_rate>,... <line> [<termtype>]

Open a terminal and set its mode.

Options:
 -8, --8bits                assume 8-bit tty
 -a, --autologin <user>     login the specified user automatically
 -c, --noreset              do not reset control mode
 -E, --remote               use -r <hostname> for login(1)
 -f, --issue-file <list>    display issue files or directories
     --show-issue           display issue file and exit
 -h, --flow-control         enable hardware flow control
 -H, --host <hostname>      specify login host
 -i, --noissue              do not display issue file
 -I, --init-string <string> set init string
 -J, --noclear              do not clear the screen before prompt
 -l, --login-program <file> specify login program
 -L, --local-line[=<mode>]  control the local line flag
 -m, --extract-baud         extract baud rate during connect
 -n, --skip-login           do not prompt for login
 -N, --nonewline            do not print a newline before issue
 -o, --login-options <opts> options that are passed to login
 -p, --login-pause          wait for any key before the login
 -r, --chroot <dir>         change root to the directory
 -R, --hangup               do virtually hangup on the tty
 -s, --keep-baud            try to keep baud rate after break
 -t, --timeout <number>     login process timeout
 -U, --detect-case          detect uppercase terminal
 -w, --wait-cr              wait carriage-return
     --nohints              do not print hints
     --nohostname           no hostname at all will be shown
     --long-hostname        show full qualified hostname
     --erase-chars <string> additional backspace chars
     --kill-chars <string>  additional kill chars
     --chdir <directory>    chdir before the login
     --delay <number>       sleep seconds before prompt
     --nice <number>        run login with this priority
     --reload               reload prompts on running agetty instances
     --list-speeds          display supported baud rates
     --help                 display this help
     --version              display version

For more details see agetty(8).
Options (36)
OptionDescriptionSource
-8, --8bitsAssume that the tty is 8-bit clean, hence disable parity detection.help + man
-a, --autologin userAutomatically log in the specified user without asking for a username or password.help + man
-c, --noresetDo not reset terminal cflags (control modes).help + man
-E, --remoteTypically the login(1) command is given a remote hostname when called by something such as telnetd(8).help + man
-f, --issue-file listSpecifies a ":" delimited list of files and directories to be displayed instead of /etc/issue (or other).help + man
--show-issueDisplay the current issue file (or other) on the current terminal and exit.help + man
-h, --flow-controlEnable hardware (RTS/CTS) flow control.help + man
-H, --host hostnameWrite the specified fakehost into the utmp file.help + man
-i, --noissueDo not display the contents of /etc/issue (or other) before writing the login prompt.help + man
-J, --noclearDo not clear the screen before prompting for the login name.help + man
-L, --local-line modeControl the CLOCAL line flag.help + man
-m, --extract-baudTry to extract the baud rate from the CONNECT status message produced by Hayes(tm)-compatible modems.help + man
-n, --skip-loginDo not prompt the user for a login name.help + man
-N, --nonewlineDo not print a newline before writing out /etc/issue.help + man
-p, --login-pauseWait for any key before dropping to the login prompt.help + man
-r, --chroot dirChange root to the specified directory.help + man
-R, --hangupCall vhangup(2) to do a virtual hangup of the specified terminal.help + man
-s, --keep-baudTry to keep the existing baud rate.help + man
-t, --timeout numberTerminate if no user name could be read within timeout seconds.help + man
-U, --detect-caseTurn on support for detecting an uppercase-only terminal.help + man
-w, --wait-crWait for the user or the modem to send a carriage-return or a linefeed character before sending the /etc/issue file (or others) and the login prompt.help + man
--nohintsDo not print hints about Num, Caps and Scroll Locks.help + man
--nohostnameBy default the hostname will be printed.help + man
--long-hostnameBy default the hostname is only printed until the first dot.help + man
--kill-chars stringThis option specifies additional characters that should be interpreted as a kill ("ignore all previous characters") when the user types the login name.help + man
--chdir directoryChange directory before the login.help + man
--delay numberSleep seconds before open tty.help + man
--nice numberRun login with this priority.help + man
--reloadAsk all running agetty instances to reload and update their displayed prompts, if the user has not yet commenced logging in.help + man
--list-speedsDisplay supported baud rates.help + man
--helpDisplay help text and exit.help + man
--versionDisplay version and exit.help + man
-I, --init-string initstringSet an initial string to be sent to the tty or modem before sending anything else. (in the manual page but not in --help)man
-l, --login-program login_programInvoke the specified login_program instead of /bin/login. (in the manual page but not in --help)man
-o, --login-options login_optionsOptions and arguments that are passed to login(1). (in the manual page but not in --help)man
--erase-chars stringThis option specifies additional characters that should be interpreted as a backspace ("ignore the previous character") when the user types the login name. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.