Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getgroups, setgroups - Lire/écrire la liste des groupes supplémentaires d'un processus. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/types.h>[/b] [b][/b] [b]#include <unistd.h>[/b] [b][i]int getgroups(int size , gid_t list []);[/i][/b] [b]#include <grp.h>[/b] [b][i]int setgroups(size_t size , const gid_t * list );[/i][/b] [size=18] [b]Description[/b] [/size] [b]getgroups[/b] [table][row][col]    [/col][col]retourne une liste [b]list[/b] contenant jusqu'à [i]size[/i] ID de groupes additionnels. Le groupe effectif du processus appelant peut être inclus ou non dans la liste (ainsi une application devrait également appeler [b]getegid (2)[/b] et ajouter ou supprimer la valeur résultante). Si [i]size[/i] vaut zéro, [i]list[/i] n'est pas modifiée, mais le nombre total de groupes supplémentaires pour le processus est renvoyé.[/col][/row][/table] [b]setgroups[/b] [table][row][col]    [/col][col]fixe des ID groupes supplémentaires pour le processus. Seul le Super-User peut utiliser cette fonction.[/col][/row][/table] [size=18] [b]Valeur renvoyée[/b] [/size] [b]getgroups[/b] [table][row][col]    [/col][col]renvoie le nombre d'ID de groupes supplémentaires du processus s'il réussit, ou -1 s'il échoue, auquel cas [i]errno[/i] contient le code d'erreur.[/col][/row][/table] [b]setgroups[/b] [table][row][col]    [/col][col]renvoie 0 s'il réussit, ou -1 s'il échoue, auquel cas [i]errno[/i] contient le code d'erreur.[/col][/row][/table] [size=18] [b]Erreurs[/b] [/size] [b]EFAULT[/b] [i]list[/i] [table][row][col]    [/col][col]pointe en dehors de l'espace d'adressage accessible.[/col][/row][/table] [b]EPERM[/b] [table][row][col]    [/col][col]Pour [b]setgroups ,[/b] l'utilisateur n'est pas le Super-User.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Pour [b]setgroups ,[/b] [i]size[/i] est plus grand que [b]NGROUPS[/b] (32 avec Linux 2.0.32). Pour [b]getgroups ,[/b] [i]size[/i] est inférieur au nombre d'ID de groupes supplémentaires, et n'est pas nul.[/col][/row][/table] [size=18] [b]Notes[/b] [/size] Un processus peut avoir jusqu'à NGROUPS_MAX ID de groupes supplémentaires en plus de son ID de groupe effectif. Le jeu d'ID de groupes supplémentaires est hérité du processus parent, et peut être modifié avec [b]setgroups .[/b] Le nombre maximal d'ID de groupes supplémentaires peut être obtenus avec [b]sysconf (3):[/b] .nf long ngroups_max; ngroups_max = sysconf(_SC_NGROUPS_MAX); .fi La valeur de retour maximale de [b]getgroups[/b] ne peut pas être plus grande que 1 plus la valeur ainsi obtenue.     Le prototype de [b]setgroups[/b] n'est disponible que si [b]_BSD_SOURCE[/b] est définie (soit explicitement, soit implicitement en ne définissant pas _POSIX_SOURCE ou en compilant avec l'option -ansi). [size=18] [b]Conformité[/b] [/size] SVr4, SVID (version 4 uniquement), X/OPEN, 4.3BSD. [b]getgroups[/b] est conforme a POSIX.1 (et présent dans BSD 4.3). Comme [b]setgroups[/b] nécessite des privilèges, il n'est pas couvert par POSIX.1. [size=18] [b]Voir aussi[/b] [/size] [b]initgroups (3), [/b] [b]getgid (2),[/b] [b]setgid (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier