From 486ae553a85e96c2e889401bf325eb2bdbf55ba2 Mon Sep 17 00:00:00 2001 From: Bill Joy Date: Tue, 27 Nov 1979 20:14:03 -0800 Subject: [PATCH] BSD 3 development Work on file usr/man/man8/adduser.8 Synthesized-from: 3bsd --- usr/man/man8/adduser.8 | 91 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 91 insertions(+) create mode 100644 usr/man/man8/adduser.8 diff --git a/usr/man/man8/adduser.8 b/usr/man/man8/adduser.8 new file mode 100644 index 0000000000..449d1b8313 --- /dev/null +++ b/usr/man/man8/adduser.8 @@ -0,0 +1,91 @@ + +.TH ADDUSER 8 +.UC +.SH NAME +adduser \- procedure for adding new users +.SH DESCRIPTION +A new user must choose a login name, which must not already appear in +.I /etc/passwd. +An account can be added by editing a line into the passwd file, +with no password given, and giving a user and group id for the +account. User id's should be distinct across a system, since they +are used to control access to files. Typically, users working on +similar projects will be put in the same group. Thus at UCB we have +groups for system staff, faculty, graduate students, and a few special +groups for large projects. System staff is group ``10'' for historical +reasons, and the super-user is in this group. The +.IR su (1) +program looks at your user and group id before it lets you become +the super-user, and should implement whatever policy you choose to administer +for limiting access to super-user privileges. +.PP +A skeletal account for a new user ``ernie'' would look like: +.IP +ernie::235:20:& Kovacs,508E,7925,6428202:/mnt/grad/ernie:/bin/csh +.PP +The first field is the login name ``ernie''. The next field is the +encrypted password which is not given and can be initialized using +.IR passwd (1). +The next two fields are the user and group id's. +Traditionally, users in group 20 are graduate students and have account +names with numbers in the 200's. +The next field gives information about ernie's real name, office and office +phone and home phone. +This information is used by the +.IR finger (1) +program. +From this information we can tell that ernie's real name is +``Ernie Kovacs'' (the & here serves to repeat ``ernie'' with appropriate +capitalization), that his office is 508 Evans Hall, his extension +is x2-7925, and this his home phone number is 642-8202. +You can modify the +.IR finger (1) +program if necessary to allow different information to be encoded in +this field. The UCB version of finger knows several things particular +to Berkeley \- that phone extensions start ``2\-'', that offices ending +in ``E'' are in Evans Hall and that offices ending in ``C'' are in Cory Hall. +.PP +The final two fields give a login directory and a login shell name. +Traditionally, user files live on the file system +.B /mnt +and there are subdirectories there for each group of users, i.e.: +``/mnt/staff'' and ``/mnt/prof''. +The login shell will default to ``/bin/sh'' if none is given. +Most users at Berkeley choose ``/bin/csh'' so this is usually specified here. +.PP +It is useful to give new users some help in getting started, supplying +them with a few skeletal files such as +.I \&.profile +if they use ``/bin/sh'', or +.I \&.cshrc +and +.I \&.login +if they use ``/bin/csh''. +The directory +``/usr/skel'' contains skeletal definitions of such files. +New users should be given copies of these files which, for instance, +arrange to use +.IR tset (1), +.IR msgs (1) +and +.IR mail (1) +automatically at each login. +.SH FILES +.ta 2i +/etc/passwd password file +.br +/mnt/* login directories +.br +/usr/skel skeletal login directory +.SH SEE ALSO +passwd(1), finger(1), chsh(1), chfn(1), passwd(5) +.SH BUGS +We don't say how to lock out the password file so you can't get messed +up if someone runs +.IR passwd (1) +while you are editing it. +We currently just don't worry about this. +The trick is to make a file ``/etc/ptmp'' so that +.I passwd +will say +``Temporary file busy \- try again'', and to remove it when you are done. -- 2.20.1