Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

setgroups

NOM

getgroups, setgroups - Lire/écrire la liste des groupes supplémentaires d'un processus

SYNOPSIS

#include <sys/types.h>
#include <unistd.h>

int getgroups(int size, gid_t list[]);

#include <grp.h>

int setgroups(size_t size, const gid_t *list);

DESCRIPTION

getgroups()

retourne une liste list contenant jusqu'à size identifiants de groupes (du processus appelant) additionnels. Le groupe effectif du processus appelant peut être inclus ou non dans la liste (ainsi une application devrait également appeler getegid(2) et ajouter ou supprimer la valeur résultante). Si size vaut zéro, list n'est pas modifiée, mais le nombre total de groupes supplémentaires pour le processus est renvoyé.

setgroups()

fixe des identifiants de groupes supplémentaires pour le processus. Les privilèges appropriés (sous Linux : la capacité CAP_SETGID) sont nécessaires.

VALEUR RENVOYÉE

getgroups()

Renvoie le nombre d'ID de groupes supplémentaires du processus s'il réussit, ou -1 s'il échoue, auquel cas errno contient le code d'erreur.

setgroups()

L'appel renvoie 0 quand il réussit, ou -1 s'il échoue, auquel cas errno contient le code d'erreur.

ERREURS

EFAULT

list pointe en dehors de l'espace d'adressage accessible.

EINVAL

Pour setgroups(), size est plus grand que NGROUPS (32 sous Linux 2.0.32). Pour getgroups(), size est inférieur au nombre d'ID de groupes supplémentaires, et n'est pas nul.

EPERM

Le processus appelant n'a pas suffisamment de privilèges pour appeler setgroups().

NOTES

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 setgroups. Le nombre maximal d'ID de groupes supplémentaires peut être obtenus avec sysconf(3) :

     long ngroups_max;
     ngroups_max = sysconf(_SC_NGROUPS_MAX);
 

La valeur de retour maximale de getgroups() ne peut pas être plus grande que 1 plus la valeur ainsi obtenue.

Le prototype de setgroups() n'est disponible que si _BSD_SOURCE est définie.

CONFORMITÉ

SVr4, BSD 4.3. La fonction getgroups() est conforme à POSIX.1-2001. Comme setgroups() nécessite des privilèges, elle n'est pas couverte par POSIX.1-2001.

VOIR AUSSI

getgid(2), setgid(2), initgroups(3), capabilities(7)

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006, et mise à disposition sur http://manpagesfr.free.fr/.

Les mises à jour et corrections de la version présente dans Debian sont directement gérées par Julien Cristau <jcristau@debian.org> et l'équipe francophone de traduction de Debian.

Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet manpages-fr.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».