admuser(1M) DG/UX R4.11MU05 admuser(1M)
NAME
admuser - manage user information in the password database
SYNOPSIS
admuser -o add [ -yp ] [ -u uid ] [ -g gid ] [ -G gid[,gid ... ] ] [
-d home-directory ] [ -m [ -S home-directory-size ] [ -k
skeleton-directory ] ] [ -c comment ] [ -s shell ] [ -n
min-age ] [ -x max-age ] login
admuser -o modify [ -yp ] [ -u uid ] [ -g gid ] [ -G gid[,gid ... ] ]
[ -d home-directory ] [ -m [ -S home-directory-size ] ] [
-c comment ] [ -s shell ] [ -n min-age ] [ -x max-age ] [
-l new-login ] login
admuser -o delete [ -yr ] login ...
admuser -o list [ -yqvar ] [ -u uid ] [ -g gid ] [ login ... ]
admuser -o get [ -qv ]
admuser -o set [ -g gid ] [ -b base-directory ] [ -S home-directory-
size ] [ -k skeleton-directory ] [ -s shell ]
DESCRIPTION
admuser will manage information in the local or NIS (YP) password
database file. The passwd(4) file contains basic information about
each user's account.
admuser is normally run by the system administrator on the NIS master
machine if the system is running NIS, or on any host if the system is
not running NIS.
Operations
add This operation will add a new user to the password file.
If the specified login already exists, the operation will
not be successful. If the -m option is specified then the
home-directory for login will be created and the contents
of the skeleton-directory will be copied to the home
directory.
modify This operation will modify the currently existing
information in the local or NIS password file. The
command-line options will determine the changes that are
made to the login entry in the password database. If the
-m and -d options are specified, an attempt is made to copy
the files in the old home directory owned by this user to
the new home-directory.
delete This operation will delete the given login(s) from the
password file. If the -r option is specified, then the
user's home directory will be removed from the system, if
possible.
list This operation will list the login(s) in the password
database who match the qualifications specified in the
command-line options. If no command-line options are
given, then only the local user database will be listed.
The -r option lists the directories considered system
directories for purposes of the delete operation.
get This operation will obtain and list the default gid, base-
directory, home-directory-size, skeleton-directory, and
shell that will be used when adding a new login with the
add operation.
set This operation will set the default gid, base-directory,
home-directory-size, skeleton-directory, and shell to be
used when adding a new login with the add operation.
Options
-y Perform the requested operation on the global NIS database.
Without this option, the requested operation is performed
on the local database in the /etc directory. This option
is valid only when the machine on which the command is run
is the NIS master. The -y option uses the default source
directory derived from the SRC_DIR variable specified in
the NIS makefile (/etc/yp/Makefile).
-p Execute the passwd(1) program to set a password for the
user. The passwd program will be executed only if all
other additions or modifications have succeeded. Using the
-p option will cause the operation to become interactive.
-u uid Specifies the UID of the new user. It must be a non-
negative decimal integer less than or equal to MAXUID , as
defined in <sys/param.h>. It defaults to an available UID
greater than 99.
-g gid Specifies an existing group's integer ID, or character
string name. It defines the new user's group membership.
It defaults to the group general unless the default has
been changed with the set operation. For the set
operation, the gid specified will become the new default
group.
-G gid[,gid...]
A comma-separated list of existing groups' integer IDs or
character string names. It defines the new user's
supplementary group membership.
-d home-directory
Specifies the home directory of the new user. The default
home directory is base-directory/login.
-m If used while adding a new user, specifies that the system
is to attempt to make the home-directory for login. If -d
home-directory is not specified, base-directory is
concatenated with the user's login to define the home-
directory. The contents of the skeleton-directory are
copied to the newly created home-directory. The new
directory has owner uid and group gid. Permissions match
those of the skeleton-directory.
If used while modifying the home directory, an attempt is
made to copy the files in the old home directory owned by
this user to the new home-directory. This is simply a copy
operation. The old home directory and its contents are
undisturbed by the operation. If you want to remove the
files from the old home directory you must do it manually.
-S home-directory-size
Specifies whether the home-directory should be created as a
control point directory, and, if so, the size in blocks of
the control point directory. If this value is 0, a regular
directory will be created; otherwise, a control point
directory with a maximum block allocation of home-
directory-size blocks will be created.
-k skeleton-directory
Specifies a directory that contains skeleton information
(e.g. a .profile file) to copy into the new user's home
directory. The directory must exist. The system provides
a skeleton-directory, /etc/skel, that can be used for this
purpose.
-c comment
Specifies any text string. It is generally a short
description of the login, and is currently used as the
field for the user's full name. It is limited to 128
printable characters and should not include colon (:) or
newline.
-s shell Specifies the full pathname of the program that will be
used as the user's shell on login. This field is limited
to PATHMAX characters, as defined in <sys/param.h>. It
defaults to /sbin/sh. The shell must be a valid executable
file.
-n min-age
Specifies the minimum period in weeks that must elapse
before the password can be changed by the user.
-x max-age
Specifies the maximum number of weeks for which the user's
password is valid. If you try to login after your password
has expired, you must supply a new one.
-l new-login
Specifies a string of printable characters that is the new
login name for the user. It may not contain a colon (:) or
a newline and must be a unique login name.
-r If used while deleting a user, the user's home directory
will be removed from the system unless the home directory
is considered a system directory (directories such as /,
/usr, /usr/bin/*, /usr/lib/*). (Administrators must
manually delete any system directories used as home
directories.) The files and directories under the home
directory will no longer be accessible following successful
execution of the command.
Tells the list operation to display the directories
considered system directories for purposes of the delete
operation.
-a Specifies that the list operation will print all
information about login from the password database in an
unformatted report.
-b base-directory
Specifies the directory that is to be used as the base
directory in forming login's default home-directory. The
default base-directory is /home.
-q Quiet. Do not print headers for login reports.
-v Verbose. Print full login information, including headers.
This option is enabled by default.
EXAMPLES
In the following examples, the system administrator performs the
following actions: set the default group to cad and default base
directory to /home/cadusers; add a user, vanilla, which will create
the home directory, /home/cadusers/vanilla; modify the passwd
information about the user vanilla, changing the user id to 999 and
the comment to Vanilla CAD Account.
admuser -o set -g cad -b /home/cadusers
admuser -o add -m vanilla
admuser -o modify -u 999 -c "Vanilla CAD Account" vanilla
DIAGNOSTICS
Errors
- The file /etc/default/defadduser does not exist and cannot be
created.
- The add, delete, or modify operation was unable to update the
password database.
- The set operation was unable to update the user defaults.
Exit Codes
This section lists the possible exit codes and what they mean.
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
FILES
/etc/passwd Local password database file.
/etc/default/defadduser
Contains the defaults used by the add operation.
/etc/skel Default skeleton directory.
NOTES
You must have appropriate privilege to perform all operations except
list and get. On a generic DG/UX system, appropriate privilege is
granted by having an effective UID of 0 (root). See the
appropriateprivilege(5) man page for more information.
On a system with DG/UX information security, appropriate privilege is
granted by having one or more specific capabilities enabled in the
effective capability set of the user. See capdefaults(5) for the
default capabilities for this command.
A diskless workstation that updates his local password file must have
lockd(1M), the network lock daemon, running. The server must also
have the lock daemon running.
DG/UX ships /etc/passwd with permissions 0444 by default. The
admuser command attempts to ensure that these permissions remain
0444. If you have the appropriate privilege and wish to modify the
password database directly, you should use vipw(1M).
SEE ALSO
cpd(1), csh(1), login(1), sh(1), passwd(1), yppasswd(1), lockd(1M),
sysadm(1M), useradd(1M), userdel(1M), usermod(1M), vipw(1M),
passwd(4), profile(4), capdefaults(5).
Licensed material--property of copyright holder(s)