← Back to branch summary

~ubuntu-branches/ubuntu/raring/shadow/raring-proposed

« back to all changes in this revision

Viewing changes to man/pl/shadow.3

  • 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:
man/pl/shadow.3
1
1
.\"     Title: shadow
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: Library Calls
6
6
.\"    Source: Library Calls
7
7
.\"
8
 
.TH "SHADOW" "3" "04/03/2008" "Library Calls" "Library Calls"
 
8
.TH "SHADOW" "3" "04/15/2009" "Library Calls" "Library Calls"
9
9
.\" disable hyphenation
10
10
.nh
11
11
.\" disable justification (adjust text to left margin only)
15
15
.SH "SKŁADNIA"
16
16
.PP
17
17
 
18
 
\fI#include <shadow\.h>\fR
 
18
\fI#include <shadow\&.h>\fR
19
19
.PP
20
20
 
21
21
\fIstruct spwd *getspent();\fR
54
54
 
55
55
\fIshadow\fR
56
56
manipulates the contents of the shadow password file,
57
 
\fI/etc/shadow\fR\. The structure in the
 
57
\fI/etc/shadow\fR\&. The structure in the
58
58
\fI#include\fR
59
59
file is:
60
60
.sp
64
64
      char              *sp_namp; /* user login name */
65
65
      char              *sp_pwdp; /* encrypted password */
66
66
      long int          sp_lstchg; /* last password change */
67
 
      long int          sp_min; /* days until change allowed\. */
 
67
      long int          sp_min; /* days until change allowed\&. */
68
68
      long int          sp_max; /* days before change required */
69
69
      long int          sp_warn; /* days warning for expiration */
70
70
      long int          sp_inact; /* days before account inactive */
120
120
\fIfgetspent\fR, and
121
121
\fIsgetspent\fR
122
122
each return a pointer to a
123
 
\fIstruct spwd\fR\.
 
123
\fIstruct spwd\fR\&.
124
124
\fIgetspent\fR
125
125
returns the next entry from the file, and
126
126
\fIfgetspent\fR
127
 
returns the next entry from the given stream, which is assumed to be a file of the proper format\.
 
127
returns the next entry from the given stream, which is assumed to be a file of the proper format\&.
128
128
\fIsgetspent\fR
129
129
returns a pointer to a
130
130
\fIstruct spwd\fR
131
 
using the provided string as input\.
 
131
using the provided string as input\&.
132
132
\fIgetspnam\fR
133
133
searches from the current position in the file for an entry matching
134
 
\fIname\fR\.
 
134
\fIname\fR\&.
135
135
.PP
136
136
 
137
137
\fIsetspent\fR
138
138
and
139
139
\fIendspent\fR
140
 
may be used to begin and end, respectively, access to the shadow password file\.
 
140
may be used to begin and end, respectively, access to the shadow password file\&.
141
141
.PP
142
142
The
143
143
\fIlckpwdf\fR
145
145
\fIulckpwdf\fR
146
146
routines should be used to insure exclusive access to the
147
147
\fI/etc/shadow\fR
148
 
file\.
 
148
file\&.
149
149
\fIlckpwdf\fR
150
150
attempts to acquire a lock using
151
151
\fIpw_lock\fR
152
 
for up to 15 seconds\. It continues by attempting to acquire a second lock using
 
152
for up to 15 seconds\&. It continues by attempting to acquire a second lock using
153
153
\fIspw_lock\fR
154
 
for the remainder of the initial 15 seconds\. Should either attempt fail after a total of 15 seconds,
 
154
for the remainder of the initial 15 seconds\&. Should either attempt fail after a total of 15 seconds,
155
155
\fIlckpwdf\fR
156
 
returns \-1\. When both locks are acquired 0 is returned\.
 
156
returns \-1\&. When both locks are acquired 0 is returned\&.
157
157
.SH "DIAGNOSTYKA"
158
158
.PP
159
 
Routines return NULL if no more entries are available or if an error occurs during processing\. Routines which have
 
159
Routines return NULL if no more entries are available or if an error occurs during processing\&. Routines which have
160
160
\fIint\fR
161
 
as the return value return 0 for success and \-1 for failure\.
 
161
as the return value return 0 for success and \-1 for failure\&.
162
162
.SH "OSTRZEŻENIA"
163
163
.PP
164
 
These routines may only be used by the superuser as access to the shadow password file is restricted\.
 
164
These routines may only be used by the superuser as access to the shadow password file is restricted\&.
165
165
.SH "PLIKI"
166
166
.PP
167
167
\fI/etc/shadow\fR
168
168
.RS 4
169
 
Informacje chronione o użytkownikach\.
 
169
Informacje chronione o użytkownikach\&.
170
170
.RE
171
171
.SH "ZOBACZ TAKŻE"
172
172
.PP
173
173
\fBgetpwent\fR(3),
174
 
\fBshadow\fR(5)\.
 
174
\fBshadow\fR(5)\&.