man/fr/shadow.3

   1 '\" t
   2 .\"     Title: shadow
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
   5 .\"      Date: 16/02/2011
   6 .\"    Manual: Appels de biblioth\(`eque
   7 .\"    Source: Appels de biblioth\(`eque
   8 .\"  Language: French
   9 .\"
  10 .TH "SHADOW" "3" "16/02/2011" "Appels de biblioth\(`eque" "Appels de biblioth\(`eque"
  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 "NOM"
  31 shadow, getspnam \- routines d\*(Aqutilisation des mots de passe cach\('es
  32 .SH "SYNTAX"
  33 .PP
  34
  35 \fI#include <shadow\&.h>\fR
  36 .PP
  37
  38 \fIstruct spwd *getspent();\fR
  39 .PP
  40
  41 \fIstruct spwd *getspnam(char\fR
  42 \fI*nom\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 \fIFICHIER\fR
  62 \fI*fp\fR\fI);\fR
  63 .PP
  64
  65 \fIint lckpwdf();\fR
  66 .PP
  67
  68 \fIint ulckpwdf();\fR
  69 .SH "DESCRIPTION"
  70 .PP
  71 \fIshadow\fR
  72 manipule le contenu du fichier des mots de passe cach\('es,
  73 /etc/shadow\&. La structure d\('efinie dans le fichier inclus est\ \&:
  74 .sp
  75 .if n \{\
  76 .RS 4
  77 .\}
  78 .nf
  79 struct spwd {
  80       char              *sp_namp; /* nom de connexion de l\*(Aqutilisateur */
  81       char              *sp_pwdp; /* mot de passe chiffr\('e */
  82       long int          sp_lstchg; /* dernier changement de mot de passe */
  83       long int          sp_min; /* jours avant de pouvoir changer de mot de passe */
  84       long int          sp_max; /* jours avant l\*(Aqobligation de changer de mot de passe */
  85       long int          sp_warn; /* jours d\*(Aqavertissement avant la fin de validit\('e */
  86       long int          sp_inact; /* jours avant que le compte soit inactif */
  87       long int          sp_expire; /* date de fin de validit\('e du compte */
  88       unsigned long int sp_flag; /* r\('eserv\('e pour une utilisation future */
  89 }
  90
  91 .fi
  92 .if n \{\
  93 .RE
  94 .\}
  95 .PP
  96 La signification de chaque champ est la suivante\ \&:
  97 .sp
  98 .RS 4
  99 .ie n \{\
 100 \h'-04'\(bu\h'+03'\c
 101 .\}
 102 .el \{\
 103 .sp -1
 104 .IP \(bu 2.3
 105 .\}
 106 sp_namp \- pointeur vers le nom d\*(Aqutilisateur termin\('e par un z\('ero binaire (\(Fo\ \&null\-terminated\ \&\(Fc)
 107 .RE
 108 .sp
 109 .RS 4
 110 .ie n \{\
 111 \h'-04'\(bu\h'+03'\c
 112 .\}
 113 .el \{\
 114 .sp -1
 115 .IP \(bu 2.3
 116 .\}
 117 sp_pwdp \- pointeur vers le mot de passe termin\('e par un z\('ero binaire ( \(Fo\ \&null\-terminated\ \&\(Fc)
 118 .RE
 119 .sp
 120 .RS 4
 121 .ie n \{\
 122 \h'-04'\(bu\h'+03'\c
 123 .\}
 124 .el \{\
 125 .sp -1
 126 .IP \(bu 2.3
 127 .\}
 128 sp_lstchg \- nombre de jours, compt\('es \(`a partir du 1er janvier 1970, depuis la derni\(`ere modification du mot de passe
 129 .RE
 130 .sp
 131 .RS 4
 132 .ie n \{\
 133 \h'-04'\(bu\h'+03'\c
 134 .\}
 135 .el \{\
 136 .sp -1
 137 .IP \(bu 2.3
 138 .\}
 139 sp_min \- nombre de jours pendant lesquels le mot de passe ne peut pas \(^etre chang\('e
 140 .RE
 141 .sp
 142 .RS 4
 143 .ie n \{\
 144 \h'-04'\(bu\h'+03'\c
 145 .\}
 146 .el \{\
 147 .sp -1
 148 .IP \(bu 2.3
 149 .\}
 150 sp_max \- nombre maximal de jours avant que le mot de passe doive \(^etre chang\('e
 151 .RE
 152 .sp
 153 .RS 4
 154 .ie n \{\
 155 \h'-04'\(bu\h'+03'\c
 156 .\}
 157 .el \{\
 158 .sp -1
 159 .IP \(bu 2.3
 160 .\}
 161 sp_warn \- nombre de jours avant que le mot de passe n\*(Aqarrive en fin de validit\('e pendant lesquels l\*(Aqutilisateur est averti de la fin prochaine de la validit\('e de son mot de passe
 162 .RE
 163 .sp
 164 .RS 4
 165 .ie n \{\
 166 \h'-04'\(bu\h'+03'\c
 167 .\}
 168 .el \{\
 169 .sp -1
 170 .IP \(bu 2.3
 171 .\}
 172 sp_inact \- nombre de jours apr\(`es la fin de validit\('e du mot de passe avant de consid\('erer que le compte est inactif et soit d\('esactiv\('e
 173 .RE
 174 .sp
 175 .RS 4
 176 .ie n \{\
 177 \h'-04'\(bu\h'+03'\c
 178 .\}
 179 .el \{\
 180 .sp -1
 181 .IP \(bu 2.3
 182 .\}
 183 sp_expire \- nombre de jours, compt\('es \(`a partir du 1er janvier 1970, apr\(`es lesquels le compte sera d\('esactiv\('e
 184 .RE
 185 .sp
 186 .RS 4
 187 .ie n \{\
 188 \h'-04'\(bu\h'+03'\c
 189 .\}
 190 .el \{\
 191 .sp -1
 192 .IP \(bu 2.3
 193 .\}
 194 sp_flag \- r\('eserv\('e pour une utilisation future
 195 .RE
 196 .SH "DESCRIPTION"
 197 .PP
 198 \fIGetspent\fR,
 199 \fIgetspname\fR,
 200 \fIfgetspent\fR, et
 201 \fIsgetspent\fR
 202 renvoient tous un pointeur vers une structure
 203 \fIstruct spwd\fR\&.
 204 \fIGetspent\fR
 205 renvoie l\*(Aqentr\('ee suivante du fichier, et
 206 \fIfgetspent\fR
 207 renvoie l\*(Aqentr\('ee suivante du flux qui est consid\('er\('e comme \('etant un fichier au format correct\&.
 208 \fISgetspent\fR
 209 renvoie un pointeur vers une structure
 210 \fIstruct spwd\fR
 211 en utilisant la cha\(^ine de caract\(`ere fournie en entr\('ee\&.
 212 \fIGetspnam\fR
 213 cherche \(`a partir de la position courante une entr\('ee correspondant \(`a
 214 \fInom\fR
 215 dans le fichier fourni en entr\('ee\&.
 216 .PP
 217 \fISetspent\fR
 218 et
 219 \fIendspent\fR
 220 peuvent \(^etre utilis\('es pour d\('ebuter et terminer l\*(Aqacc\(`es au fichier de mots de passe cach\('es\&.
 221 .PP
 222 Les fonctions
 223 \fIlckpwdf\fR
 224 et
 225 \fIulckpwdf\fR
 226 doivent \(^etre utilis\('ees pour garantir un acc\(`es exclusif au fichier
 227 /etc/shadow\&.
 228 \fILckpwdf\fR
 229 essaie de placer un verrou avec
 230 \fIpw_lock\fR
 231 pendant 15 secondes\&. Il essaie ensuite de placer un second verrou en utilisant
 232 \fIspw_lock\fR
 233 pendant le reste de ces 15 secondes\&. Si un de ces verrous ne peut \(^etre plac\('e,
 234 \fIlckpwdf\fR
 235 renvoie \-1\&. Quand les deux verrous peuvent \(^etre plac\('es, la valeur 0 est renvoy\('ee\&.
 236 .SH "DIAGNOSTICS"
 237 .PP
 238 Les fonctions renvoient NULL si plus aucune entr\('ee n\*(Aqest disponible ou si une erreur est survenue lors du traitement\&. Les fonctions dont la valeur de retour est un
 239 \fIint\fR
 240 renvoient 0 en cas de succ\(`es et \-1 en cas d\*(Aq\('echec\&.
 241 .SH "AVERTISSEMENTS"
 242 .PP
 243 These routines may only be used by the superuser as access to the shadow password file is restricted\&.
 244 .SH "FICHIERS"
 245 .PP
 246 /etc/shadow
 247 .RS 4
 248 Informations s\('ecuris\('ees sur les comptes utilisateurs\&.
 249 .RE
 250 .SH "VOIR AUSSI"
 251 .PP
 252 \fBgetpwent\fR(3),
 253 \fBshadow\fR(5)\&.