Commit | Line | Data |
---|---|---|
e1db696c KB |
1 | .\" Copyright (c) 1988 The Regents of the University of California. |
2 | .\" All rights reserved. | |
3 | .\" | |
91cff1e1 | 4 | .\" %sccs.include.redist.man% |
e1db696c | 5 | .\" |
91cff1e1 | 6 | .\" @(#)passwd.5 6.6 (Berkeley) %G% |
a343bbd7 | 7 | .\" |
0b6955e2 | 8 | .TH PASSWD 5 "" |
a343bbd7 KM |
9 | .AT 3 |
10 | .SH NAME | |
e1db696c | 11 | passwd \- password files |
a343bbd7 KM |
12 | .SH DESCRIPTION |
13 | .I Passwd | |
e1db696c KB |
14 | files are files consisting of newline separated records, one per user, |
15 | containing ten colon (``:'') separated fields. These fields are as | |
16 | follows: | |
a343bbd7 | 17 | .PP |
e1db696c KB |
18 | .RS |
19 | name user's login name | |
20 | password user's \fIencrypted\fP password | |
21 | uid user's id | |
22 | gid user's login group id | |
23 | class user's general classification (unused) | |
24 | change password change time | |
25 | expire account expiration time | |
26 | gecos general information about the user | |
27 | home_dir user's home directory | |
28 | shell user's login shell | |
29 | .RE | |
30 | .PP | |
31 | The | |
32 | .I name | |
33 | field is the login used to access the computer account, and the | |
34 | .I uid | |
35 | field is the number associated with it. They should both be unique | |
36 | across the system (and often across a group of systems) since they | |
37 | control file access. | |
38 | .PP | |
39 | While it is possible to have multiple entries with identical login names | |
40 | and/or identical user id's, it is usually a mistake to do so. Routines | |
41 | that manipulate these files will often return only one of the multiple | |
42 | entries, and that one by random selection. | |
43 | .PP | |
0982b854 KB |
44 | The login name must never begin with a hyphen (``-''); also, it is strongly |
45 | suggested that neither upper-case characters or dots (``.'') be part | |
46 | of the name, as this tends to confuse mailers. No field may contain a | |
47 | colon (``:'') as this has been used historically to separate the fields | |
48 | in the user database. | |
49 | .PP | |
e1db696c KB |
50 | The password field is the |
51 | .I encrypted | |
52 | form of the password. | |
53 | If the | |
54 | .I password | |
55 | field is empty, no password will be required to gain access to the | |
56 | machine. This is almost invariably a mistake. | |
57 | Because these files contain the encrypted user passwords, they should | |
58 | not be readable by anyone without appropriate privileges. | |
59 | .PP | |
60 | The group field is the group that the user will be placed in upon login. | |
61 | Since this system supports multiple groups (see | |
62 | .IR groups (1)) | |
63 | this field currently has little special meaning. | |
a343bbd7 | 64 | .PP |
e1db696c KB |
65 | The |
66 | .I class | |
67 | field is currently unused. In the near future it will be a key to | |
68 | a | |
69 | .IR termcap (5) | |
70 | style database of user attributes. | |
71 | .PP | |
72 | The | |
73 | .I change | |
74 | field is the number in seconds, GMT, from the epoch, until the | |
75 | password for the account must be changed. | |
fbceae23 | 76 | This field may be left empty to turn off the password aging feature. |
e1db696c KB |
77 | .PP |
78 | The | |
79 | .I expire | |
80 | field is the number in seconds, GMT, from the epoch, until the | |
81 | account expires. | |
fbceae23 | 82 | This field may be left empty to turn off the account aging feature. |
e1db696c KB |
83 | .PP |
84 | The | |
85 | .I gecos | |
86 | field normally contains comma (``,'') separated subfields as follows: | |
87 | .PP | |
88 | .RS | |
89 | name user's full name | |
90 | office user's office number | |
91 | wphone user's work phone number | |
92 | hphone user's home phone number | |
93 | .RE | |
94 | .PP | |
95 | This information is used by the | |
96 | .IR finger (1) | |
97 | program. | |
a343bbd7 | 98 | .PP |
e1db696c KB |
99 | The user's home directory is the full UNIX path name where the user |
100 | will be placed on login. | |
a343bbd7 | 101 | .PP |
e1db696c KB |
102 | The shell field is the command interpreter the user prefers. |
103 | If the | |
104 | .I shell | |
105 | field is empty, the Bourne shell (\fI/bin/sh\fP) is assumed. | |
a343bbd7 | 106 | .SH "SEE ALSO" |
e1db696c | 107 | chpass(1), login(1), passwd(1), getpwent(3), mkpasswd(8), vipw(8) adduser(8) |
a343bbd7 | 108 | .SH BUGS |
e1db696c | 109 | User information should (and eventually will) be stored elsewhere. |