setgid(2)                     System Calls Manual                    setgid(2)

NOM
       setgid - Definir l'identifiant de groupe

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <unistd.h>

       int setgid(gid_t gid);

DESCRIPTION
       setgid() definit le GID effectif du processus appelant. Si l'appelant
       est privilegie (plus precisement, s'il a la capacite CAP_SETGID dans
       son espace de noms), les GID reel et sauve sont egalement definis.

       Sous Linux setgid() est implemente comme la version POSIX avec l'option
       _POSIX_SAVED_IDS. Cela permet a un programme Set-GID (autre que root)
       d'abandonner tous ses privileges de groupe, d'effectuer des taches non
       privilegiees, et de retrouver son GID effectif de maniere securisee.

VALEUR RENVOYEE
       En cas de succes, zero est renvoye. En cas d'erreur, -1 est renvoye et
       errno est definie pour preciser l'erreur.

ERREURS
       EINVAL L'identifiant de groupe indique dans gid n'est pas valable dans
              cet espace de noms utilisateur.

       EPERM  Le processus appelant n'est pas privilegie (ne possede pas la
              capacite CAP_SETGID dans son espace de noms) et gid ne
              correspond ni au GID reel, ni au GID sauve du processus
              appelant.

VERSIONS
   Differences entre bibliotheque C et noyau
       Au niveau du noyau, les identifiants utilisateur et de groupe
       representent un attribut par thread. Cependant, POSIX exige que tous
       les threads d'un processus partagent les memes droits. L'implementation
       de thread de NPTL gere les exigences de POSIX a l'aide de fonctions
       enveloppes autour des appels systeme qui modifient les UID et les GID
       du processus. Ces fonctions enveloppe (notamment celle autour de
       setgid()) utilisent une technique fondee sur le signal pour s'assurer
       que lorsqu'un thread modifie les droits, tous les autres threads du
       processus changent leurs autorisations. Pour des details, voir nptl(7).

STANDARDS
       POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, SVr4.

       L'appel systeme setgid() originel de Linux ne gerait que des
       identifiants de groupe sur 16 bits. En consequence, Linux 2.4 a ajoute
       setgid32() qui prend en charge des identifiants 32 bits. La fonction
       setgid() de la glibc qui l'encapsule gere de maniere transparente ces
       differences entre noyaux.

VOIR AUSSI
       getgid(2), setegid(2), setregid(2), capabilities(7), credentials(7),
       user_namespaces(7)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Cedric Boutillier <cedric.boutillier@gmail.com>,
       Frederic Hantrais <fhantrais@gmail.com> et Jean-Philippe MENGUAL
       <jpmengual@debian.org>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       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 RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                      setgid(2)