yppasswd Command

AIX Version 4.3 Commands Reference, Volume 6

yppasswd Command

Purpose

Changes your network password in Network Information Service (NIS).

Syntax

yppasswd [ -f [ Name ] | -s [ Name [ ShellProg ]] ]

Description

The yppasswd command changes (or installs) a network password and associates it with the name you specify in the UserName parameter. To create or change a password, you must be the owner of the password you want to change. The Network Service Information Service (NIS) password can be different from the one on your own machine. Root users on an NIS server can change the password of another user without knowing the user's original password. Root users on an NIS client, however, do not have this privilege.

When you enter the yppasswd command on the command line, the system prompts you to enter the old password. Once you do this, the system prompts you to enter the new password. The password you enter can be as small as four characters long if you use a mixture of uppercase and lowercase characters. Otherwise, the password has to be six characters long or longer. These rules are relaxed if you are insistent enough.

If you should enter the old password incorrectly, you have to enter the new password before the system will give you an error message. The system requires both passwords because the update protocol sends them to the server at the same time. The server catches the error and notifies you that you entered the old password incorrectly.

To verify the new password, the system prompts you to enter it again. For this new password to take effect, the yppasswdd daemon must be running on your NIS server.

Note: The yppasswd command cannot establish rules for passwords as does the passwd command.

Flags

-f [ Name ]	Changes user Name's gecos information in the NIS maps. Gecos information is general information stored in the /etc/passwd file.
-s [ Name [ ShellProg ]]	Changes user Name's login shell in the NIS maps.

Example

To change a user's NIS password, enter:
```
yppasswd Joe
```
This example demonstrates how to change the NIS password for the user named Joe. The system prompts you to enter Joe's old password and then his new password.
To change the login shell to /bin/ksh for the user named Joe, if the yppasswdd daemon has not been started with the -noshell flag, enter:
```
yppasswd -s Joe /bin/ksh
```
To change the gecos information in the passwd file for the user named Joe, if the yppasswdd daemon has not been started with the -nogecos flag, enter:
```
yppasswd -f Joe
Old NIS password:
Joe's current gecos:
John Doe Test User Id
Change (yes) or (no)? >y
To?>Joe User Test User Id
```

Related Information

The yppasswdd daemon.

Network Information Service (NIS) Overview for System Management and Network File System (NFS) Overview for System Management in AIX Version 4.3 System Management Guide: Communications and Networks.

List of NIS Commands.