Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
ADDUSER(8)              FreeBSD System Manager's Manual             ADDUSER(8)

NAME
     adduser -- command for adding new users

SYNOPSIS
     adduser [-check_only] [-class login_class] [-config_create]
             [-dotdir dotdir] [-group login_group] [-h | -help] [-home home]
             [-message message_file] [-noconfig] [-shell shell]
             [-s | -silent | -q | -quiet] [-uid uid_start] [-v | -verbose]

DESCRIPTION
     Adduser is a simple program for adding new users.  Adduser checks the
     passwd, group and shell databases.  It creates passwd/group entries, HOME
     directory, dotfiles and sends the new user a welcome message.

RESTRICTIONS
     username
             Login name.  May contain only lowercase characters or digits.
             Maximum length is 16 characters (see setlogin(2) BUGS section).
             The reasons for this limit are "Historical".  Given that people
             have traditionally wanted to break this limit for aesthetic rea-
             sons, 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 world; people have done
             this and it works, but you will have problems with any precom-
             piled programs, or source that assumes the 8-character name limit
             and NIS.  The NIS protocol mandates an 8-character username.  If
             you need a longer login name for e-mail addresses, you can define
             an alias in /etc/mail/aliases.
     fullname
             Firstname and surname.  The `:' character is not allowed.
     shell   Only valid shells from the shell database or sliplogin and pppd
     uid     Automatically generated or your choice, must be less than 32000.
     gid/login group
             Your choice or automatically generated.
     password
             If not empty, password is encoded with crypt(3).

UNIQUE GROUPS
     Perhaps you're missing what 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 instead of the usual 022 and create
     files in their home directory without worrying about others being able to
     change them.

     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.

     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.

     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)

CONFIGURATION
     1.   Read internal variables.

     2.   Read configuration file (/etc/adduser.conf).

     3.   Parse command line options.

OPTIONS
     -check_only
             Check /etc/passwd, /etc/group, /etc/shells and exit.

     -class login_class
             Set default login class.

     -config_create
             Create new configuration and message file and exit.

     -dotdir directory
             Copy files from directory into the HOME directory of new users,
             `dot.foo' will be renamed to `.foo'.  Don't copy files if
             directory specified is equal to 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.

     -group login_group
             Login group.  USER means that the username is to be used as login
             group.

     -help, -h, -?
             Print a summary of options and exit.

     -home partition
             Default home partition where all users located.

     -message file
             Send new users a welcome message from file.  Specifying a value
             of no for file causes no message to be sent to new users.

     -noconfig
             Do not read the default configuration file.

     -shell shell
             Default shell for new users.

     -silent, -s, -quiet, -q
             Few warnings, questions, bug reports.

     -uid uid
             Use uid's from uid on up.

     -verbose, -v
             Many warnings, questions.  Recommended for novice users.

FORMATS
     `#' is a comment.
     configuration file
             Adduser reads and writes this file.  See /etc/adduser.conf for
             more details.
     message file
             Eval variables in this file.  See /etc/adduser.message for more
             details.

FILES
     /etc/master.passwd    user database
     /etc/group            group database
     /etc/shells           shell database
     /etc/login.conf       login classes database
     /etc/adduser.conf     configuration file for adduser
     /etc/adduser.message  message file for adduser
     /usr/share/skel       skeletal login directory
     /var/log/adduser      logfile for adduser

SEE ALSO
     chpass(1), finger(1), passwd(1), setlogin(2), aliases(5), group(5),
     login.conf(5), passwd(5), shells(5), pw(8), pwd_mkdb(8), rmuser(8),
     vipw(8), yp(8)

HISTORY
     The adduser command appeared in FreeBSD 2.1.

FreeBSD 4.10                    January 9, 1995                   FreeBSD 4.10

NAME | SYNOPSIS | DESCRIPTION | RESTRICTIONS | UNIQUE GROUPS | CONFIGURATION | OPTIONS | FORMATS | FILES | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=adduser&sektion=8&manpath=FreeBSD+4.10-RELEASE>

home | help