admuser(1M) DG/UX 5.4.2 admuser(1M)
NAME
admuser - manage user information in the password database
SYNOPSIS
admuser -o add [ -yp ] [ -u uid ] [ -g gid ] [ -d home-directory ] [
-m ] [ -c comment ] [ -s shell ] login
admuser -o modify [ -yp ] [ -u uid ] [ -g gid ] [ -d home-directory ]
[ -m ] [ -c comment ] [ -s shell ] [ -l new-login ] login
admuser -o delete [ -yr ] login ...
admuser -o list [ -yqva ] [ -u uid ] [ -g gid ] [ login ... ]
admuser -o get [ -qv ]
admuser -o set [ -g gid ] [ -b base-directory ] [ -s shell ] [ -k
skeleton-directory ]
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. Only the superuser may execute this operation.
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 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. Only the superuser
may execute this operation.
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.
Only the superuser may execute this operation.
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.
Licensed material--property of copyright holder(s) 1
admuser(1M) DG/UX 5.4.2 admuser(1M)
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, and skeleton-directory to be used when adding a new
login with the add operation. Only the superuser may
execute this 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.
-m 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.
-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.
Licensed material--property of copyright holder(s) 2
admuser(1M) DG/UX 5.4.2 admuser(1M)
-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
(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.
Licensed material--property of copyright holder(s) 3
admuser(1M) DG/UX 5.4.2 admuser(1M)
- 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
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
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) 4