#include <sys/types.h>
#include <pwd.h>
struct passwd *getpwnam(const char *nom);
struct passwd *getpwuid(uid_t uid);
int getpwnam_r(const char *restrict nom, struct passwd *restrict pwd,
char tampon[restrict .taille_tampon], size_t taille_tampon,
struct passwd **restrict result);
int getpwuid_r(uid_t uid, struct passwd *restrict pwd,
char tampon[restrict .taille_tampon], size_t taille_tampon,
struct passwd **restrict result);
Exigences de macros de test de fonctionnalités pour la glibc (consulter feature_test_macros(7)) :
getpwnam_r(), getpwuid_r() :
_POSIX_C_SOURCE
|| /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE
La fonction getpwuid() renvoie un pointeur sur une structure contenant les divers champs de l'enregistrement de la base de données des mots de passe correspondant à l'ID utilisateur uid.
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 */
};
Consultez passwd(5) pour plus d'informations sur ces champs.
Les fonctions getpwnam_r() et getpwuid_r() fournissent les mêmes informations que getpwnam() et getpwuid() mais enregistrent la structure passwd trouvée dans l'espace pointé par pwd. Cette structure passwd contient des pointeurs vers des chaînes qui sont enregistrées dans le tampon de taille taille_tampon. Un pointeur vers le résultat (en cas de succès) ou NULL (au cas où aucune entrée n'ait été trouvée ou qu'une erreur soit survenue) est enregistré dans *result.
L'appel
sysconf(_SC_GETPW_R_SIZE_MAX)
renvoie soit -1 sans modifier errno, soit une suggestion de taille initiale pour buf (si cette taille est trop petite, l'appel échoue avec ERANGE, auquel cas l'appelant peut réessayer avec un tampon plus grand).
La valeur de retour peut pointer vers une zone statique et donc être écrasée par des appels successifs à getpwent(3), getpwnam() ou getpwuid() (ne pas passer le pointeur renvoyé à free(3)).
En cas de succès, getpwnam_r() et getpwuid_r() renvoient 0 et définissent *result à pwd. Si aucun mot de passe ne correspond, ces fonctions renvoient 0 et définissent *result à NULL. En cas d'erreur, un code d'erreur est renvoyé et *result est défini à NULL.
| Interface | Attribut | Valeur |
| getpwnam() | Sécurité des threads |
MT-Unsafe race:pwnam locale
|
| getpwuid() | Sécurité des threads |
MT-Unsafe race:pwuid locale
|
| getpwnam_r(), getpwuid_r() | Sécurité des threads |
MT-Safe locale
|
Le champ pw_dir contient le nom du répertoire de travail initial de l'utilisateur. Les programmes de connexion (« login ») utilisent ce champ pour initialiser la variable d'environnement HOME pour les interpréteurs de commandes initiaux. Une application qui souhaite déterminer le répertoire personnel des utilisateurs doit lire la valeur de HOME (au lieu de la valeur de getpwuid(getuid())->pw_dir) puisque cela permet à l'utilisateur de modifier « son répertoire personnel » lorsqu'il est connecté. Pour déterminer le répertoire personnel « initial » d'un autre utilisateur, il est nécessaire d'utiliser getpwnam("utilisateur")->pw_dir ou un équivalent.
#include <errno.h>
#include <pwd.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int
main(int argc, char *argv[])
{
struct passwd pwd;
struct passwd *result;
char *buf;
long bufsize;
int s;
if (argc != 2) {
fprintf(stderr, "Usage: %s username\n", argv[0]);
exit(EXIT_FAILURE);
}
bufsize = sysconf(_SC_GETPW_R_SIZE_MAX);
if (bufsize == -1) /* Value was indeterminate */
bufsize = 16384; /* Should be more than enough */
buf = malloc(bufsize);
if (buf == NULL) {
perror("malloc");
exit(EXIT_FAILURE);
}
s = getpwnam_r(argv[1], &pwd, buf, bufsize, &result);
if (result == NULL) {
if (s == 0)
printf("Not found\n");
else {
errno = s;
perror("getpwnam_r");
}
exit(EXIT_FAILURE);
}
printf("Name: %s; UID: %jd\n", pwd.pw_gecos,
(intmax_t) pwd.pw_uid);
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 à