xref: /csrg-svn/share/man/man8/adduser.8 (revision 47467)
1*47467Scael.\" Copyright (c) 1980, 1991 The Regents of the University of California.
236873Sbostic.\" All rights reserved.
318821Smckusick.\"
443808Strent.\" %sccs.include.redist.man%
518821Smckusick.\"
6*47467Scael.\"     @(#)adduser.8	6.8 (Berkeley) 03/16/91
736873Sbostic.\"
8*47467Scael.Dd
9*47467Scael.Dt ADDUSER 8
10*47467Scael.Os BSD 4
11*47467Scael.Sh NAME
12*47467Scael.Nm adduser
13*47467Scael.Nd procedure for adding new users
14*47467Scael.Sh DESCRIPTION
1518821SmckusickA new user must choose a login name, which must not already appear in
16*47467Scael.Pa /etc/passwd
17*47467Scaelor
18*47467Scael.Pa /etc/aliases .
19*47467ScaelIt must also not begin with the hyphen
20*47467Scael.Ql Fl
21*47467Scaelcharacter.
2237183SbosticIt is strongly recommended that it be all lower-case, and not contain
23*47467Scaelthe dot
24*47467Scael.Ql \&.
25*47467Scaelcharacter, 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
28*47467Scael.Xr chpass 1
2936873Sbosticor
30*47467Scael.Xr vipw 8 .
31*47467Scael.Pp
3218821SmckusickA new user is given a group and user id.
33*47467ScaelLogin 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.
38*47467Scael.Pp
39*47467ScaelA skeletal account for a new user
40*47467Scael\*(lqernie\*(rq
41*47467Scaelmight look like:
42*47467Scael.Bd -literal
43*47467Scaelernie::25:30::0:0:Ernie Kovacs,508 Evans Hall,x7925,
44*47467Scael	642-8202:/a/users/ernie:/bin/csh
45*47467Scael.Ed
46*47467Scael.Pp
4736873SbosticFor a description of each of these fields, see
48*47467Scael.Xr passwd 5 .
49*47467Scael.Pp
5018821SmckusickIt is useful to give new users some help in getting started, supplying
5118821Smckusickthem with a few skeletal files such as
52*47467Scael.Pa \&.profile
53*47467Scaelif they use
54*47467Scael.Pa /bin/sh ,
55*47467Scaelor
56*47467Scael.Pa \&.cshrc
5718821Smckusickand
58*47467Scael.Pa \&.login
59*47467Scaelif they use
60*47467Scael.Pa /bin/csh .
6118821SmckusickThe directory
62*47467Scael.Pa /usr/share/skel
63*47467Scaelcontains skeletal definitions of such files.
6418821SmckusickNew users should be given copies of these files which, for instance,
6536873Sbosticuse
66*47467Scael.Xr tset 1
6718821Smckusickautomatically at each login.
68*47467Scael.Sh FILES
69*47467Scael.Bl -tag -width /etc/master.passwdxx -compact
70*47467Scael.It Pa /etc/master.passwd
71*47467Scaeluser database
72*47467Scael.It Pa /usr/share/skel
73*47467Scaelskeletal login directory
74*47467Scael.El
75*47467Scael.Sh SEE ALSO
76*47467Scael.Xr chpass 1 ,
77*47467Scael.Xr finger 1 ,
78*47467Scael.Xr passwd 1 ,
79*47467Scael.Xr aliases 5 ,
80*47467Scael.Xr passwd 5 ,
81*47467Scael.Xr pwd_mkdb 8 ,
82*47467Scael.Xr vipw 8
83*47467Scael.Sh BUGS
8436873SbosticUser information should (and eventually will) be stored elsewhere.
85*47467Scael.Sh HISTORY
86*47467ScaelThe
87*47467Scael.Nm
88*47467Scaelcommand appeared in
89*47467Scael.Bx 3.0 .
90