← Back to branch summary

~serge-hallyn/ubuntu/raring/shadow/shadow-userns

« back to all changes in this revision

Viewing changes to man/de/man3/shadow.3

  • Committer: Package Import Robot
  • Author(s): Colin Watson
  • Date: 2012-11-29 15:27:11 UTC
  • mfrom: (1.1.10) (49.1.2 raring-proposed)
  • Revision ID: package-import@ubuntu.com-20121129152711-yt26ue2rvo3lqy72
Tags: 1:4.1.5.1-1ubuntu2
Revert build-dependency from gettext:any to gettext, now that gettext is
Multi-Arch: foreign.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/de/man3/shadow.3
 
1
'\" t
 
2
.\"     Title: shadow
 
3
.\"    Author: Julianne Frances Haugh
 
4
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
 
5
.\"      Date: 25.05.2012
 
6
.\"    Manual: Bibliotheksaufrufe
 
7
.\"    Source: shadow-utils 4.1.5.1
 
8
.\"  Language: German
 
9
.\"
 
10
.TH "SHADOW" "3" "25.05.2012" "shadow\-utils 4\&.1\&.5\&.1" "Bibliotheksaufrufe"
 
11
.\" -----------------------------------------------------------------
 
12
.\" * Define some portability stuff
 
13
.\" -----------------------------------------------------------------
 
14
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
15
.\" http://bugs.debian.org/507673
 
16
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
 
