NAME

passwd − password file description with the Yellow Pages service implemented. 

DESCRIPTION

The passwd file stores initial login information, including passwords for each user in the system. Regardless of whether or not the system has the Yellow Pages service implemented, the passwd file contains the following information:

name (login name, contains no upper case)

encrypted password

numerical user ID

numerical group ID

user’s real name, office, extension, home phone. 

initial working directory

program to use as Shell

The name may contain ‘&’, meaning insert the login name.  This information is set by the chfn(1) command and used by the finger(1) command. 

This is an ASCII file.  Each field within each user’s entry is separated from the next by a colon.  Each user is separated from the next by a new-line.  If the password field is null, no password is demanded; if the shell field is null, the system defaults to the /bin/sh shell. 

This file resides in the /etc directory.  Because of the encrypted passwords, it can and does have general read permission and can be used, for example, to map numerical user ID’s to names. 

Appropriate precautions mst be taken to lock the /etc/passwd file against simultaneous changes if it is to be edited with a text editor; vipw(8) does the necessary locking. 

In a Yellow Pages environment, the passwd file can also have a line beginning with a plus (+), which means to incorporate entries from the yellow pages data base. There are three styles of + entries: by itself, + means to insert the entire contents of the yellow pages password file at that point; +name means to insert the entry (if any) for name from the yellow pages at that point; +@name means to insert the entries for all members of the network group name at that point.  If a + entry has a non-null password, directory, gecos, or shell field, they will overide what is contained in the yellow pages.  The numerical user ID and group ID fields cannot be overridden. 

EXAMPLE

Here is a sample /etc/passwd file:

root:q.mJzTnu8icF.:0:10:God:/:/bin/csh
jcj:6k/7KCFRPNVXg:508:10:JC Javert:/usr2/jcj:/bin/csh
+john:
+@documentation:no-login:
+:::Guest

In this example, there are specific entries for users root and jcj, in case the yellow pages are temporarily out of service.  Alternatively, a user may need specific login information on a given system that differs from the information contained in the yellow pages map for that user.  The user, john will have his password entry in the yellow pages incorporated without change; anyone in the netgroup documentation will have their password field disabled, and anyone else will be able to log in with their usual password, shell, and home directory, but with a gecos field of Guest. 

FILES

/etc/passwd

SEE ALSO

chfn(1), finger(1), login(1), passwd(1), crypt(3), getpwent(3), group(5), adduser(8), vipw(8)