GETGROUPS(2)       Manuel du programmeur Linux       GETGROUPS(2)


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

SYNOPSIS
       #include <unistd.h>

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


       #define __USE_BSD
       #include <grp.h>

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

DESCRIPTION
       getgroups
              retourne une  liste  list  contenant  jusqu'a  size
              groupes aditionnels.  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 groupes supplémentaires pour le processus.
              Seul le Super-User peut utiliser cette fonction.

VALEUR RENVOYÉE
       getgroups
              renvoie le nombre  de  groupes  supplémentaires  du
              processus  s'il  reussit, ou -1 s'il échoue, auquel
              cas errno contient le code d'erreur.

       setgroups
              renvoie 0 s'il reussit, 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.

       EPERM  Pour  setgroups,   l'utilisateur   n'est   pas   le
              Super-User.

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

CONFORMITÉ
       SVr4, SVID (version 4 uniquement), X/OPEN,  4.3BSD.   get­
       groups  est  conforme a POSIX.1 (et présent dans BSD 4.3).
       Comme setgroups nécessite des  privilèges,  il  n'est  pas
       couvert par POSIX.1.




Linux                     25 Avril 1998                         1





GETGROUPS(2)       Manuel du programmeur Linux       GETGROUPS(2)


BUGS
       La  constante symbolique __USE_BSD ne devrait probablement
       pas être nécessaire pour utiliser setgroups.

VOIR AUSSI
       initgroups(3), getgid(2), setgid(2)


TRADUCTION
       Christophe Blaess, 1997.















































Linux                     25 Avril 1998                         2