sourCEntral - mobile manpages

pdf

getpwent_r

NOM

getpwent_r, fgetpwent_r - Obtenir un enregistrement du fichier passwd de manière réentrante

BIBLIOTHÈQUE

Bibliothèque C standard (libc, -lc)

SYNOPSIS

#include <pwd.h>

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 fonctionnalités pour la glibc (consulter feature_test_macros(7)) :

getpwent_r() :
Depuis la glibc 2.19 :
_DEFAULT_SOURCE
Pour la glibc 2.19 et précédentes :
_BSD_SOURCE || _SVID_SOURCE

fgetpwent_r() :
Depuis la version 2.19 de la glibc :
_DEFAULT_SOURCE
Versions 2.19 et antérieures de la glibc :
_SVID_SOURCE

DESCRIPTION

Les fonctions getpwent_r() et fgetpwent_r() sont les versions réentrantes des fonctions getpwent(3) et fgetpwent(3). La première lit l’enregistrement passwd suivant à partir du flux initialisé par setpwent(3). La seconde lit l’enregistrement passwd suivant à partir du flux flux.

La structure passwd est définie dans <pwd.h> 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; /* Répertoire personnel */
char *pw_shell; /* Interpréteur de commande */
};

Pour plus d’informations à propos des champs de cette structure, consultez passwd(5).

Les fonctions non réentrantes renvoient un pointeur sur une zone statique, zone qui contient d’autres pointeurs vers le nom, le mot de passe, le champ gecos, le répertoire personnel et l’interpréteur de commandes de l’utilisateur. Les fonctions réentrantes décrites 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 chaînes supplémentaires. Le résultat de ces fonctions, la structure passwd lue dans le flux, est enregistré dans le tampon *tampon_pw fourni, et un pointeur vers cette structure passwd est renvoyé dans *pointeur_tampon_pw.

VALEUR RENVOYÉE

Si elles réussissent, ces fonctions renvoient 0 et *pointeur_tampon_pw est un pointeur vers la structure passwd. Si elles échouent, ces fonctions renvoient une valeur d’erreur et *pointeur_tampon_pw est NULL.

ERREURS

ENOENT

Il n’y a plus d’entrées.

ERANGE

La taille du tampon fourni est insuffisante. Veuillez essayer à nouveau avec un tampon plus grand.

ATTRIBUTS

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

img

Dans la table ci-dessus, pwent dans race:pwent signifie que si une des fonctions setpwent(), getpwent(), endpwent() ou getpwent_r() est utilisée en parallèle dans différents threads d’un programme, des situations de compétition entre données peuvent apparaître.

STANDARDS

Ces fonctions sont des extensions de GNU effectuées dans un style ressemblant à la version POSIX de fonctions comme getpwnam_r(3). D’autres systèmes 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);

NOTES

La fonction getpwent_r() n’est pas vraiment réentrante puisqu’elle partage la position de lecture dans le flux avec tous les autres threads.

EXEMPLES

#define _GNU_SOURCE
#include <pwd.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>

#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 française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan DOT rafin AT laposte DOT net>, Thierry Vignaud <tvignaud AT mandriva DOT com>, François Micaux, Alain Portal <aportal AT univ-montp2 DOT fr>, Jean-Philippe Guérard <fevrier AT tigreraye DOT org>, Jean-Luc Coulon (f5ibh) <jean-luc DOT coulon AT wanadoo DOT fr>, Julien Cristau <jcristau AT debian DOT org>, Thomas Huriaux <thomas DOT huriaux AT gmail DOT com>, Nicolas François <nicolas DOT francois AT centraliens DOT net>, Florentin Duneau <fduneau AT gmail DOT com>, Simon Paillard <simon DOT paillard AT resel DOT enst-bretagne DOT fr>, Denis Barbier <barbier AT debian DOT org>, David Prévot <david AT tilapin DOT org> et Lucien Gentis <lucien DOT gentis AT waika9 DOT com>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n’y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french.

pdf