Provided by: manpages-es_1.55-10_all bug

NOMBRE

       capget, capset - consulta/establece las capacidades de un proceso

SINOPSIS

       #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);

DESCRIPCI'ON

       A  partir  de la version 2.2 de Linux, el poder del superusuario (root)
       se ha dividido en un conjunto de capacidades discretas.   Todo  proceso
       posee   un  conjunto  de  capacidades  efectivas  que  identifican  que
       capacidades (si las  hay)  puede  ejercer  actualmente.   Todo  proceso
       tambien posee un conjunto de capacidades heredables que se pueden pasar
       a traves de  una  llamada  execve(2),  y  un  conjunto  de  capacidades
       permitidas que el proceso puede hacer efectivas o heredables.

       Estas  dos  funciones  son  las  interfaz  directa  con  el nucleo para
       consultar y establecer capacidades. No solo estas llamadas  al  sistema
       son  especificas  de  Linux  sino que el API del nucleo es probable que
       cambie, y el uso de estas funciones (en particular el  formato  de  los
       tipos cap_user_*_t) esta subjeto a cambios con cada version del nucleo.

       Las  interfaces portables son cap_set_proc(3) y cap_get_proc(3).  Si es
       posible, deberia usar estas interfaces en sus  aplicaciones.  Si  desea
       usar las extensiones de Linux en sus aplicaciones, deberia utilizar las
       interfaces capsetp(3) y capgetp(3), que son mas faciles de usar.

VALOR DEVUELTO

       En caso de exito, se devuelve un cero. En caso de error, se devuelve un
       -1 y se asigna a errno un valor apropiado.

ERRORES

       EINVAL Uno de los argumentos es incorrecto.

       EPERM  Se  ha  intentado  anadir una capacidad al conjunto Permitido, o
              asignar una capacidad que no esta en el  conjunto  Permitido  al
              conjunto Efectivo o Heredable.

INFORMACI'ON ADICIONAL

       La  interfaz  portable para las funciones de consulta y establecimiento
       de capacidades la proporciona la biblioteca libcap que esta  disponible
       aqui:
       ftp://linux.kernel.org/pub/linux/libs/security/linux-privs

V'EASE TAMBI'EN

       capabilities(7)