17
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
18
.ie \n(.g .ds Aq \(aq
 
19
.el       .ds Aq '
 
20
.\" -----------------------------------------------------------------
 
21
.\" * set default formatting
 
22
.\" -----------------------------------------------------------------
 
23
.\" disable hyphenation
 
24
.nh
 
25
.\" disable justification (adjust text to left margin only)
 
26
.ad l
 
27
.\" -----------------------------------------------------------------
 
28
.\" * MAIN CONTENT STARTS HERE *
 
29
.\" -----------------------------------------------------------------
 
30
.SH "NAME"
 
31
shadow, getspnam \- Routinen f\(:ur die Datei, die die verschl\(:usselten Passw\(:orter enth\(:alt
 
32
.SH "SYNTAX"
 
33
.PP
 
34
 
 
35
\fI#include <shadow\&.h>\fR
 
36
.PP
 
37
 
 
38
\fIstruct spwd *getspent();\fR
 
39
.PP
 
40
 
 
41
\fItruct spwd *getspnam(char\fR
 
42
\fI*name\fR\fI);\fR
 
43
.PP
 
44
 
 
45
\fIvoid setspent();\fR
 
46
.PP
 
47
 
 
48
\fIvoid endspent();\fR
 
49
.PP
 
50
 
 
51
\fIstruct spwd *fgetspent(FILE\fR
 
52
\fI*fp\fR\fI);\fR
 
53
.PP
 
54
 
 
55
\fIstruct spwd *sgetspent(char\fR
 
56
\fI*cp\fR\fI);\fR
 
57
.PP
 
58
 
 
59
\fIint putspent(struct spwd\fR
 
60
\fI*p,\fR
 
61
\fIDATEIEN\fR
 
62
\fI*fp\fR\fI);\fR
 
63
.PP
 
64
 
 
65
\fIint lckpwdf();\fR
 
66
.PP
 
67
 
 
68
\fIint ulckpwdf();\fR
 
69
.SH "BESCHREIBUNG"
 
70
.PP
 
71
\fIshadow\fR
 
72
ver\(:andert den Inhalt der Shadow\-Passwort\-Datei
 
73
/etc/shadow\&. Der Aufbau der Datei
 
74
\fI#include\fR
 
75
ist:
 
76
.sp
 
77
.if n \{\
 
78
.RS 4
 
79
.\}
 
80
.nf
 
81
struct spwd {
 
82
      char  *sp_namp; /* Anmeldename des Benutzers */
 
83
      char  *sp_pwdp; /* verschl\(:usseltes Passwort */
 
84
      long int  sp_lstchg; /* letzte \(:Anderung des Passworts */
 
85
      long int  sp_min; /* Tage, ehe \(:Anderung erlaubt ist */
 
86
      long int  sp_max; /* Tage, bis \(:Anderung erfolgen muss */
 
87
      long int  sp_warn; /* Tage f\(:ur Warnung vor Verfall */
 
88
      long int  sp_inact; /* Tage, ehe Konto inaktiv wird */
 
89
      long int  sp_expire; /* Datum, an dem Konto abgeschaltet wird */
 
90
      unsigned long int  sp_flag; /* reserviert f\(:ur zuk\(:unftigen Gebrauch*/
 
91
}
 
92
    
 
93
.fi
 
94
.if n \{\
 
95
.RE
 
96
.\}
 
97
.PP
 
98
Die Bedeutung dieser Felder ist:
 
99
.sp
 
100
.RS 4
 
101
.ie n \{\
 
102
\h'-04'\(bu\h'+03'\c
 
103
.\}
 
104
.el \{\
 
105
.sp -1
 
106
.IP \(bu 2.3
 
107
.\}
 
108
sp_namp \- Verweis auf Benutzername, der mit einer Null endet
 
109
.RE
 
110
.sp
 
111
.RS 4
 
112
.ie n \{\
 
113
\h'-04'\(bu\h'+03'\c
 
114
.\}
 
115
.el \{\
 
116
.sp -1
 
117
.IP \(bu 2.3
 
118
.\}
 
119
sp_pwdp \- Verweis auf Passwort, das mit einer Null endet
 
120
.RE
 
121
.sp
 
122
.RS 4
 
123
.ie n \{\
 
124
\h'-04'\(bu\h'+03'\c
 
125
.\}
 
126
.el \{\
 
127
.sp -1
 
128
.IP \(bu 2.3
 
129
.\}
 
130
sp_lstchg \- Anzahl der Tage gerechnet ab dem 1\&. Januar 1970, seitdem das Passwort das letzte Mal ge\(:andert wurde
 
131
.RE
 
132
.sp
 
133
.RS 4
 
134
.ie n \{\
 
135
\h'-04'\(bu\h'+03'\c
 
136
.\}
 
137
.el \{\
 
138
.sp -1
 
139
.IP \(bu 2.3
 
140
.\}
 
141
sp_min \- Anzahl der Tage, ehe das Passwort nicht ge\(:andert werden darf
 
142
.RE
 
143
.sp
 
144
.RS 4
 
145
.ie n \{\
 
146
\h'-04'\(bu\h'+03'\c
 
147
.\}
 
148
.el \{\
 
149
.sp -1
 
150
.IP \(bu 2.3
 
151
.\}
 
152
sp_max \- Anzahl der Tage, nach denen das Passwort ge\(:andert werden muss
 
153
.RE
 
154
.sp
 
155
.RS 4
 
156
.ie n \{\
 
157
\h'-04'\(bu\h'+03'\c
 
158
.\}
 
159
.el \{\
 
160
.sp -1
 
161
.IP \(bu 2.3
 
162
.\}
 
163
sp_warn \- Anzahl der Tage ehe das Passwort verf\(:allt, an denen der Benutzer vor dem Verfall gewarnt wird
 
164
.RE
 
165
.sp
 
166
.RS 4
 
167
.ie n \{\
 
168
\h'-04'\(bu\h'+03'\c
 
169
.\}
 
170
.el \{\
 
171
.sp -1
 
172
.IP \(bu 2.3
 
173
.\}
 
174
sp_inact \- Anzahl der Tage nach dem Verfall des Passworts, nach denen das Konto als inaktiv angesehen und abgeschaltet wird
 
175
.RE
 
176
.sp
 
177
.RS 4
 
178
.ie n \{\
 
179
\h'-04'\(bu\h'+03'\c
 
180
.\}
 
181
.el \{\
 
182
.sp -1
 
183
.IP \(bu 2.3
 
184
.\}
 
185
sp_expire \- Anzahl Tage gerechnet ab dem 1\&. Januar 1970, f\(:ur die das Konto abgeschaltet ist
 
186
.RE
 
187
.sp
 
188
.RS 4
 
189
.ie n \{\
 
190
\h'-04'\(bu\h'+03'\c
 
191
.\}
 
192
.el \{\
 
193
.sp -1
 
194
.IP \(bu 2.3
 
195
.\}
 
196
sp_flag \- f\(:ur zuk\(:unftigen Gebrauch reserviert
 
197
.RE
 
198
.SH "BESCHREIBUNG"
 
199
.PP
 
200
\fIgetspent\fR,
 
201
\fIgetspname\fR,
 
202
\fIfgetspent\fR
 
203
und
 
204
\fIsgetspent\fR
 
205
geben einen Verweis auf
 
206
\fIstruct spwd\fR
 
207
zur\(:uck\&.
 
208
\fIgetspent\fR
 
209
gibt den n\(:achsten Eintrag der Datei zur\(:uck\&.
 
210
\fIfgetspent\fR
 
211
gibt den n\(:achsten Eintrag im angegebenen Datenstrom zur\(:uck, f\(:ur den angenommen wird, dass es sich dabei um eine Datei im zul\(:assigen Format handelt\&.
 
212
\fIsgetspent\fR
 
213
gibt einen Verweis auf einen
 
214
\fIstruct spwd\fR
 
215
zur\(:uck, wobei die angegebene Zeichenkette als Eingabe verwendet wird\&.
 
216
\fIgetspnam\fR
 
217
sucht ab der aktuellen Position in der Datei nach einem Eintrag, der mit
 
218
\fIname\fR
 
219
\(:ubereinstimmt\&.
 
220
.PP
 
221
\fIsetspent\fR
 
222
und
 
223
\fIendspent\fR
 
224
k\(:onnen verwendet werden, um den Zugriff auf die Shadow\-Passwort\-Datei zu beginnen oder zu beenden\&.
 
225
.PP
 
226
Die Routinen
 
227
\fIlckpwdf\fR
 
228
und
 
229
\fIulckpwdf\fR
 
230
sollten eingesetzt werden, da so sichergestellt werden kann, dass exlusiv auf die Datei
 
231
/etc/shadow
 
232
zugegriffen wird\&.
 
233
\fIlckpwdf\fR
 
234
versucht, eine Sperre durch
 
235
\fIpw_lock\fR
 
236
f\(:ur bis zu 15 Sekunden zu erhalten\&. Dann versucht es, eine zweite Sperre durch
 
237
\fIspw_lock\fR
 
238
f\(:ur den Rest der 15 Sekunden zu erhalten\&. Sollte einer der beiden Versuche nach insgesamt 15 Sekunden scheitern, gibt
 
239
\fIlckpwdf\fR
 
240
\-1 zur\(:uck\&. Wurden beide Sperren erhalten, wird 0 zur\(:uckgegeben\&.
 
241
.SH "DIAGNOSE"
 
242
.PP
 
243
Wenn kein weiterer Eintrag vorhanden ist oder w\(:ahrend der Verarbeitung ein Fehler auftritt, geben die Routinen NULL zur\(:uck\&. Routinen, die
 
244
\fIint\fR
 
245
als R\(:uckgabewert haben, geben im Erfolgsfall 0 und beim Scheitern \-1 zur\(:uck\&.
 
246
.SH "WARNUNGEN"
 
247
.PP
 
248
Diese Routinen k\(:onnen nur von Root verwendet werden, da der Zugriff auf die Shadow\-Passwort\-Datei beschr\(:ankt ist\&.
 
249
.SH "DATEIEN"
 
250
.PP
 
251
/etc/shadow
 
252
.RS 4
 
253
verschl\(:usselte Informationen zu den Benutzerkonten
 
254
.RE
 
255
.SH "SIEHE AUCH"
 
256
.PP
 
257
\fBgetpwent\fR(3),
 
258
\fBshadow\fR(5)\&.