Manpages

NOMBRE

setgid − establece la identidad de grupo

SINOPSIS

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

int setgid(gid_t gid);

DESCRIPCIÓN

setgid establece el ID de grupo efectivo del proceso en curso. Si quien llama a la función es el súper-usuario, se ponen también las IDs de grupo real y salvado.

Bajo Linux, setgid está implementada como la versión POSIX con la característica _POSIX_SAVED_IDS. Esto permite que un programa SGID (distinto de root) renuncie a todos sus privilegios de grupos, haga algún trabajo no privilegiado, y luego recupere su ID de grupo efectivo original de una manera segura.

VALOR DEVUELTO

En caso de éxito, se devuelve cero. En caso de error, se devuelve −1, y se pone un valor apropiado en errno.

ERRORES

EPERM

El usuario no es el súper-usuario (no tiene la capacidad CAP_SETGID), y gid no concuerda con el ID de grupo efectivo ni con el setgid salvado del proceso que llama a la función.

CONFORME A

SVr4, SVID.

VÉASE TAMBIÉN

getgid(2), setregid(2), setegid(2)