From 97c26c1924b076ef23ebe4381558e8aa025712b2 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 16:54:37 +0200 Subject: Adding upstream version 1:4.13+dfsg1. Signed-off-by: Daniel Baumann --- man/login.1.xml | 405 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 405 insertions(+) create mode 100644 man/login.1.xml (limited to 'man/login.1.xml') diff --git a/man/login.1.xml b/man/login.1.xml new file mode 100644 index 0000000..fbfbbf1 --- /dev/null +++ b/man/login.1.xml @@ -0,0 +1,405 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + + Julianne Frances + Haugh + Creation, 1989 + + + Thomas + Kłoczko + kloczek@pld.org.pl + shadow-utils maintainer, 2000 - 2007 + + + Nicolas + François + nicolas.francois@centraliens.net + shadow-utils maintainer, 2007 - now + + + + login + 1 + User Commands + shadow-utils + &SHADOW_UTILS_VERSION; + + + login + begin session on the system + + + + + login + -p + -h host + + username + ENV=VAR + + + login + -p + -h host + -f + username + + + login + -p + -r host + + + + + DESCRIPTION + + The login program is used to establish a new session + with the system. It is normally invoked automatically by responding to + the login: prompt on the user's + terminal. login may be special to the shell and may + not be invoked as a sub-process. When called from a shell, + login should be executed as + exec login which will cause the user + to exit from the current shell (and thus will prevent the new logged + in user to return to the session of the caller). Attempting to + execute login from any shell but the login shell + will produce an error message. + + + + The user is then prompted for a password, where appropriate. Echoing + is disabled to prevent revealing the password. Only a small number of + password failures are permitted before login exits + and the communications link is severed. + + + + If password aging has been enabled for your account, you may be + prompted for a new password before proceeding. You will be forced to + provide your old password and the new password before continuing. + Please refer to + passwd1 + for more information. + + + + After a successful login, you will be informed of any system messages + and the presence of mail. You may turn off the printing of the system + message file, /etc/motd, by creating a + zero-length file .hushlogin in your login directory. + The mail message will be one of "You have new + mail.", "You have mail.", or + "No Mail." according to the condition of your + mailbox. + + + + Your user and group ID will be set according to their values in the + /etc/passwd file. The value for + $HOME, $SHELL, $PATH, + $LOGNAME, and $MAIL are set according + to the appropriate fields in the password entry. Ulimit, umask and nice + values may also be set according to entries in the GECOS field. + + + + On some installations, the environmental variable + $TERM will be initialized to the terminal type on + your tty line, as specified in /etc/ttytype. + + + + An initialization script for your command interpreter may also be + executed. Please see the appropriate manual section for more + information on this function. + + + + A subsystem login is indicated by the presence of a "*" as the first + character of the login shell. The given home directory will be used as + the root of a new file system which the user is actually logged into. + + + + The login program is NOT responsible for removing + users from the utmp file. It is the responsibility of + getty + 8 and + init + 8 to clean up apparent ownership + of a terminal session. If you use login from the + shell prompt without exec, the user you use will + continue to appear to be logged in even after you log out of the + "subsession". + + + + + + OPTIONS + + + + + + + + Do not perform authentication, user is preauthenticated. + + + Note: In that case, username is + mandatory. + + + + + + + + + Name of the remote host for this login. + + + + + + + + Preserve environment. + + + + + + + + Perform autologin protocol for rlogin. + + + + + + The , and + options are only used when login is invoked by + root. + + + + + CAVEATS + + This version of login has many compilation options, + only some of which may be in use at any particular site. + + + The location of files is subject to differences in system + configuration. + + + + The login program is NOT responsible for removing + users from the utmp file. It is the responsibility of + getty8 + and + init8 + to clean up apparent ownership of a terminal session. + If you use login from the shell prompt without + exec, the user you use will continue to appear to + be logged in even after you log out of the "subsession". + + + + As with any program, login's appearance can be faked. + If non-trusted users have physical access to a machine, an + attacker could use this to obtain the password of the next person + coming to sit in front of the machine. Under Linux, the SAK mechanism can be + used by users to initiate a trusted path and prevent this kind of + attack. + + + + + + CONFIGURATION + + The following configuration variables in + /etc/login.defs change the behavior of this + tool: + + + &CONSOLE; + &CONSOLE_GROUPS; + &DEFAULT_HOME; + &ENV_HZ; + &ENV_PATH; + &ENV_SUPATH; + &ENV_TZ; + &ENVIRON_FILE; + &ERASECHAR; + &FAIL_DELAY; + &FAILLOG_ENAB; + &FAKE_SHELL; + &FTMP_FILE; + &HUSHLOGIN_FILE; + &ISSUE_FILE; + &KILLCHAR; + &LASTLOG_ENAB; + &LOGIN_RETRIES; + &LOGIN_STRING; + &LOGIN_TIMEOUT; + &LOG_OK_LOGINS; + &LOG_UNKFAIL_ENAB; + &MAIL_CHECK_ENAB; + &MAIL_DIR; + &MOTD_FILE; + &NOLOGINS_FILE; + &PORTTIME_CHECKS_ENAB; + "AS_ENAB; + &TTYGROUP; + &TTYTYPE_FILE; + &ULIMIT; + &UMASK; + &USERGROUPS_ENAB; + + + + + FILES + + + /var/run/utmp + + List of current login sessions. + + + + /var/log/wtmp + + List of previous login sessions. + + + + /etc/passwd + + User account information. + + + + /etc/shadow + + Secure user account information. + + + + /etc/motd + + System message of the day file. + + + + /etc/nologin + + Prevent non-root users from logging in. + + + + /etc/ttytype + + List of terminal types. + + + + $HOME/.hushlogin + + Suppress printing of system messages. + + + + /etc/login.defs + + Shadow password suite configuration. + + + + + + + SEE ALSO + + + mail1 + , + + passwd1 + , + + sh1 + , + + su1 + , + + login.defs5 + , + + nologin5 + , + + passwd5 + , + + securetty5 + , + + getty8 + . + + + -- cgit v1.2.3