NOM

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

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <sys/fsuid.h>

       [[obsolète]]int setfsgid(uid_t fsgid);

DESCRIPTION

       Sur  Linux, un processus a à la fois un identifiant de groupe de système de fichiers et un
       identifiant de groupe effectif. L'identifiant de groupe de système de fichiers (spécifique
       à  Linux)  est  utilisé  pour  la  vérification des droits lors de l'accès aux systèmes de
       fichiers, alors que l'identifiant de groupe effectif est utilisé pour  d'autres  types  de
       vérifications de droits (voir credentials(7)).

       Normalement,  la valeur de l'identifiant de groupe du système de fichiers du processus est
       la même que celle de l'identifiant de groupe effectif. C'est ainsi, car à chaque fois  que
       l'identifiant  de  groupe  effectif d'un processus change, le noyau passe l'identifiant de
       groupe du système de fichiers  à  la  valeur  de  l'identifiant  de  groupe  effectif.  Un
       processus  peut  faire  diverger  ses  identifiants  de  groupe  de système de fichiers et
       effectif, en utilisant setfsgid() pour  passer  l'identifiant  de  groupe  du  système  de
       fichiers à la valeur donnée dans fsgid.

       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.

STANDARDS

       Linux.

HISTORIQUE

       Linux 1.2.

   Différences entre bibliothèque C et noyau
       Dans la glibc 2.15 et les versions antérieures, lorsque l'enveloppe de cet  appel  système
       détermine qu'elle ne peut pas passer cet argument au noyau sans tronquer un entier (car le
       noyau est ancien et ne gère pas les identifiants de groupe 32 bits), elle renverra  -1  et
       positionnera errno sur EINVAL sans essayer l'appel système.

NOTES

       Le  concept  d'identifiant  de groupe du système de fichiers et l'appel système setfsgid()
       ont été inventés pour des raisons historiques qui ne  s'appliquent  plus  sur  les  noyaux
       Linux  modernes.  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() originel 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)

TRADUCTION

       La  traduction  française  de  cette  page  de  manuel  a  été créée par Christophe Blaess
       <https://www.blaess.fr/christophe/>, Stéphan  Rafin  <stephan.rafin@laposte.net>,  Thierry
       Vignaud  <tvignaud@mandriva.com>,  François Micaux, Alain Portal <aportal@univ-montp2.fr>,
       Jean-Philippe   Guérard   <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)    <jean-
       luc.coulon@wanadoo.fr>,    Julien    Cristau    <jcristau@debian.org>,    Thomas   Huriaux
       <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
       Duneau  <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis
       Barbier  <barbier@debian.org>,  David  Prévot   <david@tilapin.org>,   Cédric   Boutillier
       <cedric.boutillier@gmail.com>,  Frédéric  Hantrais  <fhantrais@gmail.com> et Jean-Philippe
       MENGUAL <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter  à  la  GNU  General
       Public   License   version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  concernant  les
       conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
       message à ⟨debian-l10n-french@lists.debian.org⟩.