.TH newusr "" "" Command
.PC "Add new user to \*(CO system"
\fB/etc/newusr \fIlogin "User Name" parentdir \fB[ \fIshell \fB]\fR
.PP
.II "login identifier"
.B newusr
adds a new user to the system.
It automatically adds an entry to the file
.BR /etc/passwd ,
creates a home directory for the user, installs the user in the mail system,
and otherwise performs the myriad tasks required to add a new user to your
\*(CO system.
.PP
.I login
is the login idenifier of the new user.
This is a single word in lower case, by which that user is identified.
Note that each user must have a unique login identifier.
Identifiers are usually the user's first name, initials, or a nickname.
.I parentdir
is the directory or (more usually) the file system in which
.B newusr
will create the new user's home directory.
.I "User Name"
is the name of the human for whom
.I login
is being created.
.I shell
names the shell to be used; the default is the Bourne shell
.BR /bin/sh .
.PP
For example, the command
.DM
	/etc/newusr batman "Bruce Wayne" /v /usr/bin/ksh
.DE
.PP
creates new user Bruce Wayne, with login
.BR batman ,
home directory
.BR /v/batman ,
and default shell
.BR /usr/bin/ksh .
.SH Files
.nf
.B
\fB/etc/group\fR \(em User groups
.br
\fB/etc/passwd\fR \(em User passwords
.br
\fI/parentdir/user\fR \(em User home directory
.br
\fB/usr/spool/mail/\fIuser\fR \(em User mailbox
.SH "See Also"
.Xr "commands," commands
.Xr "passwd," passwd
.Xr "welcome" welcome
.SH Diagnostics
.B newusr
complains if an entry for
.I user
already exists in the password file.
.SH Notes
Only the superuser can add new users to the system with
.BR newusr .
