getpwent_r(3)

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 pwbuf,
               char buf[restrict .size], size_t size,
               struct passwd **restrict pwbufp);
int fgetpwent_r(FILE *restrict stream, struct passwd *restrict pwbuf,
               char buf[restrict .size], size_t size,
               struct passwd **restrict pwbufp);

    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
    glibc 2.19 et antérieures :
        _BSD_SOURCE || _SVID_SOURCE

fgetpwent_r() :
    Depuis la glibc 2.19 :
        _POSIX_C_SOURCE >= 200809L
    glibc 2.19 et antérieures :
        _ATFILE_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).

The nonreentrant functions return a pointer to static storage, where this static storage contains further pointers to user name, password, gecos field, home directory and shell. The reentrant functions described here return all of that in caller-provided buffers. First of all there is the buffer pwbuf that can hold a struct passwd. And next the buffer buf of size size that can hold additional strings. The result of these functions, the struct passwd read from the stream, is stored in the provided buffer *pwbuf, and a pointer to this struct passwd is returned in *pwbufp.

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).
Interface | Attribut | Valeur
getpwent_r() | Sécurité des threads | MT-Unsafe race:pwent locale
fgetpwent_r() | Sécurité 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 utilisée en parallèle dans différents threads d'un programme, des situations de compétition entre données peuvent apparaître.

VERSIONS
D'autres systèmes utilisent le prototype

    struct passwd *
    getpwent_r(struct passwd *pwd, char buf[.size], int size);

ou mieux

    int
    getpwent_r(struct passwd *pwd, char buf[.size], int size,
               FILE **pw_fp);

STANDARDS
Aucun.

HISTORIQUE
Ces fonctions sont effectuées dans un style ressemblant à la version POSIX de fonctions comme getpwnam_r(3).

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.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Lucien Gentis <lucien.gentis@waika9.com>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) 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@lists.debian.org.