#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
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.
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.
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);
#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);
}
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 à