Provided by: manpages-pt-dev_20040726-2_all bug

NOME

       getgroups,  setgroups  -  obtém/seleciona  a lista sumplementar das IDs
       grupo

SINOPSE

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

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

       #define _BSD_SOURCE
       #include <grp.h>

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

DESCRIÇÂO

       getgroups
              Até size grupos sumplementares são retornados na list.  Se  size
              é  zero,  list  não  é  modificado, mas o número total de grupos
              sumplementares para o processo é retornado.

       setgroups
              Seleciona os grupos suplementares para  o  processo.  Somente  o
              superusuário pode usar esta função.

VALORES RETORNADOS

       getgroups
              Em  caso  de  sucesso, o número de IDs de grupos suplementares é
              retornado.  Caso contrário, -1 é retornado, e errno  selecionado
              apropriadamente.

       setgroups
              Em  caso  de  sucesso,  zero  é  retornado. Caso contrário, -1 é
              retornado, e errno selecionado apropriadamente.

ERROS

       EFAULT list tem um endereço inválido.

       EPERM  Para setgroups, o usuário não é o superusuário.

       EINVAL Para setgroups, size é  maior  que  NGROUPS  (32  para  o  Linux
              2.0.32).   Para  getgroups,  size é menor que o número de IDs de
              grupos suplementares, mas não é zero.

DE ACORDO COM

       SVr4, SVID (lançado somente na 4; estas chamadas não estavam  presentes
       na  SVr3),  X/OPEN,  4.3BSD.  A função getgroups está em POSIX.1. Desde
       setgroups requerer privilégios, ele não é coberto pela POSIX.1.

PROBLEMAS

       O sinalizador _BSD_SOURCE provavelmente não deveria ser  retornado  por
       setgroups.

VEJA TAMBÉM

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

TRADUZIDO POR LDP-BR em 21/08/2000.

       André    L.    Fassone    Canova   <lonelywolf@blv.com.br>   (tradução)
       xxxxxxxxxxxxxxxxxxxxxxxxx <xxx@xxxxxx.xxx.xx> (revisão)