yppassmgmt(8) CLIX yppassmgmt(8)
NAME
yppassmgmt - Provides password file management for Network Information
Service (NIS)
SYNOPSIS
yppassmgmt -a flags name
yppassmgmt -m flags name
yppassmgmt -d name
FLAGS
-a name Adds an entry for user name to the network password file. This
command does not create a directory for the new user and the new
login does not have a password (with a null string in the passwd
field) until the yppasswd command is executed to set the
password.
-m name Modifies the entry for user name in the network password file.
All the fields (except the password field) in the /etc/passwd.yp
entry can be modified by this command. Only fields entered on
the command line are modified.
-d name Deletes from the network password file the entry for user name.
It does not remove any files that the user owns on the system;
they must be removed manually.
flags The following flags are available:
-c comment Provides a short description of the login. It is
limited to a maximum of 128 characters and defaults
to an empty field.
-h homedir Specifies the home directory of name. It is
limited to a maximum of 256 characters and defaults
to /usr/name.
-u uid Specifies the UID of name. This number must range
from 0 to the maximum value for the system. The
UID defaults to the next available UID greater than
100. Without the -o flag, it enforces the
uniqueness of a UID.
-o Allows a UID to be nonunique. This flag is used
only with the -u flag.
-g gid Specifies the GID of name. This number must range
from 0 to the maximum value for the system. By
2/94 - Intergraph Corporation 1
yppassmgmt(8) CLIX yppassmgmt(8)
default, the GID is 1.
-s shell Specifies the login shell for name. The shell
parameter is the full pathname of the program
executed when the user logs in. The maximum length
of shell is 256 characters. If this flag is not
specified, the /bin/sh shell is used by default.
-l logname Changes the name to logname for the -m flag only.
DESCRIPTION
The yppassmgmt command updates information in the network password file.
This command works with /etc/passwd.yp.
The total size of each login entry, whether existing or new, is limited to
a maximum of 511 bytes in the password file.
After /etc/passwd.yp is updated, ypmake is executed to update the
appropriate NIS maps and the /etc/passwd file.
EXAMPLES
1. To add user smith to the password file, specifying a home directory,
user ID, group ID, and shell, enter:
yppassmgmt -a -h /usr2/smith -u 100 -g 3 -s /bin/ksh smith
2. To modify the entry for user juan, changing the home directory, enter:
yppassmgmt -m -h /usr2/juan juan
3. To delete the entry for user chang, enter:
yppassmgmt -d chang
FILES
/etc/passwd
Database of login and password information.
/etc/passwd.yp
NIS server database of password entries from which the NIS password
map is initialized.
NOTES
You cannot use a colon (:) or press <Return> within any name or field
2 Intergraph Corporation - 2/94
yppassmgmt(8) CLIX yppassmgmt(8)
because these are interpreted as field separators.
DIAGNOSTICS
yppassmgmt: Permission denied
You must be superuser to execute the yppassmgmt command.
yppassmgmt: New password entry too long
The newly created login entry is greater than 511 bytes long. The
password database is not changed.
yppassmgmt: Password file(s) busy. Try again later
Another process is currently modifying the network password file.
yppassmgmt: Logname already exists
An entry already exists in the database for the username you are
attempting to add.
yppassmgmt: Name does not exist
The entry you are attempting to modify does not exist.
EXIT VALUES
The yppassmgmt command exits with one of the following values:
0 SUCCESS.
1 Permission denied.
2 Invalid command syntax. Usage message of the yppassmgmt command is
displayed.
3 Invalid argument provided to flag.
4 UID in use.
5 Inconsistent password file.
6 Unexpected failure. Password files unchanged.
7 Unexpected failure. Password file(s) missing.
8 Password file(s) busy. Try again later.
9 The name specified does not exist (if -m or -d is specified) or
already exists (if -a is specified), or logname already exists (if -m
-l is specified).
RELATED INFORMATION
Commands: yppasswd(1), yppasswdd(8)
2/94 - Intergraph Corporation 3
yppassmgmt(8) CLIX yppassmgmt(8)
Files: passwd(4)
4 Intergraph Corporation - 2/94