xref: /csrg-svn/share/man/man8/adduser.8 (revision 61619)
1*61619Sbostic.\" Copyright (c) 1980, 1991, 1993
2*61619Sbostic.\"	The Regents of the University of California.  All rights reserved.
318821Smckusick.\"
443808Strent.\" %sccs.include.redist.man%
518821Smckusick.\"
6*61619Sbostic.\"     @(#)adduser.8	8.1 (Berkeley) 06/05/93
736873Sbostic.\"
847467Scael.Dd
947467Scael.Dt ADDUSER 8
1047467Scael.Os BSD 4
1147467Scael.Sh NAME
1247467Scael.Nm adduser
1347467Scael.Nd procedure for adding new users
1447467Scael.Sh DESCRIPTION
1518821SmckusickA new user must choose a login name, which must not already appear in
1647467Scael.Pa /etc/passwd
1747467Scaelor
1847467Scael.Pa /etc/aliases .
1947467ScaelIt must also not begin with the hyphen
2047467Scael.Ql Fl
2147467Scaelcharacter.
2237183SbosticIt is strongly recommended that it be all lower-case, and not contain
2347467Scaelthe dot
2447467Scael.Ql \&.
2547467Scaelcharacter, as that tends to confuse mailers.
2637183SbosticAn account can be added by editing a line into the passwd file; this
2737183Sbosticmust be done with the password file locked e.g. by using
2847467Scael.Xr chpass 1
2936873Sbosticor
3047467Scael.Xr vipw 8 .
3147467Scael.Pp
3218821SmckusickA new user is given a group and user id.
3347467ScaelLogin and user id's should be unique across the system, and often across
3437183Sbostica group of systems, since they are used to control file access.
3536873SbosticTypically, users working on similar projects will be put in the same groups.
3637183SbosticAt the University of California, Berkeley, we have groups for system staff,
3737183Sbosticfaculty, graduate students, and special groups for large projects.
3847467Scael.Pp
3947467ScaelA skeletal account for a new user
4047467Scael\*(lqernie\*(rq
4147467Scaelmight look like:
4247467Scael.Bd -literal
4347467Scaelernie::25:30::0:0:Ernie Kovacs,508 Evans Hall,x7925,
4447467Scael	642-8202:/a/users/ernie:/bin/csh
4547467Scael.Ed
4647467Scael.Pp
4736873SbosticFor a description of each of these fields, see
4847467Scael.Xr passwd 5 .
4947467Scael.Pp
5018821SmckusickIt is useful to give new users some help in getting started, supplying
5118821Smckusickthem with a few skeletal files such as
5247467Scael.Pa \&.profile
5347467Scaelif they use
5447467Scael.Pa /bin/sh ,
5547467Scaelor
5647467Scael.Pa \&.cshrc
5718821Smckusickand
5847467Scael.Pa \&.login
5947467Scaelif they use
6047467Scael.Pa /bin/csh .
6118821SmckusickThe directory
6247467Scael.Pa /usr/share/skel
6347467Scaelcontains skeletal definitions of such files.
6418821SmckusickNew users should be given copies of these files which, for instance,
6536873Sbosticuse
6647467Scael.Xr tset 1
6718821Smckusickautomatically at each login.
6847467Scael.Sh FILES
6947467Scael.Bl -tag -width /etc/master.passwdxx -compact
7047467Scael.It Pa /etc/master.passwd
7147467Scaeluser database
7247467Scael.It Pa /usr/share/skel
7347467Scaelskeletal login directory
7447467Scael.El
7547467Scael.Sh SEE ALSO
7647467Scael.Xr chpass 1 ,
7747467Scael.Xr finger 1 ,
7847467Scael.Xr passwd 1 ,
7947467Scael.Xr aliases 5 ,
8047467Scael.Xr passwd 5 ,
8147467Scael.Xr pwd_mkdb 8 ,
8247467Scael.Xr vipw 8
8347467Scael.Sh BUGS
8436873SbosticUser information should (and eventually will) be stored elsewhere.
8547467Scael.Sh HISTORY
8647467ScaelThe
8747467Scael.Nm
8847467Scaelcommand appeared in
8947467Scael.Bx 3.0 .
90