yppassmgt(NADM) 19 June 1992 yppassmgt(NADM) Name yppassmgmt - password file management for SCO network information service Syntax yppassmgmt -a options name yppassmgmt -m options name yppassmgmt -d name yppassmgmt -f name yppassmgmt -r name yppassmgmt -n name Description The yppassmgmt command updates information in the network password file. This command works with /etc/passwd.yp. yppassmgmt -a adds an entry for user name to the network password file. This command does not create any 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(NC) command is executed to set the password. yppassmgmt -m 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 com- mand line will be modified. yppassmgmt -d locks the entry for user name from the network password file. It will not remove any files that the user owns on the system; they must be removed manually. yppassmgmt -f unlocks the entry for user name from the network password file. It will not remove any files that the user owns on the system; they must be removed manually. yppassmgmt -r retires the entry for user name from the network password file. It will not remove any files that the user owns on the system; they must be removed manually. yppassmgmt -n alters the status for local user name from the a local user to a networked user. name, the login name of the user, must be unique. The following options are available: -c comment a short description of the login. It is limited to a maximum of 128 characters and defaults to an empty field. -h homedir home directory of name. It is limited to a maximum of 256 characters and defaults to /usr/name. -u uid UID of the name. This number must range from 0 to the max- imum value for the system. It defaults to the next available UID greater than 100. Without the -o option, it enforces the uniqueness of a UID. -o This option allows a UID to be non-unique. It is used only with the -u option. -g gid GID of the name. This number must range from 0 to the max- imum value for the system. The default is 1. -s shell login shell for name. It should be the full pathname of the program that will be executed when the user logs in. The maximum length of shell is 256 characters. The default is for this field to be empty and to be interpreted as /bin/sh. -l logname This option changes the name to logname for the -m option only. 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 has been updated, a ypmake(NADM) is done to update the appropriate network information service maps and the /etc/passwd file. Files /etc/passwd /etc/passwd.yp /etc/opasswd See also yppasswd(NC), yppasswdd(NADM), ypmake(NADM), passwd(C) Diagnostics The yppassmgmt command exits with one of the following values: 0 SUCCESS. 1 permission denied 2 invalid command syntax. Usage message of the yppassmgmt com- mand will be displayed. 3 invalid argument provided to option 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 name does not exist (if -m, -d, -f, or -r is specified); already exists (if -a is specified); or logname already exists (if -m -l is specified). _________________________________________________________________________ NOTE You cannot use a colon or <Return> because it will be inter- preted as a field separator. _________________________________________________________________________