| 1 | .TH LOGIN 1 |
| 2 | .SH NAME |
| 3 | login \- sign on |
| 4 | .SH SYNOPSIS |
| 5 | .B login |
| 6 | [ username ] |
| 7 | .SH DESCRIPTION |
| 8 | The |
| 9 | .I login |
| 10 | command |
| 11 | is used when a user initially |
| 12 | signs on, or it may be used at any time to change |
| 13 | from one user to another. |
| 14 | The latter case is the one summarized above and |
| 15 | described here. |
| 16 | See `How to Get Started' for how to dial up initially. |
| 17 | .PP |
| 18 | If |
| 19 | .I login |
| 20 | is invoked without an argument, |
| 21 | it asks for a user name, and, if |
| 22 | appropriate, a password. |
| 23 | Echoing is turned off (if possible) during the typing of the password, |
| 24 | so it will not appear on the written record of the |
| 25 | session. |
| 26 | .PP |
| 27 | After a successful login, |
| 28 | accounting files are updated and |
| 29 | the user is informed of the |
| 30 | existence of |
| 31 | .I .mail |
| 32 | and message-of-the-day files. |
| 33 | .I Login |
| 34 | initializes the user and group IDs and the working directory, |
| 35 | then executes a command interpreter (usually |
| 36 | .IR sh (1)) |
| 37 | according to specifications found in a password file. |
| 38 | Argument 0 of the command interpreter is `\-sh. |
| 39 | .PP |
| 40 | Login is recognized by |
| 41 | .IR sh (1) |
| 42 | and executed directly (without forking). |
| 43 | .SH FILES |
| 44 | .ta \w'/usr/spool/mail/*\ \ 'u |
| 45 | /etc/utmp accounting |
| 46 | .br |
| 47 | /usr/adm/wtmp accounting |
| 48 | .br |
| 49 | /usr/spool/mail/* mail |
| 50 | .br |
| 51 | /etc/motd message-of-the-day |
| 52 | .br |
| 53 | /etc/passwd password file |
| 54 | .SH "SEE ALSO" |
| 55 | init(8), newgrp(1), getty(8), mail(1), passwd(1), passwd(5) |
| 56 | .SH DIAGNOSTICS |
| 57 | `Login incorrect,' |
| 58 | if the name or the password is bad. |
| 59 | .br |
| 60 | `No Shell', `cannot open password file', `no directory': |
| 61 | consult a programming counselor. |