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ÓN

       A partir de la versión 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  qué capacidades (si las hay) puede ejercer actualmente.  Todo
       proceso también posee un conjunto de capacidades heredables que se pueden pasar  a  través
       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 núcleo  para  consultar  y  establecer
       capacidades.  No  sólo  estas llamadas al sistema son específicas de Linux sino que el API
       del núcleo es probable que cambie, y el uso de estas funciones (en particular  el  formato
       de los tipos cap_user_*_t) está subjeto a cambios con cada versión del núcleo.

       Las  interfaces  portables  son cap_set_proc(3) y cap_get_proc(3).  Si es posible, debería
       usar estas interfaces en sus aplicaciones. Si desea usar las extensiones de Linux  en  sus
       aplicaciones, debería utilizar las interfaces capsetp(3) y capgetp(3), que son más fáciles
       de usar.

VALOR DEVUELTO

       En caso de éxito, 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 añadir una capacidad al conjunto Permitido, o asignar una capacidad
              que no está en el conjunto Permitido al conjunto Efectivo o Heredable.

INFORMACIÓN ADICIONAL

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

VÉASE TAMBIÉN

       capabilities(7)