getpwent_r(3) Library Functions Manual getpwent_r(3) NOM getpwent_r, fgetpwent_r - Obtenir un enregistrement du fichier passwd de maniere reentrante BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include int getpwent_r(struct passwd *restrict tampon_pw, char tampon[restrict .taille_tampon], size_t taille_tampon, struct passwd **restrict pointeur_tampon_pw); int fgetpwent_r(FILE *restrict flux, struct passwd *restrict tampon_pw, char buf[restrict .taille_tampon], size_t taille_tampon, struct passwd **restrict pointeur_tampon_pw); Exigences de macros de test de fonctionnalites pour la glibc (consulter feature_test_macros(7)) : getpwent_r() : Depuis la glibc 2.19 : _DEFAULT_SOURCE glibc 2.19 et anterieures : _BSD_SOURCE || _SVID_SOURCE fgetpwent_r() : Depuis la glibc 2.19 : _POSIX_C_SOURCE >= 200809L glibc 2.19 et anterieures : _ATFILE_SOURCE DESCRIPTION Les fonctions getpwent_r() et fgetpwent_r() sont les versions reentrantes des fonctions getpwent(3) et fgetpwent(3). La premiere lit l'enregistrement passwd suivant a partir du flux initialise par setpwent(3). La seconde lit l'enregistrement passwd suivant a partir du flux flux. La structure passwd est definie dans comme ceci : struct passwd { char *pw_name; /* Nom d'utilisateur */ char *pw_passwd; /* Mot de passe de l'utilisateur */ uid_t pw_uid; /* ID de l'utilisateur */ gid_t pw_gid; /* ID du groupe */ char *pw_gecos; /* Information utilisateur */ char *pw_dir; /* Repertoire personnel */ char *pw_shell; /* Interpreteur de commande */ }; Pour plus d'informations a propos des champs de cette structure, consultez passwd(5). Les fonctions non reentrantes renvoient un pointeur sur une zone statique, zone qui contient d'autres pointeurs vers le nom, le mot de passe, le champ gecos, le repertoire personnel et l'interpreteur de commandes de l'utilisateur. Les fonctions reentrantes decrites ici renvoient tout cela dans des tampons fournis par l'appelant. Il y a tout d'abord le tampon tampon_pw qui contient une structure passwd, puis le tampon tampon de taille taille_tampon qui peut contenir des chaines supplementaires. Le resultat de ces fonctions, la structure passwd lue dans le flux, est enregistre dans le tampon *tampon_pw fourni, et un pointeur vers cette structure passwd est renvoye dans *pointeur_tampon_pw. VALEUR RENVOYEE Si elles reussissent, ces fonctions renvoient 0 et *pointeur_tampon_pw est un pointeur vers la structure passwd. Si elles echouent, ces fonctions renvoient une valeur d'erreur et *pointeur_tampon_pw est NULL. ERREURS ENOENT Il n'y a plus d'entrees. ERANGE La taille du tampon fourni est insuffisante. Veuillez essayer a nouveau avec un tampon plus grand. ATTRIBUTS Pour une explication des termes utilises dans cette section, consulter attributes(7). +--------------+--------------------------+----------------------------+ |Interface | Attribut | Valeur | +--------------+--------------------------+----------------------------+ |getpwent_r() | Securite des threads | MT-Unsafe race:pwent | | | | locale | +--------------+--------------------------+----------------------------+ |fgetpwent_r() | Securite des threads | MT-Safe | +--------------+--------------------------+----------------------------+ Dans la table ci-dessus, pwent dans race:pwent signifie que si une des fonctions setpwent(), getpwent(), endpwent() ou getpwent_r() est utilisee en parallele dans differents threads d'un programme, des situations de competition entre donnees peuvent apparaitre. VERSIONS D'autres systemes utilisent le prototype struct passwd * getpwent_r(struct passwd *pwd, char *tampon, int taille_tampon); ou mieux int getpwent_r(struct passwd *pwd, char *tampon, int taille_tampon, FILE **pw_fp); STANDARDS Aucun. HISTORIQUE Ces fonctions sont effectuees dans un style ressemblant a la version POSIX de fonctions comme getpwnam_r(3). NOTES La fonction getpwent_r() n'est pas vraiment reentrante puisqu'elle partage la position de lecture dans le flux avec tous les autres threads. EXEMPLES #define _GNU_SOURCE #include #include #include #include #define BUFLEN 4096 int main(void) { struct passwd pw; struct passwd *pwp; char buf[BUFLEN]; int i; setpwent(); while (1) { i = getpwent_r(&pw, buf, sizeof(buf), &pwp); if (i) break; printf("%s (%jd)\tHOME %s\tSHELL %s\n", pwp->pw_name, (intmax_t) pwp->pw_uid, pwp->pw_dir, pwp->pw_shell); } endpwent(); exit(EXIT_SUCCESS); } VOIR AUSSI fgetpwent(3), getpw(3), getpwent(3), getpwnam(3), getpwuid(3), putpwent(3), passwd(5) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Lucien Gentis Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 getpwent_r(3)