.\" ** You probably do not want to edit this file directly **
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
.TH "SHADOW" "3" "12/07/2005" "Appels de bibliothèque" "Appels de bibliothèque"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
shadow, getspnam \- routines d'utilisation des mots de passe cachés
.SH "SYNTAX"
.PP
\fI#include <shadow.h>\fR
.PP
\fIstruct spwd *getspent();\fR
.PP
\fIstruct spwd *getspnam(char\fR\fI*nom\fR\fI);\fR
.PP
\fIvoid setspent();\fR
.PP
\fIvoid endspent();\fR
.PP
\fIstruct spwd *fgetspent(FILE\fR\fI*fp\fR\fI);\fR
.PP
\fIstruct spwd *sgetspent(char\fR\fI*cp\fR\fI);\fR
.PP
\fIint putspent(struct spwd\fR\fI*p,\fR\fIFILE\fR\fI*fp\fR\fI);\fR
.PP
\fIint lckpwdf();\fR
.PP
\fIint ulckpwdf();\fR
.SH "DESCRIPTION"
.PP
\fIshadow\fR
manipule le contenu du fichier des mots de passe cachés,
\fI/etc/shadow\fR. La structure définie dans le fichier inclu est\ :
.sp
.nf
struct spwd {
      char		*sp_namp; /* nom de connexion de l'utilisateur */
      char		*sp_pwdp; /* mot de passe chiffré */
      long int		sp_lstchg; /* dernier changement de mot de passe */
      long int		sp_min; /* jours avant de pouvoir changer de mot de passe */
      long int		sp_max; /* jours avant l'obligation de changer de mot de passe */
      long int		sp_warn; /* jours d'avertissement avant la fin de validité */
      long int		sp_inact; /* jours avant que le compte soit inactif */
      long int		sp_expire; /* date de fin de validité du compte */
      unsigned long int	sp_flag; /* réservé pour une utilisation future */
}
    
.fi
.PP
La signification de chaque champ est la suivante\ :
.TP 3
\(bu
sp_namp \- pointeur vers le nom d'utilisateur \(Fo\ null\-terminated\ \(Fc
.TP
\(bu
sp_pwdp \- pointeur vers le mot de passe \(Fo\ null\-terminated\ \(Fc
.TP
\(bu
sp_lstchg \- numéro du jour de dernière modification du mot de passe à compter du premier janvier 1970
.TP
\(bu
sp_min \- nombre de jours pendant lesquels le mot de passe ne peut pas être changé
.TP
\(bu
sp_max \- nombre de jours maximal avant que le mot de passe doit être changé
.TP
\(bu
sp_warn \- nombre de jours avant que le mot de passe n'arrive en fin de validité pendant lesquels l'utilisateur est averti de la fin prochaine de la validité de son mot de passe
.TP
\(bu
sp_inact \- nombre de jours après la fin de validité du mot de passe avant de considérer que le compte est inactif et désactivé
.TP
\(bu
sp_expire \- numéro du jour après lesquels le compte est désactivé, à compter du 1er janvier 1970
.TP
\(bu
sp_flag \- réservé pour une utilisation future
.SH "DESCRIPTION"
.PP
\fIGetspent\fR,
\fIgetspname\fR,
\fIfgetspent\fR, et
\fIsgetspent\fR
renvoient tous un pointeur vers une structure
\fIstruct spwd\fR.
\fIGetspent\fR
renvoie l'entrée suivante du fichier, et
\fIfgetspent\fR
renvoie l'entrée suivante du flux qui est considéré comme étant un fichier au bon format.
\fISgetspent\fR
renvoie un pointeur vers une structure
\fIstruct spwd\fR
en utilisant la chaîne de caractère fournie en entrée.
\fIGetspnam\fR
cherche à partir de la position courante une entrée correspondant à
\fInom\fR
dans le fichier fourni en entrée.
.PP
\fISetspent\fR
et
\fIendspent\fR
peuvent être utilisés pour débuter et terminer l'accès au fichier de mots de passe cachés.
.PP
Les fonctions
\fIlckpwdf\fR
et
\fIulckpwdf\fR
doivent être utilisée pour garantir un accès exclusif au fichier
\fI/etc/shadow\fR.
\fILckpwdf\fR
essaie de placer un verrou avec
\fIpw_lock\fR
pendant 15 secondes. Il essaie ensuite de placer un second verrou en utilisant
\fIspw_lock\fR
pendant le reste de ces 15 secondes. Si un de ces verrous ne peut être placé,
\fIlckpwdf\fR
renvoie \-1. Quand les deux verrous peuvent être placés, la valeur 0 est renvoyée.
.SH "DIAGNOSTICS"
.PP
Les fonctions renvoient NULL si plus aucune entrée n'est disponible ou si une erreur est survenue pendant le traitement. Les fonctions dont la valeur de retour est un
\fIint\fR
renvoient 0 en cas de succès et \-1 en cas d'échec.
.SH "AVERTISSEMENTS"
.PP
Ces fonctions peuvent n'être disponibles que pour le superutilisateur, puisque l'accès au fichier de mots de passe cachés est restreint.
.SH "FICHIERS"
.TP
\fI/etc/shadow\fR
informations sécurisées sur les comptes utilisateurs
.SH "VOIR AUSSI"
.PP
\fBgetpwent\fR(3),
\fBshadow\fR(5).