NOM

       setfsgid - Définir le GID pour les vérifications d'accès au système de fichiers

SYNOPSIS

       #include <sys/fsuid.h>

       int setfsgid(uid_t fsgid);

DESCRIPTION

       L'appel  setfsgid()  modifie  la  valeur de l'identifiant du groupe (GID) que le noyau Linux utilise pour
       valider les accès au système de fichiers. Normalement, la  valeur  de  l'identifiant  s'alignera  sur  la
       valeur  effective  de  l'identifiant  de  l'utilisateur.  En pratique, si le GID effectif est modifié, la
       valeur du GID au niveau du système de fichiers sera également mise à jour à la  nouvelle  valeur  du  GID
       effectif.

       L'appel  explicite  de  setfsuid(2)  ou  setfsgid() n'est normalement utile qu'aux programmes tels que le
       serveur NFS qui ont besoin de  modifier  le  GID  utilisé  pour  les  accès  aux  fichiers  sans  changer
       véritablement  leurs  GID  réels  et  effectifs. Une modification des identifiants normaux d'un programme
       comme un serveur NFS serait un trou de sécurité qui l'exposerait à des  signaux  indésirables.  Voir  ci‐
       dessous.

       setfsgid()  ne  réussira  que si l'appelant est le superutilisateur ou si fsgid correspond au GID réel de
       l'appelant, à son GID effectif, à son GID sauvé, ou encore à la valeur de l'identifiant de  l'utilisateur
       dans le système de fichiers au moment de l'appel.

VALEUR RENVOYÉE

       En  cas  de  succès  comme  en cas d'échec, l'appel renvoie la dernière valeur de l'identifiant du groupe
       (GID) de l'appelant dans le système de fichiers.

VERSIONS

       Cet appel système est présent sous Linux depuis la version 1.2.

CONFORMITÉ

       setfsgid() est spécifique à Linux et ne devrait pas être employé dans  des  programmes  destinés  à  être
       portables.

NOTES

       Lorsque la bibliothèque glibc s'aperçoit que l'argument n'est pas un GID valide, elle renvoie -1 et place
       EINVAL dans errno sans essayer d'appeler l'appel système réel.

       Notez que lors de l'introduction de cet appel système, un processus pouvait envoyer un signal à un  autre
       processus  avec  le  même  UID  effectif.  De nos jours, les permissions pour les signaux sont légèrement
       différentes. Consultez  setfsuid(2) si vous souhaitez connaître les raisons pour  lesquelles  setfsuid(2)
       et setfsgid() ne sont désormais plus nécessaires.

       L'appel  système  setfsgid()  original  de Linux ne gérait que des identifiants de groupe sur 16 bits. En
       conséquence, Linux 2.4 a ajouté setfsgid32() qui prend en charge des identifiants  32 bits.  La  fonction
       setfsgid() de la glibc qui l'encapsule gère de manière transparente ces différences entre noyaux.

BOGUES

       Aucune  indication  concernant  l'erreur  n'est  renvoyée à l'appelant et le fait que la même valeur soit
       retournée en cas de succès ou d'échec ne permet pas de savoir si l'appel a réussi ou échoué.  Pour  cela,
       l'appelant  devra  se référer à la valeur renvoyée par un appel ultérieur par exemple à setfsgid(-1) (qui
       échouera toujours). Cet  appel  permettra  de  savoir  si  un  appel  antérieur  à  setfsgid()  a  changé
       l'identifiant  du  groupe  (GID)  au  niveau  du système de fichiers. Au minimum, EPERM doit être renvoyé
       lorsque l'appel échoue (puisque l'appelant ne dispose pas des privilèges CAP_SETGID).

VOIR AUSSI

       kill(2), setfsuid(2), capabilities(7), credentials(7)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description du projet et des
       instructions     pour     signaler     des     anomalies    peuvent    être    trouvées    à    l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Christophe       Blaess       <http://www.blaess.fr/christophe/>      (1996-2003),      Alain      Portal
       <http://manpagesfr.free.fr/> (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de  traduction  de
       Debian (2006-2009).

       Veuillez  signaler  toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».