summaryrefslogtreecommitdiffstats
path: root/adduser
diff options
context:
space:
mode:
authorMike Pritchard <mpp@FreeBSD.org>1996-12-23 00:10:22 +0000
committerMike Pritchard <mpp@FreeBSD.org>1996-12-23 00:10:22 +0000
commite598c3138624cfea939208fa4775d81c30ad8e6f (patch)
tree6f6ad0e5e9ee198fe1971d53bb7696214562b2fa /adduser
parent0c9f365da25caa3b04bcfe82b70ee49aab96e619 (diff)
downloadpw-darwin-e598c3138624cfea939208fa4775d81c30ad8e6f.tar.gz
pw-darwin-e598c3138624cfea939208fa4775d81c30ad8e6f.tar.zst
pw-darwin-e598c3138624cfea939208fa4775d81c30ad8e6f.zip
Minor style fixes.
I also renamed the adduser "-quit" option to "-quiet", since it is supposed to be the same as the -s/-silent option, and -quit must have beena typo.
Diffstat (limited to 'adduser')
-rw-r--r--adduser/addgroup.822
-rw-r--r--adduser/adduser.8136
-rw-r--r--adduser/adduser.perl6
-rw-r--r--adduser/rmgroup.810
-rw-r--r--adduser/rmuser.87
5 files changed, 94 insertions, 87 deletions
diff --git a/adduser/addgroup.8 b/adduser/addgroup.8
index 2ce5e65..371c40b 100644
--- a/adduser/addgroup.8
+++ b/adduser/addgroup.8
@@ -22,7 +22,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: adduser.8,v 1.12 1996/08/28 17:54:13 adam Exp $
+.\" $Id: addgroup.8,v 1.1 1996/11/04 17:21:10 wosch Exp $
.Dd Oct, 30, 1996
.Dt ADDGROUP 8
@@ -34,17 +34,19 @@
.Nm
.Op Fl g Ar gid
.Ar group
-.Op Ar user Op , Ar user,...
+.Op Ar user Ns , Ns Ar user,...
.Sh DESCRIPTION
+The
.Nm
-add a group to
+command adds a group to the
.Xr group 5
database.
-Optional
+The optional
.Ar user
-initialized the group with group members.
+is added to the group membership list.
+The
.Ar user
-may be a comma separated list of user names.
+argument may be a comma separated list of user names.
If
.Ar group
already exists
@@ -52,14 +54,14 @@ already exists
add
.Ar user
to the
-.Ar group.
+.Ar group .
.Sh OPTIONS
.Bl -tag -width Ds
.It Sy -g gid
Create new group with group id
.Ar gid
-if possible or higher. Default gid is 1000.
-This option has only affects for new groups.
+if possible or the next higher id that is available. Default gid is 1000.
+This option only applies to new groups.
.El
.Sh EXAMPLES
.Pp
@@ -70,7 +72,7 @@ Add group `cracau' with group identification 5000 or higher.
$ addgroup foo blech,bar
.Pp
Add user `blech' and user `bar' to group `foo'. Create group
-`foo' if not exists.
+`foo' if it does not exist.
.Sh SEE ALSO
.Xr group 5 ,
.Xr adduser 8 ,
diff --git a/adduser/adduser.8 b/adduser/adduser.8
index 2d87f5b..943b769 100644
--- a/adduser/adduser.8
+++ b/adduser/adduser.8
@@ -22,34 +22,40 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: adduser.8,v 1.12 1996/08/28 17:54:13 adam Exp $
-
+.\" $Id: adduser.8,v 1.13 1996/11/17 03:51:29 wosch Exp $
.Dd Jan, 9, 1995
.Dt ADDUSER 8
.Os FreeBSD 2.1
.Sh NAME
.Nm adduser
.Nd command for adding new users
-
.Sh SYNOPSIS
.Nm adduser
- [-batch username [group[,group]...] [fullname] [password]]
- [-check_only] [-config_create] [-dotdir dotdir]
- [-group login_group] [-h|-help] [-home home]
- [-message message_file] [-noconfig] [-shell shell]
- [-s|-silent|-q|-quit] [-uid uid_start] [-v|-verbose]
-
-
+.Ns [ Fl batch Ar username
+.Op Ar group,[group]...
+.Op Ar fullname
+.Op Ar password ]
+.Op Fl check_only
+.Op Fl config_create
+.Op Fl dotdir Ar dotdir
+.Op Fl group Ar login_group
+.Op Fl h | help
+.Op Fl home Ar home
+.Op Fl message Ar message_file
+.Op Fl noconfig
+.Op Fl shell Ar shell
+.Op Fl s | silent | q | quiet
+.Op Fl uid Ar uid_start
+.Op Fl v | verbose
.Sh DESCRIPTION
.Nm Adduser
is a simple program for adding new users. Adduser checks
-passwd, group and shell database. It creates passwd/group entry,
-HOME-directory, dotfiles and sends new user a welcome message.
-
-.Sh RESTRICTION
+the passwd, group and shell databases. It creates passwd/group entries,
+HOME-directory, dotfiles and sends the new user a welcome message.
+.Sh RESTRICTIONS
.Bl -tag -width Ds -compact
.It Sy username
-Login name. Only lowercase characters or digits. Maximum length
+Login name. May contain only lowercase characters or digits. Maximum length
is 8 characters (see
.Xr setlogin 2
BUGS section).
@@ -57,7 +63,11 @@ The reasons for this limit are "Historical".
Given that people have traditionally wanted to break this
limit for aesthetic reasons, it's never been of great importance to break
such a basic fundamental parameter in UNIX.
-You can change UT_NAMESIZE in /usr/include/utmp.h and recompile the
+You can change
+.Dv UT_NAMESIZE
+in
+.Pa /usr/include/utmp.h
+and recompile the
world; people have done this and it works, but you will have problems
with any precompiled programs, or source that assumes the 8-character
name limit and NIS. The NIS protocol mandates an 8-character username.
@@ -66,35 +76,37 @@ you can define an alias in
.Pa /etc/aliases .
.It Sy fullname
Firstname and surname.
+The
.Ql Pa \:
-not allowed.
+character is not allowed.
.It Sy shell
-Only valid shells from shell database or sliplogin and pppd
+Only valid shells from the shell database or sliplogin and pppd
.It Sy uid
-Automatically generated or your choice, less than 32000.
+Automatically generated or your choice, must be less than 32000.
.It Sy gid/login group
Your choice or automatically generated.
.It Sy password
-If not empty, password is encoded with crypt.
+If not empty, password is encoded with
+.Xr crypt 3 .
.El
-
-.Sh UNIQUE GROUP
-Perhaps you're missing what *can* be done with this scheme that falls apart
+.Sh UNIQUE GROUPS
+Perhaps you're missing what
+.Em can
+be done with this scheme that falls apart
with most other schemes. With each user in his/her own group the user can
safely run with a umask of 002 and have files created in their home directory
and not worry about others being able to read them.
-
+.Pp
For a shared area you create a separate uid/gid (like cvs or ncvs on freefall),
you place each person that should be able to access this area into that new
group.
-
+.Pp
This model of uid/gid administration allows far greater flexibility than lumping
users into groups and having to muck with the umask when working in a shared
area.
-
+.Pp
I have been using this model for almost 10 years and found that it works
for most situations, and has never gotten in the way. (Rod Grimes)
-
.Sh CONFIGURATION
.Bl -tag -width Ds -compact
.It Sy 1.
@@ -104,18 +116,14 @@ Read config file (/etc/adduser.conf)
.It Sy 3.
Parse command line options
.El
-
.Sh OPTIONS
.Bl -tag -width Ds
.It Sy -batch username [group[,group]...] [fullname] [password]
Batch mode.
-
.It Sy -check_only
Check /etc/passwd, /etc/group, /etc/shells and exit.
-
.It Sy -create_config
Create new config and message file and exit.
-
.It Sy -dotdir Ar directory
Copy files from
.Ar directory
@@ -125,88 +133,87 @@ files renamed to
.Ql Pa .foo .
Don't copy files if
.Ar directory
-equal with
+specified is equal to
.Ar no .
For security make all files writable and readable for owner,
don't allow group or world to write files and allow only owner
-to read/execute/write .rhost, .Xauthority, .kermrc, .netrc, Mail,
-prv, iscreen, term.
-
+to read/execute/write
+.Pa .rhost ,
+.Pa .Xauthority ,
+.Pa .kermrc ,
+.Pa .netrc ,
+.Pa Mail ,
+.Pa prv ,
+.Pa iscreen ,
+.Pa term .
.It Sy -group Ar login_group
Login group.
.Ar USER
means use username as login group.
-
.It Sy -help,-h,-?
Print options and exit.
-
.It Sy -home Ar partition
Default home partition where all users located.
-
.It Sy -message Ar file
Send new users a welcome message.
Don't send message if
.Ar file
equal with
.Ar no .
-
.It Sy -noconfig
Do not read config file.
-
.It Sy -shell Ar shell
Default shell for new users.
-
-.It Sy -silent,-s,-quit,-q
-Few warnings, question, bug reports.
-
+.It Sy -silent,-s,-quiet,-q
+Few warnings, questions, bug reports.
.It Sy -uid Ar uid
Use uid's from
.Ar uid
-up.
-
+on up.
.It Sy -verbose,-v
-Many warning, question. Recommended for novice users.
-
-
-
+Many warnings, questions. Recommended for novice users.
.Sh FORMATS
.Bl -tag -width Ds -compact
.Ql Pa #
is a comment.
-
-.P
.It Sy config file
.Nm Adduser
reads and writes this file.
-See /etc/adduser.conf for more details.
+See
+.Pa /etc/adduser.conf
+for more details.
.It Sy message file
-Eval variables in this file. See /etc/adduser.message for more
+Eval variables in this file. See
+.Pa /etc/adduser.message
+for more
details.
.El
-
.Sh EXAMPLES
.Pp
$ adduser
.Pp
Start adduser in interactive mode.
-
.Pp
$ adduser -batch baerenklau guest,staff,baer 'Teddy II' qwerty7
.Pp
Create user 'baerenklau' and login group 'baerenklau'. Invite user
baerenklau into groups guest, staff and baer. Realname (fullname)
-is 'Teddy II'. Password is 'qwerty7' (don't use such password!). Create
-HOME directory '/home/baerenklau' and copy all files and directories
-from /usr/share/skel to /home/baerenklau. Send user baerenklau
+is 'Teddy II'. Password is 'qwerty7' (don't use such passwords!). Create
+HOME directory
+.Pa /home/baerenklau
+and copy all files and directories
+from
+.Pa /usr/share/skel
+to
+.Pa /home/baerenklau .
+Send user baerenklau
a welcome message.
-
.Pp
$ adduser -uid 5000 -group guest -message no -batch vehlefanz
.Pp
-Create user 'vehlefanz'. Login group is guest. Uid is up to
-5000, for instance 5007. No other groups, no realname, no password.
+Create user 'vehlefanz'. Login group is guest. Uid next available uid
+after 5000, for instance 5007. No other groups, no realname, no password.
Do not send a welcome message.
-
.Sh FILES
.Bl -tag -width /etc/master.passwdxx -compact
.It Pa /etc/master.passwd
@@ -224,7 +231,6 @@ skeletal login directory
.It Pa /var/log/adduser
logfile for adduser
.El
-
.Sh SEE ALSO
.Xr chpass 1 ,
.Xr finger 1 ,
@@ -240,9 +246,7 @@ logfile for adduser
.Xr rmgroup 8 ,
.Xr rmuser 8 ,
.Xr vipw 8
-
.\" .Sh BUGS
-
.Sh HISTORY
The
.Nm
diff --git a/adduser/adduser.perl b/adduser/adduser.perl
index 7c5cd98..1ff397d 100644
--- a/adduser/adduser.perl
+++ b/adduser/adduser.perl
@@ -24,7 +24,7 @@
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE.
#
-# $Id: adduser.perl,v 1.21 1996/11/27 22:04:55 ache Exp $
+# $Id: adduser.perl,v 1.22 1996/12/07 21:25:12 ache Exp $
# read variables
@@ -789,7 +789,7 @@ usage: adduser
[-message message_file]
[-noconfig]
[-shell shell]
- [-s|-silent|-q|-quit]
+ [-s|-silent|-q|-quiet]
[-uid uid_start]
[-v|-verbose]
@@ -854,7 +854,7 @@ sub parse_arguments {
shift @argv;
last if /^--$/;
if (/^--?(v|verbose)$/) { $verbose = 1 }
- elsif (/^--?(s|silent|q|quit)$/) { $verbose = 0 }
+ elsif (/^--?(s|silent|q|quiet)$/) { $verbose = 0 }
elsif (/^--?(debug)$/) { $verbose = 2 }
elsif (/^--?(h|help|\?)$/) { &usage }
elsif (/^--?(home)$/) { $home = $argv[0]; shift @argv }
diff --git a/adduser/rmgroup.8 b/adduser/rmgroup.8
index 3a867c5..5426836 100644
--- a/adduser/rmgroup.8
+++ b/adduser/rmgroup.8
@@ -22,7 +22,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: adduser.8,v 1.12 1996/08/28 17:54:13 adam Exp $
+.\" $Id: rmgroup.8,v 1.1 1996/11/04 17:21:11 wosch Exp $
.Dd Oct, 30, 1996
.Dt RMGROUP 8
@@ -35,11 +35,13 @@
.Ar group
.Sh DESCRIPTION
.Nm
-delete a Unix group from group database.
+delete a Unix group from the
+.Xr group 5
+database.
.Nm
-do not delete the system groups wheel, daemon, kmem, sys, tty,
+will not delete the system groups wheel, daemon, kmem, sys, tty,
operator, bin, nogroup, nobody,
-and not groups with gid 0.
+or groups with gid 0.
.Sh SEE ALSO
.Xr group 5 ,
.Xr adduser 8 ,
diff --git a/adduser/rmuser.8 b/adduser/rmuser.8
index 32dd2fa..c0901ae 100644
--- a/adduser/rmuser.8
+++ b/adduser/rmuser.8
@@ -24,7 +24,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
-.\" $Id: rmuser.8,v 1.2 1996/08/11 13:03:24 wosch Exp $
+.\" $Id: rmuser.8,v 1.1 1996/11/17 03:51:31 wosch Exp $
.\"
.Dd July 16, 1996
.Dt RMUSER 8
@@ -36,9 +36,9 @@
.Nm rmuser
.Op Ar username
.Sh DESCRIPTION
-The utility
+The
.Nm rmuser
-removes a user's
+utility removes a user's
.Xr crontab 1
entry (if any) and any
.Xr at 1
@@ -100,6 +100,5 @@ The
.Nm
command appeared in
.Fx 2.1.5 .
-
.\" .Sh AUTHOR
.\" Guy Helmer, Madison, South Dakota