.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\"
.\" Modified Sat Jul 24 19:37:37 1993 by Rik Faith (faith@cs.unc.edu)
.\" Modified Mon May 27 22:40:48 1996 by Martin Schulze (joey@linux.de)
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fgetpwent 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" 
.SH NOM
fgetpwent \- Lire des entrées d'un fichier de mots de passe
.SH BIBLIOTHÈQUE
Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP)
.SH SYNOPSIS
.nf
\fB#include <stdio.h>\fP
\fB#include <sys/types.h>\fP
\fB#include <pwd.h>\fP
.PP
\fBstruct passwd *fgetpwent(FILE *\fP\fIstream\fP\fB);\fP
.fi
.PP
.RS -4
Exigences de macros de test de fonctionnalités pour la glibc (consulter
\fBfeature_test_macros\fP(7))\ :
.RE
.PP
\fBfgetpwent\fP()\ :
.nf
    Depuis la glibc 2.19 :
        _POSIX_C_SOURCE >= 200809L
    glibc 2.19 et antérieures :
        _ATFILE_SOURCE
.fi
.SH DESCRIPTION
La fonction \fBfgetpwent\fP() renvoie un pointeur vers une structure contenant
les différents champs d'une ligne du fichier \fIstream\fP. Lors de la première
invocation, elle renvoie le premier enregistrement, ensuite elle retourne
successivement les enregistrements suivants du fichier. Le fichier indiqué
par \fIstream\fP doit avoir le même format que \fI/etc/passwd\fP (consultez
\fBpasswd\fP(5)).
.PP
La structure \fIpasswd\fP est définie dans \fI<pwd.h>\fP comme ceci\ :
.PP
.in +4n
.EX
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;      /* Nom réel */
    char   *pw_dir;        /* Répertoire personnel */
    char   *pw_shell;      /* Interpréteur de commande */
};
.EE
.in
.SH "VALEUR RENVOYÉE"
La fonction \fBfgetpwent\fP() renvoie un pointeur vers une structure \fIpasswd\fP,
ou NULL si il n'y a plus d'enregistrement, ou si une erreur s'est
produite. En cas d'erreur, \fIerrno\fP est positionné pour indiquer l'erreur.
.SH ERREURS
.TP 
\fBENOMEM\fP
Pas assez de mémoire pour allouer la structure \fIpasswd\fP.
.SH FICHIERS
.TP 
\fI/etc/passwd\fP
Fichier de base de données des mots de passe
.SH ATTRIBUTS
Pour une explication des termes utilisés dans cette section, consulter
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Attribut	Valeur
T{
.na
.nh
\fBfgetpwent\fP()
T}	Sécurité des threads	MT\-Unsafe race:fgetpwent
.TE
.sp 1
.\" FIXME: The marking is different from that in the glibc manual,
.\" which has:
.\"
.\"    fgetpwent: MT-Unsafe race:fpwent
.\"
.\" We think race:fpwent in glibc maybe hard for users to understand,
.\" and have sent a patch to the GNU libc community for changing it to
.\" race:fgetpwent, however, something about the copyright impeded the
.\" progress.
.SH STANDARDS
Aucun.
.SH HISTORIQUE
SVr4.
.SH "VOIR AUSSI"
\fBendpwent\fP(3), \fBfgetpwent_r\fP(3), \fBfopen\fP(3), \fBgetpw\fP(3), \fBgetpwent\fP(3),
\fBgetpwnam\fP(3), \fBgetpwuid\fP(3), \fBputpwent\fP(3), \fBsetpwent\fP(3), \fBpasswd\fP(5)
.PP
.SH 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
Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>
.
.PP
Cette traduction est une documentation libre ; veuillez vous reporter à la
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License version 3
.UE
concernant les conditions de copie et 
de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
.PP
Si vous découvrez un bogue dans la traduction de cette page de manuel, 
veuillez envoyer un message à
.MT debian-l10n-french@lists.debian.org
.ME .