projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| dcf80e4c | 1 | .\" @(#)passwd.5 6.2 (Berkeley) %G% |
| a343bbd7 | 2 | .\" |
| 0b6955e2 | 3 | .TH PASSWD 5 "" |
| a343bbd7 KM |
4 | .AT 3 |
| 5 | .SH NAME | |
| 6 | passwd \- password file | |
| 7 | .SH DESCRIPTION | |
| 8 | .I Passwd | |
| 9 | contains for each user the | |
| 10 | following information: | |
| 11 | .HP 10 | |
| 12 | name (login name, contains no upper case) | |
| 13 | .br | |
| 14 | .ns | |
| 15 | .HP 10 | |
| 16 | encrypted password | |
| 17 | .br | |
| 18 | .ns | |
| 19 | .HP 10 | |
| 20 | numerical user ID | |
| 21 | .br | |
| 22 | .ns | |
| 23 | .HP 10 | |
| 24 | numerical group ID | |
| 25 | .br | |
| 26 | .ns | |
| 27 | .HP 10 | |
| 28 | user's real name, office, extension, home phone. | |
| 29 | .br | |
| 30 | .ns | |
| 31 | .HP 10 | |
| 32 | initial working directory | |
| 33 | .br | |
| 34 | .ns | |
| 35 | .HP 10 | |
| 36 | program to use as Shell | |
| 37 | .PP | |
| 38 | The name may contain `&', meaning insert the login name. | |
| 39 | This information is set by the | |
| 40 | .IR chfn (1) | |
| 41 | command and used by the | |
| 42 | .IR finger (1) | |
| 43 | command. | |
| 44 | .PP | |
| 45 | This is an ASCII file. Each field within each user's entry | |
| 46 | is separated from the next by a colon. | |
| 47 | Each user is separated from the next by a new-line. | |
| 48 | If the password field is null, no password is demanded; | |
| 49 | if the Shell field is null, then | |
| 50 | .I /bin/sh | |
| 51 | is used. | |
| 52 | .PP | |
| 53 | This file resides in directory /etc. | |
| 54 | Because of the encrypted | |
| 55 | passwords, it can and does have general read | |
| 56 | permission and can be used, for example, | |
| 57 | to map numerical user ID's to names. | |
| 58 | .PP | |
| 59 | Appropriate precautions must be taken to lock the file against changes | |
| 60 | if it is to be edited with a text editor; | |
| 61 | .IR vipw (8) | |
| 62 | does the necessary locking. | |
| 63 | .SH FILES | |
| 64 | /etc/passwd | |
| 65 | .SH "SEE ALSO" | |
| 66 | getpwent(3), login(1), crypt(3), passwd(1), group(5), chfn(1), finger(1), | |
| 67 | vipw(8), adduser(8) | |
| 68 | .SH BUGS | |
| a343bbd7 | 69 | User information (name, office, etc.) should be stored elsewhere. |