Linux Certif

Toute la documentation sur la certification Linux LPI

shadow

NOM

shadow - routines pour fichier mots de passe encrypt�s

SYNTAXE

#include <shadow.h>

struct spwd *getspent();

struct spwd *getspnam(char *name);

void setspent();

void endspent();

struct spwd *fgetspent(FILE *fp);

struct spwd *sgetspent(char *cp);

int putspent(struct spwd *p, FILE *fp);

int lckpwdf();

int ulckpwdf();

DESCRIPTION

shadow manipule le contenu du fichier mots de passe chiffr�s, /etc/shadow. La structure dans le fichier #include est

struct spwd {
       char    *sp_namp; /* nom de connexion utilisateur */

       char    *sp_pwdp; /* mot de passe encrypt� */

       long    sp_lstchg; /* derni�re modification du mot de passe */

       int     sp_min; /* nombre de jours jusqu'� l'autorisation de modification */

       int     sp_max; /* nombre de jours avant une n�cessaire modification */

       int     sp_warn; /* nombre de jours d'avertissement avant expiration */

       int     sp_inact; /* nombre de jours avant que le compte soit inactif */

       int     sp_expire; /* date d'expiration du compte */

       int     sp_flag; /* r�serv� � une utilisation future */

}

La signification de chaque champ est :

sp_namp - pointeur sur une cha�ne de caract�res contenant le nom d'utilisateur et se terminant par le caract�re nul.
sp_pwdp - pointeur sur une cha�ne de caract�res contenant le mot de passe et se terminant par le caract�re nul.
sp_lstchg - nombre de jours depuis le 1er janvier 1970 de la derni�re modification du mot de passe.
sp_min - nombre de jours avant que le mot de passe puisse �tre modifi�.
sp_max - nombre de jours apr�s que le mot de passe doive �tre modifi�.
sp_warn - nombre de jours avant que le mot de passe expire et pendant lequels l'utilisateur sera averti de l'imminence de l'expiration du mot de passe.
sp_inact - nombre de jours apr�s l'expiration du mot de passe o� le compte est consid�r� comme inactif et sera invalid�.
sp_expire - nombre de jours depuis le 1er janvier 1970 o� le compte sera invalid�.
sp_flag - r�serv� � une utilisation future.

DESCRIPTION

getspent, getspname, fgetspent, et sgetspent retournent chacune un pointeur sur une structure struct spwd. getspent retourne la prochaine entr�e du fichier, et fgetspent retourne la prochaine entr�e du flot donn�, qui est suppos� �tre un fichier au format correct. sgetspent retourne un pointeur sur une structure struct spwd en utilisant la cha�ne fournie comme entr�e. getspnam cherche dans le fichier, � partir de la position courante, une entr�e correspondant � name.

setspent et endspent peuvent �tre utilis�es pour d�buter et achever, respectivement, l'acc�s au fichier mots de passe masqu�s.

Les routines lckpwdf et ulckpwdf peuvent �tre utilis�es pour garantir un acc�s exclusif au fichier /etc/shadow. lckpwdf tente d'obtenir un verrouillage en utilisant pw_lock pour plus de 15 secondes. Il continue en essayant d'obtenir un second verrouillage en utilisant spw_lock pour le reste du temps des 15 secondes. Si l'une ou l'autre tentative �choue au bout de 15 secondes, lckpwdf retourne -1. Lorsque les deux verrouillages sont obtenus, elle retourne 0.

DIAGNOSTICS

Les routines retournent NULL s'il n'y a plus d'entr�es disponibles ou si une erreur est apparue durant le traitement. Les routines qui ont un int comme valeur de retour retournent 0 en cas de succ�s et -1 en cas d'�chec.

MISE EN GARDE

Ces routines ne peuvent �tre utilis�es que par l'administrateur, car l'acc�s au fichier des mots de passe masqu�s est restreint.

FICHIERS

/etc/shadow - fichier des mots de passe utilisateur masqu�s

VOIR AUSSI

getpwent(3), shadow(5)

AUTEUR

Julianne Frances Haugh (jockgrrl@ix.netcom.com)

TRADUCTION

Ce document est une traduction, r�alis�e par Alain Portal <aportal AT univ-montp2 DOT fr> le Novembre 2004.

L'�quipe de traduction a fait le maximum pour r�aliser une adaptation fran�aise de qualit�.

La version anglaise la plus � jour de ce document est toujours consultable via la commande : LANGUAGE=en man xxxx

N'h�sitez pas � signaler � l'auteur ou au traducteur, selon le cas, toute erreur dans de cette page de manuel.