admuser(1M) DG/UX 5.4R3.00 admuser(1M)
NAME
admuser - manage user information in the password database
SYNOPSIS
admuser -o add [ -yp ] [ -u uid ] [ -g gid ] [ -d home-directory ] [
-S home-directory-size ] [ -m ] [ -c comment ] [ -s shell ]
login
admuser -o modify [ -yp ] [ -u uid ] [ -g gid ] [ -d home-directory ]
[ -S home-directory-size ] [ -m ] [ -c comment ] [ -s shell
] [ -l new-login ] login
admuser -o delete [ -yr ] login ...
admuser -o list [ -yqvra ] [ -u uid ] [ -g gid ] [ login ... ]
admuser -o get [ -qv ]
admuser -o set [ -g gid ] [ -b base-directory ] [ -s shell ] [ -k
skeleton-directory ] [ -S home-directory-size ]
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 make home-directory option is specified together with
the -d new home-directory option then an attempt is made to
copy the files in the old home-directory owned by this user
to the new home-directory. 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.
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
unless the home directory is considered a system directory
Licensed material--property of copyright holder(s) 1
admuser(1M) DG/UX 5.4R3.00 admuser(1M)
(directories such as / /usr /usr/bin* /usr/lib/*.
Administrators must manually delete any system directories
used as home directories.
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. Any user
may execute this operation.
get This operation will obtain and list the default gid, base-
directory, shell, and skeleton-directory that will be used
when adding a new login with the add operation. Any user
may execute this operation.
set This operation will set the default gid, base-directory,
shell, skeleton-directory, and home-directory-size 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 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.
-d home-directory
Specifies the home directory of the new user. The default
home directory is base-directory/login.
-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
Licensed material--property of copyright holder(s) 2
admuser(1M) DG/UX 5.4R3.00 admuser(1M)
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.
-m If used with -d home-directory while adding a new user, it
specifies that the system is to attempt to make the home-
directory for login. The contents of the skeleton-
directory are copied to the newly created home-directory.
The new directory has ownership, uid, and group, gid,
read/write/execute permissions.
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. CAUTION: 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.
-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.
-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 Tells the delete operation to remove the user's home
directory from the system, if possible. The files and
directories under the home directory will no longer be
accessible following successful execution of the command.
-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.
-k skeleton-directory
Specifies a directory that contains skeleton information
Licensed material--property of copyright holder(s) 3
admuser(1M) DG/UX 5.4R3.00 admuser(1M)
(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.
-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
Superuser privilege is required for all operations except list.
Licensed material--property of copyright holder(s) 4
admuser(1M) DG/UX 5.4R3.00 admuser(1M)
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 a superuser wishes to modify the password database
directly, he or she 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).
Licensed material--property of copyright holder(s) 5