gno/usr.sbin/newuser/newuser.8
gdr-ftp 330e74b7e9 Makefile, mklink.data, mkso.data, newuser.desc, newuser.rez:
- initial checkin
README:
	- updated installation notes
installit, newuserv.c:
	- deleted (obsolete)
newuser.1:
	- renamed to newuser.8
newuser.c, newuser.8:
	- account home directories are now made in /home rather than /user
	- made all the routines internal to this file to be class 'static'
	- fit sources into GNO base distribution builds
	- added checks for parsing NEWID_FILE
	- added various conchecks to prevent buffer overflow and similar
	  problems
	- ensure the password is at least MIN_PASSWD_LEN characters long
	- don't set the terminal type; that is the responsibility of
	  initd/getty.
	- instead of creating explicit files in the user's home directory,
	  copy every file that is in the SKELETONS directory.
	- account creation is now logged via syslogd
	- added -g flag for selecting non-default group ids
	- check to ensure that the new uid returned by get_next_uid is
	  not already in use; if it is, then log a warning via syslog,
	  skip it, and get another uid
1999-02-15 00:22:11 +00:00

89 lines
2.1 KiB
Groff

.TH NEWUSER 8 "14 February 1999" GNO "System Administration"
.SH NAME
.BR newuser ,
.BR newuserv
\- add a new user to the system
.SH SYNOPSIS
.BR newuser
[
.BR -v
] [
.B -g
.I gid
]
.br
.BR newuserv
[
.BR -v
] [
.B -g
.I gid
]
.SH DESCRIPTION
This manual page documents
.B newuser
and
.B newuserv
version 1.2 for GNO. Its basic intent is
to let people add themselves to the system without requiring the system
administrator to do it all manually.
.LP
.B newuser
will ask for a real name, account name, terminal type and password (verifying
the password once) and then create the directory \fB/home/\fIaccount_name\fR.
.BR newuser
will also copy all the regular files from the
.BR /var/adm/newuser/skel
directory into the \fB/home/\fIaccount_name\fR directory.
It will not recurse.
Finally, it will add the appropriate entry to
.B /etc/passwd
and then exit.
.PP
If the
.B -v
(verify) flag is selected, or if invoked as
.BR newuserv ,
everything is done as normal, except that the new entry is appended to
.B /var/adm/newuser/pending
instead of being appended to
.BR /etc/passwd .
.LP
Accounts are normally created with group ID 100. The
.B -g
flag overrides this group ID.
.LP
Both
.BR newuser
and
.BR newuserv
will log created accounts via
.BR syslogd (8)
using the auth.info facility.
.LP
.B newuser
will time out after 60 seconds of operation.
.SH FILES
.IP \fB/home\fR
The directory where new user home directories will be placed.
.IP \fB/var/adm/newuser/newid\fR
The text file containing the next available user ID. It must consist
of exactly one line, containing only a decimal number.
.BR newuser
will update this file as required.
.IP \fB/var/adm/newuser/pending\fR
This file contains all of the
.BR /etc/passwd
entries that are waiting for approval before activation.
.IP \fB/var/adm/newuser/skel\fR
All regular files in this directory will be copied to the newly created
home directory.
.SH BUGS
.BR newuser
should create a lock file in
.BR /var/locks
to ensure that a race condition with multiple instantiations is avoided.
They are currently possible.
.SH AUTHOR
James Brookes. Maintained by Devin Reade.