Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getgrnam, getgrgid - Obtenir l'enregistrement d'un goupe. [size=18] [b]Résumé[/b] [/size] .nf [b]#include <grp.h>[/b] [b]#include <sys/types.h>[/b] [b][i]struct group getgrnam (const char name );[/i][/b] [b][i]struct group getgrgid (gid_t gid );[/i][/b] .fi [size=18] [b]Description[/b] [/size] La fonction [b]getgrnam()[/b] renvoie un pointeur sur structure contenant l'enregistrement issus de [i]/etc/group[/i] pour le groupe correspondant au nom [i]name[/i]. La fonction [b]getgrgid()[/b] renvoie un pointeur sur structure contenant l'enregistrement issus de [i]/etc/group[/i] pour le groupe correspondant a l'ID [i]gid[/i]. La structure [i]group[/i] est définie dans [i]<grp.h>[/i] ainsi : [table][row][col]    [/col][col] .nf .ta 8n 16n 32n struct group { char gr_name; /* Nom du groupe. / char gr_passwd; /* Mot de passe du groupe. / gid_t gr_gid; / ID du groupe. / char gr_mem; / Membres du groupe. */ }; .ta .fi[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] Les fonctions [b]getgrnam()[/b] et [b]getgrgid()[/b] renvoient un pointeur sur la structure du groupe, ou NULL s'il n'y a pas de groupe correspondant aux données, ou si une erreur se produit. Dans ce cas, [i]errno[/i] est rempli.     La valeur de retour peut pointer sur une zone de mémoire statique, et peut être écrasée par des appels ultérieurs. [size=18] [b]Erreurs[/b] [/size] [b]0 ou ENOENT ou ESRCH ou EBADF ou EPERM ou ... [/b] [table][row][col]    [/col][col]Le nom [i]name[/i] ou l'identifiant [i]gid[/i] n'ont pas été trouvés.[/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Pas assez de mémoire.[/col][/row][/table] [b]EIO[/b] [table][row][col]    [/col][col]Erreur d'entrée/sortie.[/col][/row][/table] [b]EINTR[/b] [table][row][col]    [/col][col]Un signal a été capturé.[/col][/row][/table] [b]EMFILE[/b] [table][row][col]    [/col][col]Le nombre maximal (OPEN_MAX) de fichiers ouverts pour le processus est atteint.[/col][/row][/table] [b]ENFILE[/b] [table][row][col]    [/col][col]Le nombre maximal de fichiers ouverts sur le système est atteint.[/col][/row][/table] [size=18] [b]Fichiers[/b] [/size] [i]/etc/group[/i] [table][row][col]    [/col][col]Base de données des groupes. .fi[/col][/row][/table] [size=18] [b]Conformité[/b] [/size] SVID 3, POSIX, BSD 4.3 [size=18] [b]Notes[/b] [/size] La description "VALEUR RENVOYÉE" ci-dessu vient de Posix.1-2001. Elle ne considère pas le cas "non trouvé" commme une erreur, et ne spécifie pas [i]errno[/i] dans ce cas. Cela rend la détection d'erreur impossible. On peut dire que d'après Posix, [i]errno[/i] est inchangé dans le cas où aucune entrée n'est trouvée. Des essais sur de nombreux systèmes Unix ont fait apparaître différentes valeurs dans ce cas : 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM et probablement d'autres. [size=18] [b]Voir aussi[/b] [/size] [b]fgetgrent (3),[/b] [b]getgrent (3),[/b] [b]setgrent (3),[/b] [b]endgrent (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier