NOME

       setfsgid - seleciona a identidade do grupo usado para verificações do sistema de arquivos

SINOPSE

       #include <unistd.h> /* a glibc usa <sys/fsuid.h> */

       int setfsgid(uid_t fsgid);

DESCRIÇÃO

       setfsgid  seleciona a ID do grupo que o kernel do Linux usa para verificar todos os acessos ao sistema de
       arquivos. Normalmente, o valor de fsgid será o mesmo da ID do grupo ativo. Na verdade, sempre que o grupo
       ativo for alterado, fsgid também será mudado para o novo valor do ID do grupo ativo.

       Uma chamada explícita a setfsgid é normalmente usada apenas  por  programas  como  o  servidor  NFS,  que
       precisa  alterar  a  ID do grupo que é usada para acessar um arquivo sem uma alteração correspondente nas
       IDs do grupo real e efetivo. Uma alteração na ID do grupo normal de um programa como o servidor NFS é uma
       falha de segurança que pode expô-lo a sinais indesejados a partir de outras IDs de grupo.

       setfsgid sucederá somente se o solicitante é o superusuário ou se fsgid casa com a  ID  do  grupo:  real,
       efetivo, persistente do usuário, ou com o valor atual de fsgid.

VALORES RETORNADOS

       Em  caso  de  sucesso,  o  valor anterior de fsgid é retornado. Em caso de erro, o valor atual de fsgid é
       retornado.

DE ACORDO COM

       setfsgid é específica do Linux e não deve ser usada em programas que pretendem ser portáveis.

PROBLEMAS

       Nenhuma mensagem de erro de qualquer tipo é retornada para o solicitante.  Pelo menos, EPERM deveria  ser
       retornada quando a chamada falha.

NOTA

       Quando  a  glibc determinar que o argumento não é uma gid válida, ela irá retornar -1 e atribuir EINVAL a
       errno sem tentar a chamada de sistema.

VEJA TAMBÉM

       setfsuid(2)

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

       André   L.   Fassone   Canova   <lonelywolf@blv.com.br>   (tradução)    Marcus    Vinicius    S.    Brito
       <pazu@visaotec.com.br> (revisão)

Linux 1.3.15                                       06/08/1995                                        SETFSGID(2)