NOME

       capget, capset - seleciona/obtém as habilidades do processo

SINOPSE

       #undef _POSIX_SOURCE
       #include <sys/capability.h>

       int capget(cap_user_header_t header, cap_user_data_t data);

       int capset(cap_user_header_t header, const cap_user_data_t data);

DESCRIÇÃO

       Como  pertence ao Linux 2.2, o poder do superusuário foi dividido em um conjunto distinto de habilidades.
       Cada um dos processos tem um conjunto efetivo de habilidades identificando quais habilidades (se  alguma)
       podem ser usadas atualmente.  Cada um dos processos também tem um conjunto hereditário de habilidades que
       pode ser passado atráves de um execve(2) e um conjunto de  habilidades  permitidas  que  ele  pode  fazer
       efetivas ou hereditárias.

       Estas  duas  funções  são  a  interface pura do kernel para obtenção e selecionamento de habilidades. Não
       somente são específicas para o Linux, mas a API do kernel é apta para mudar  e  usar  estas  funções  (em
       particular o formanto de tipos cap_user_*_t ) é sujeita a mudanças em cada uma das revisões do kernel.

       As  interfaces  portáveis  são  cap_set_proc(3)  e  cap_get_proc(3);  se  possível  você  pode usar estas
       interfaces em aplicações.  Se você desejar usar as extensões Linux em aplicações, você precisaria usar as
       interfaces fáceis de uso capsetp(3) e capgetp(3).

VALORES DE RETORNO

       Em  caso  de  sucesso,  zero  é  retornado.  Em  caso  de  erro,  -1  é  retornado, e errno é selecionado
       apropriadamente.

ERROS

       EINVAL Um dos argumentos é inválido.

       EPERM  Existiu uma tentativa de  fazer  adicionar  uma  habilidae  para  conjuntos  permitidos,  ou  para
              selecionar uma habilidade em conjuntos efetivos ou hereditários que não no conjunto permitido.

INFORMAÇÕES ADICIONAIS

       A  interface  portável  para  interrogação  e selecionamento de funções é disponibilizada pela biblioteca
       libcap que esta disponibilizada a partir de:
       ftp://linux.kernel.org/pub/linux/libs/security/linux-privs

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

       André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) Fábio Henrique  F.  Silva  <fabiohfs@mail.com>
       (revisão)