Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getpwnam, getpwuid - Lire un enregistrement du fichier des mots de passe. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <pwd.h>[/b] [b]#include <sys/types.h>[/b] [b][i]struct passwd getpwnam (const char name );[/i][/b] [b][i]struct passwd getpwuid (uid_t uid );[/i][/b] .fi [size=18] [b]Description[/b] [/size] La fonction [b]getpwnam()[/b] renvoie un pointeur sur une structure contenant les divers champs de l'enregistrement de [i]/etc/passwd[/i] correspondant au nom d'utilisateur [i]name[/i]. La fonction [b]getpwuid()[/b] renvoie un pointeur sur une structure contenant les divers champs de l'enregistrement de [i]/etc/passwd[/i] correspondant au à l'ID d'utilisateur [i]uid[/i]. La structure [i]passwd[/i] est définie dans [i]<pwd.h>[/i] ainsi : [table][row][col]    [/col][col] .nf .ta 8n 16n 32n struct passwd { char pw_name; /* Nom d'utilisateur / char pw_passwd; /* Mot de passe / uid_t pw_uid; / ID de l'utilisateur / gid_t pw_gid; / ID du groupe de l'utilisateur / char pw_gecos; /* Nom réel de l'utilisateur / char pw_dir; /* Répertoire de connexion / char pw_shell; /* Programme Shell de connexion */ }; .ta .fi[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] Les fonctions [b]getpwnam()[/b] et [b]getpwuid()[/b] renvoient un pointeur sur une structure passwd, ou NULL si une erreur se produit, ou si l'enregistrement correspondant n'est pas trouvé. En cas d'erreur, [i]errno[/i] est rempli. [size=18] [b]Erreurs[/b] [/size] [b]0 ou ENOENT ou ESRCH ou EBADF ou EPERM ou ... [/b] [table][row][col]    [/col][col]Le nom [i]name[/i] ou l'identifiant [i]uid[/i] n'ont pas été trouvés.[/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Pas assez de mémoire pour allouer la structure passwd.[/col][/row][/table] [b]EIO[/b] [table][row][col]    [/col][col]Erreur d'entrée/sortie.[/col][/row][/table] [b]EINTR[/b] [table][row][col]    [/col][col]Un signal a été capturé.[/col][/row][/table] [b]EMFILE[/b] [table][row][col]    [/col][col]Le nombre maximal (OPEN_MAX) de fichiers ouverts pour le processus est atteint.[/col][/row][/table] [b]ENFILE[/b] [table][row][col]    [/col][col]Le nombre maximal de fichiers ouverts sur le système est atteint.[/col][/row][/table] [size=18] [b]Fichiers[/b] [/size] [i]/etc/passwd[/i] [table][row][col]    [/col][col]Base de données des mots de passe. .fi[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] SVID 3, POSIX, BSD 4.3 [size=18] [b]Notes[/b] [/size] La description "VALEUR RENVOYÉE" ci-dessu vient de Posix.1-2001. Elle ne considère pas le cas "non trouvé" commme une erreur, et ne spécifie pas [i]errno[/i] dans ce cas. Cela rend la détection d'erreur impossible. On peut dire que d'après Posix, [i]errno[/i] est inchangé dans le cas où aucune entrée n'est trouvée. Des essais sur de nombreux systèmes Unix ont fait apparaître différentes valeurs dans ce cas : 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM et probablement d'autres. [size=18] [b]Voir aussi[/b] [/size] [b]fgetpwent (3),[/b] [b]getgrnam (3),[/b] [b]getpwent (3),[/b] [b]setpwent (3),[/b] [b]endpwent (3),[/b] [b]getpw (3),[/b] [b]putpwent (3),[/b] [b]passwd (5)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier