Linux Certif

Toute la documentation sur la certification Linux LPI

shadow

NOM

shadow, getspnam - routines d'utilisation des mots de passe cach'es

SYNTAX

#include <shadow.h>

struct spwd *getspent();

struct spwd *getspnam(char *nom);

void setspent();

void endspent();

struct spwd *fgetspent(FILE *fp);

struct spwd *sgetspent(char *cp);

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

int lckpwdf();

int ulckpwdf();

DESCRIPTION

shadow manipule le contenu du fichier des mots de passe cach'es, /etc/shadow. La structure d'efinie dans le fichier inclus est :

 struct spwd {
       char              *sp_namp; /* nom de connexion de l'utilisateur */
       char              *sp_pwdp; /* mot de passe chiffr'e */
       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'e */
       long int          sp_inact; /* jours avant que le compte soit inactif */
       long int          sp_expire; /* date de fin de validit'e du compte */
       unsigned long int sp_flag; /* r'eserv'e pour une utilisation future */
 }
     
 

La signification de chaque champ est la suivante :

* sp_namp - pointeur vers le nom d'utilisateur termin'e par un z'ero binaire (Fo null-terminated Fc)

* sp_pwdp - pointeur vers le mot de passe termin'e par un z'ero binaire ( Fo null-terminated Fc)

* sp_lstchg - nombre de jours, compt'es `a partir du 1er janvier 1970, depuis la derni`ere modification du mot de passe

* sp_min - nombre de jours pendant lesquels le mot de passe ne peut pas ^etre chang'e

* sp_max - nombre maximal de jours avant que le mot de passe doive ^etre chang'e

* sp_warn - nombre de jours avant que le mot de passe n'arrive en fin de validit'e pendant lesquels l'utilisateur est averti de la fin prochaine de la validit'e de son mot de passe

* 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

* sp_expire - nombre de jours, compt'es `a partir du 1er janvier 1970, apr`es lesquels le compte sera d'esactiv'e

* sp_flag - r'eserv'e pour une utilisation future

DESCRIPTION

Getspent, getspname, fgetspent, et sgetspent renvoient tous un pointeur vers une structure struct spwd. Getspent renvoie l'entr'ee suivante du fichier, et fgetspent renvoie l'entr'ee suivante du flux qui est consid'er'e comme 'etant un fichier au format correct. Sgetspent renvoie un pointeur vers une structure struct spwd en utilisant la cha^ine de caract`ere fournie en entr'ee. Getspnam cherche `a partir de la position courante une entr'ee correspondant `a nom dans le fichier fourni en entr'ee.

Setspent et endspent peuvent ^etre utilis'es pour d'ebuter et terminer l'acc`es au fichier de mots de passe cach'es.

Les fonctions lckpwdf et ulckpwdf doivent ^etre utilis'ees pour garantir un acc`es exclusif au fichier /etc/shadow. Lckpwdf essaie de placer un verrou avec pw_lock pendant 15 secondes. Il essaie ensuite de placer un second verrou en utilisant spw_lock pendant le reste de ces 15 secondes. Si un de ces verrous ne peut ^etre plac'e, lckpwdf renvoie -1. Quand les deux verrous peuvent ^etre plac'es, la valeur 0 est renvoy'ee.

DIAGNOSTICS

Les fonctions renvoient NULL si plus aucune entr'ee n'est disponible ou si une erreur est survenue lors du traitement. Les fonctions dont la valeur de retour est un int renvoient 0 en cas de succ`es et -1 en cas d''echec.

AVERTISSEMENTS

These routines may only be used by the superuser as access to the shadow password file is restricted.

FICHIERS

/etc/shadow

Informations s'ecuris'ees sur les comptes utilisateurs.

VOIR AUSSI

getpwent(3), shadow(5).