~xnox/ubuntu/quantal/shadow/clear-locks

« back to all changes in this revision

Viewing changes to man/passwd.5

  • Committer: Bazaar Package Importer
  • Author(s): Kees Cook
  • Date: 2009-05-05 09:45:21 UTC
  • mfrom: (1.1.6 upstream)
  • Revision ID: james.westby@ubuntu.com-20090505094521-wpk2wn3q7957tlah
Tags: 1:4.1.3.1-1ubuntu1
* Merge from debian unstable, remaining changes:
  - Ubuntu specific:
    + debian/login.defs: use SHA512 by default for password crypt routine.
  - debian/patches/stdout-encrypted-password.patch: chpasswd can report
    password hashes on stdout (debian bug 505640).
  - debian/login.pam: Enable SELinux support (debian bug 527106).
  - debian/securetty.linux: support Freescale MX-series (debian bug 527095).
* Add debian/patches/300_lastlog_failure: fixed upstream (debian bug 524873).
* Drop debian/patches/593_omit_lastchange_field_if_clock_is_misset: fixed
  upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\"     Title: passwd
2
2
.\"    Author: 
3
3
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
4
 
.\"      Date: 04/03/2008
 
4
.\"      Date: 04/15/2009
5
5
.\"    Manual: File Formats and Conversions
6
6
.\"    Source: File Formats and Conversions
7
7
.\"
8
 
.TH "PASSWD" "5" "04/03/2008" "File Formats and Conversions" "File Formats and Conversions"
 
8
.TH "PASSWD" "5" "04/15/2009" "File Formats and Conversions" "File Formats and Conversions"
9
9
.\" disable hyphenation
10
10
.nh
11
11
.\" disable justification (adjust text to left margin only)
16
16
.PP
17
17
 
18
18
\fI/etc/passwd\fR
19
 
contains one line for each user account, with seven fields delimited by colons (\(lq:\(rq)\. These fields are:
 
19
contains one line for each user account, with seven fields delimited by colons (\(lq:\(rq)\&. These fields are:
20
20
.sp
21
21
.RS 4
22
22
\h'-04'\(bu\h'+03'login name
46
46
\h'-04'\(bu\h'+03'optional user command interpreter
47
47
.RE
48
48
.PP
49
 
The encrypted password field may be blank, in which case no password is required to authenticate as the specified login name\. However, some applications which read the
 
49
The encrypted password field may be blank, in which case no password is required to authenticate as the specified login name\&. However, some applications which read the
50
50
\fI/etc/passwd\fR
51
51
file may decide not to permit
52
52
\fIany\fR
53
53
access at all if the
54
54
\fIpassword\fR
55
 
field is blank\. If the
 
55
field is blank\&. If the
56
56
\fIpassword\fR
57
57
field is a lower\-case
58
58
\(lqx\(rq, then the encrypted password is actually stored in the
61
61
\fImust\fR
62
62
be a corresponding line in the
63
63
\fI/etc/shadow\fR
64
 
file, or else the user account is invalid\. If the
 
64
file, or else the user account is invalid\&. If the
65
65
\fIpassword\fR
66
66
field is any other string, then it will be treated as an encrypted password, as specified by
67
 
\fBcrypt\fR(3)\.
 
67
\fBcrypt\fR(3)\&.
68
68
.PP
69
69
The comment field is used by various system utilities, such as
70
 
\fBfinger\fR(1)\.
 
70
\fBfinger\fR(1)\&.
71
71
.PP
72
 
The home directory field provides the name of the initial working directory\. The
 
72
The home directory field provides the name of the initial working directory\&. The
73
73
\fBlogin\fR
74
74
program uses this information to set the value of the
75
75
\fB$HOME\fR
76
 
environmental variable\.
 
76
environmental variable\&.
77
77
.PP
78
 
The command interpreter field provides the name of the user\'s command language interpreter, or the name of the initial program to execute\. The
 
78
The command interpreter field provides the name of the user\'s command language interpreter, or the name of the initial program to execute\&. The
79
79
\fBlogin\fR
80
80
program uses this information to set the value of the
81
81
\fB$SHELL\fR
82
 
environmental variable\. If this field is empty, it defaults to the value
83
 
\fI/bin/sh\fR\.
 
82
environmental variable\&. If this field is empty, it defaults to the value
 
83
\fI/bin/sh\fR\&.
84
84
.SH "FILES"
85
85
.PP
86
86
\fI/etc/passwd\fR
87
87
.RS 4
88
 
User account information\.
 
88
User account information\&.
89
89
.RE
90
90
.PP
91
91
\fI/etc/shadow\fR
95
95
.SH "SEE ALSO"
96
96
.PP
97
97
 
 
98
\fBcrypt\fR(3),
98
99
\fBgetent\fR(1),
 
100
\fBgetpwnam\fR(3),
99
101
\fBlogin\fR(1),
100
102
\fBpasswd\fR(1),
101
 
\fBsu\fR(1),
102
 
\fBcrypt\fR(3),
103
 
\fBgetpwnam\fR(3),
104
 
\fBshadow\fR(5),
 
103
\fBpwck\fR(8),
105
104
\fBpwconv\fR(8),
106
105
\fBpwunconv\fR(8),
107
 
\fBsulogin\fR(8)\.
 
106
\fBshadow\fR(5),
 
107
\fBsu\fR(1),
 
108
\fBsulogin\fR(8)\&.