From e598c3138624cfea939208fa4775d81c30ad8e6f Mon Sep 17 00:00:00 2001 From: Mike Pritchard Date: Mon, 23 Dec 1996 00:10:22 +0000 Subject: 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. --- adduser/addgroup.8 | 22 +++++---- adduser/adduser.8 | 136 ++++++++++++++++++++++++++------------------------- adduser/adduser.perl | 6 +-- adduser/rmgroup.8 | 10 ++-- adduser/rmuser.8 | 7 ++- 5 files changed, 94 insertions(+), 87 deletions(-) (limited to 'adduser') 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 -- cgit v1.2.3-56-ge451