NOME

       setuid - selecionar a identidade do usuário

SINOPSE

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

       int setuid(uid_t uid)

DESCRIÇÃO

       setuid seleciona a ID efetiva de usuário do processo atual.  Se a ID efetiva do usuário do
       processo solicitante é root, as ID´s efetivas e guardas serão também selecionadas.

       No Linux, setuid é implementado como a versão POSIX com a característica _POSIX_SAVED_IDS.
       Isto  permite  um  programa  setuid  (exceto  root) para deixar todos deste privilérios de
       usuário, para alguns trabalhos desprivilegiados, e então reusa a  ID  de  usuário  efetiva
       original em um modo seguro.

       Se  o  usuário  é  o  superusuário ou o programa setuid root, cuidados especiais devem ser
       tomados. A função setuid verefica a uid efetiva do solicitante e se ele é o  superusuário,
       todo processo com a ID do usuário serão selecionadas para uid.  Deposi disto ter ocorrido,
       é impossível para o programa recuperar os privilégios de superusuário.

       Assim, um programa  setuid  root  desejando,  temporariamente,  deixa  os  privilégios  de
       superusuário,  assume  a identidade de um usuário sem ser o superusuário, e então recupera
       os privilégios de superusuário mas tarde sem poder usar setuid.  Você pode completar  esta
       com a chamada (BSD, e não a POSIX) seteuid.

VALORES RETORNADOS

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

ERROS

       EPERM  O usuário não é o superusuário, e uid não casa a ID de usuário efetiva ou  guardada
              do processo solicitante.

DE ACORDO COM

       SVr4,  SVID,  POSIX.1.  Não  totalmente compatível com a chamada BSD 4.4, a qual seleciona
       todas as IDs de usuário real, guardada, e efetiva. SVr4 documenta  uma  condição  de  erro
       adicional EINVAL.

ADVERTÊNCIA ESPEÍFICA PARA O LINUX

       O  Linux  tem  o  conceito de ID de usuário do sistema de arquivos, normalmente igual a ID
       efetiva de usuário. A chamada setuid também seleciona  a  ID  de  usuário  do  sistema  de
       arquivos do processo corrente.  Veja setfsuid(2).

       Se  uid  é  diferente  de  velhas uid efetivas, o processo irá ser proíbido de saídas core
       dumps.

VEJA TAMBÉM

       getuid(2), setreuid(2), seteuid(2), setfsuid(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)