shadow/man/newusers.8

70 lines
1.7 KiB
Groff

.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "NEWUSERS" 8 "" "" ""
.SH NAME
newusers \- update and create new users in batch
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 9
\fBnewusers\fR [\fInew_users\fR]
.ad
.hy
.SH "DESCRIPTION"
.PP
\fBnewusers\fR reads a file of user name and clear\-text password pairs and uses this information to update a group of existing users or to create new users\&. Each line is in the same format as the standard password file (see \fBpasswd\fR(5)) with the following exceptions:
.TP
\fIpw_passwd\fR
This field will be encrypted and used as the new value of the encrypted password\&.
.TP
\fIpw_age\fR
This field will be ignored for shadow passwords if the user already exists\&.
.TP
\fIpw_gid\fR
This field may be the name of an existing group, in which case the named user will be added as a member\&. If a non\-existent numerical group is given, a new group will be created having this number\&.
.TP
\fIpw_dir\fR
This field will be checked for existence as a directory and a new directory with the same name will be created if it does not already exist\&. The ownership of the directory will be set to be that of the user being created or updated\&.
.PP
This command is intended to be used in a large system environment where many accounts are updated at a single time\&.
.SH "CAVEATS"
.PP
The input file must be protected since it contains unencrypted passwords\&.
.SH "SEE ALSO"
.PP
\fBpasswd\fR(1), \fBuseradd\fR(8)
.SH "AUTHOR"
.PP
Julianne Frances Haugh (jockgrrl@ix\&.netcom\&.com)