NAME

     setfsgid - set group identity used for file system checks


SYNOPSIS

     int setfsgid(uid_t fsgid))


DESCRIPTION

     setfsgid sets the group ID that the  Linux  kernel  uses  to
     check  for  all  accesses  to the file system. Normally, the
     value of fsgid will shadow the value of the effective  group
     ID.  In  fact,  whenever  the effective group ID is changed,
     fsgid will also be changed to new value of  effective  group
     ID.

     An explicit call to setfsgid is usually only  used  by  pro-
     grams  such as the Linux NFS server that need to change what
     group ID is used for file  access  without  a  corresponding
     change  in the real and effective group IDs. A change in the
     normal group IDs for a program such as the NFS server  is  a
     security  hole  that  can expose it to unwanted signals from
     other group IDs.

     setfsgid will only succeed if the caller is the superuser or
     if  fsgid  matches either the real group ID, effective group
     ID, saved group ID, or the current value of fsgid.


RETURN VALUE

     On success, the previous value of  fsgid  is  returned.   On
     error, the current value of fsgid is returned.


CONFORMING TO

     setfsgid is Linux specific and should not be  used  in  pro-
     grams intended to be portable.


BUGS

     No error messages of any kind are returned to the caller. At
     the  very  least,  EPERM  should  be  returned when the call
     fails.


SEE ALSO

     setfsuid(2)