NOM

       getgroups, setgroups - Lire et é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);

   Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

       setgroups() : _BSD_SOURCE

DESCRIPTION

       getgroups()  renvoie  dans la liste list les identifiants des groupes additionnels du processus appelant.
       Le paramètre size doit indiquer le nombre maximal d'éléments qui peuvent  être  stockés  dans  le  tampon
       pointé  par  list. Si le processus appelant a plus que size groupes additionnels, cela génère une erreur.
       Il n'est pas spécifié si l'identifiant du groupe effectif du processus appelant est inclus dans la  liste
       renvoyée  (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  additionnels   pour  le
       processus  est  renvoyé.  Ceci  permet  à  l'appelant  de  déterminer  la taille d'une liste list allouée
       dynamiquement à utiliser dans une appel à getgroups() ultérieur.

       setgroups() définit des identifiants de groupe additionnels pour le processus  appelant.  Les  privilèges
       appropriés  (sous  Linux :  la capacité CAP_SETGID) sont nécessaires. Le paramètre size indique le nombre
       d'identifiants de groupe additionnels du tampon pointé par list.

VALEUR RENVOYÉE

       En cas de succès, getgroups() renvoie le nombre d'identifiants de groupe additionnels. En  cas  d'erreur,
       -1 est renvoyé et errno contient le code d'erreur.

       En  cas  de  succès,  setgroups()  renvoie  0.  En cas d'erreur, -1 est renvoyé et errno contient le code
       d'erreur.

ERREURS

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

       getgroups() peut également échouer avec les erreurs suivantes :

       EINVAL size est inférieur au nombre d'identifiants de groupe additionnels, et n'est pas nul.

       setgroups() peut également échouer avec les erreurs suivantes :

       EINVAL size est plus grand que NGROUPS_MAX (32 avant Linux 2.6.4 ; 65536 depuis Linux 2.6.4).

       ENOMEM Plus de mémoire disponible.

       EPERM  L'appelant n'a pas les privilèges nécessaires.

CONFORMITÉ

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

NOTES

       Un  processus  peut  avoir  jusqu'à  NGROUPS_MAX  identifiants  de  groupe  additionnels  en  plus de son
       identifiant  de  groupe  effectif.  La  constante  NGROUPS_MAX  est  définie  dans  <limits.h>.  Le   jeu
       d'identifiants  de  groupe  additionnels  est  hérité du processus parent, et est préservé au travers des
       appels à execve(2).

       Le nombre maximal d'identifiants de groupe additionnels peut être obtenu pendant l'exécution au moyen  de
       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 cette valeur. Depuis
       Linux 2.6.4, le nombre maximal d’identifiants de groupe additionnels est aussi exposé à l’aide du fichier
       /proc/sys/kernel/ngroups_max en lecture seule et spécifique à Linux.

       L'appel  système  getgid()  original  de  Linux  ne gérait que des identifiants de groupe sur 16 bits. En
       conséquence, Linux 2.4 a ajouté getgroups32() qui prend en charge des identifiants 32 bits.  La  fonction
       getgroups() de la glibc qui l'encapsule gère de manière transparente ces différences entre noyaux.

VOIR AUSSI

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

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description du projet et des
       instructions    pour    signaler    des    anomalies    peuvent     être     trouvées     à     l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Christophe      Blaess      <http://www.blaess.fr/christophe/>      (1996-2003),       Alain       Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de  traduction de
       Debian (2006-2009).

       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> ».