.\" Copyright (C) 1995, Thomas K. Dyas <tdyas@eden.rutgers.edu>
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Created   1995-08-06 Thomas K. Dyas <tdyas@eden.rutgers.edu>
.\" Modified  2000-07-01 aeb
.\" Modified  2002-07-23 aeb
.\"
.\" Traducción de Urko Lusa <ulusa@arrakis.es> el 27/01/98
.\" Translation revised Sat Jan 29 2000 by Juan Piernas <piernas@ditec.um.es>
.\" Revisado por Miguel Pérez Ibars <mpi79470@alu.um.es> el 29-septiembre-2004
.\"
.TH SETFSGID 2 "23 julio 2002" "Linux 1.3.15" "Manual del Programador de Linux"
.SH NOMBRE
setfsgid \- establece la identidad del grupo que accede al sistema de
ficheros
.SH SINOPSIS
.B #include <unistd.h>
/* glibc usa <sys/fsuid.h> */
.sp
.BI "int setfsgid(uid_t " fsgid );
.SH DESCRIPCIÓN
La llamada al sistema
.B setfsgid
establece el identificador de grupo
que el núcleo de Linux usa para comprobar todos los accesos al sistema de
ficheros. Normalmente, el valor de
.I fsgid
cambiará según el valor del grupo efectivo. De hecho, cada vez que el
grupo efectivo cambie,
.I fsgid
también cambiará al nuevo valor del grupo efectivo.

Las llamadas explícitas a
.B setfsuid
y
.B setgsgid
normalmente sólo se usan en programas como el servidor NFS de Linux, que necesitan
cambiar el identificador de usuario y de grupo para acceder a un fichero, pero sin
cambiar los identificadores real y efectivo. Un cambio en el identificador
real del usuario para un programa como el servidor NFS supondría un agujero
de seguridad, al quedar expuesto a otras señales no deseadas. (véase más abajo.)

.B setfsgid
sólo tendrá éxito si quien lo invoca es el superusuario o si
.I fsgid
coincide con el identificador de grupo real, con el identificador de grupo
efectivo, con el setgid guardado o con el valor actual de
.IR fsgid .
.SH "VALOR DEVUELTO"
En caso de éxito, se devolverá el valor anterior de
.IR fsgid .
En caso de error, se devolverá el valor actual de
.IR fsgid .
.SH "CONFORME A"
.B setfsgid
es específico de Linux y no debería usarse en programas que se pretende sean
portables.
Está presente desde la versión 1.1.44 de Linux y en libc desde la versión 4.7.6.
.SH ERRORES
No se devuelve ningún mensaje de error a quien lo invoca. Al menos, debería
devolverse
.B EPERM
cuando todas las llamadas fallen.
.SH OBSERVACIONES
Cuando glibc determina que el argumento no es un ID de usuario válido,
devuelve \-1 y pone en \fIerrno\fP el valor EINVAL sin intentar 
la llamada al sistema.
.LP
Observe que en la época en la que esta llamada al sistema fue introducida,
un proceso podía enviar una señal a un proceso con el mismo ID de usuario
efectivo.
Hoy el manejo de los permisos sobre señales es ligeramente diferente.
.SH "VÉASE TAMBIÉN"
.BR kill (2), 
.BR setfsuid (2)