[unix-history] / usr / man / man1 / login.1

.TH LOGIN 1 
.SH NAME
login \- sign on
.SH SYNOPSIS
.B login
[ username ]
.SH DESCRIPTION
The
.I login
command
is used when a user initially
signs on, or it may be used at any time to change
from one user to another.
The latter case is the one summarized above and
described here.
See `How to Get Started' for how to dial up initially.
.PP
If
.I login
is invoked without an argument,
it asks for a user name, and, if
appropriate, a password.
Echoing is turned off (if possible) during the typing of the password,
so it will not appear on the written record of the
session.
.PP
After a successful login,
accounting files are updated and
the user is informed of the
existence of
.I .mail
and message-of-the-day files.
.I Login
initializes the user and group IDs and the working directory,
then executes a command interpreter (usually
.IR  sh (1))
according to specifications found in a password file.
Argument 0 of the command interpreter is `\-sh.
.PP
Login is recognized by
.IR sh (1)
and executed directly (without forking).
.SH FILES
.ta \w'/usr/spool/mail/*\ \ 'u
/etc/utmp	accounting
.br
/usr/adm/wtmp	accounting
.br
/usr/spool/mail/*	mail
.br
/etc/motd	message-of-the-day
.br
/etc/passwd	password file
.SH "SEE ALSO"
init(8), newgrp(1), getty(8), mail(1), passwd(1), passwd(5)
.SH DIAGNOSTICS
`Login incorrect,'
if the name or the password is bad.
.br
`No Shell', `cannot open password file', `no directory':
consult a programming counselor.
Commit	Line	Data
a7d62908 BJ	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.