setgid - Définir l'identifiant de groupe
Bibliothèque C standard (
libc,
-lc)
#include <unistd.h>
int setgid(gid_t gid);
setgid() définit le GID effectif du processus appelant. Si
l'appelant est privilégié (plus précisément, s'il
a la capacité
CAP_SETGID dans son espace de noms), les GID
réel et sauvé sont également définis.
Sous Linux
setgid() est implémenté comme la version POSIX
avec l'option
_POSIX_SAVED_IDS. Cela permet à un programme
Set-GID (autre que root) d'abandonner tous ses privilèges de groupe,
d'effectuer des tâches non privilégiées, et de retrouver
son GID effectif de manière sécurisée.
En cas de succès, zéro est renvoyé. En cas d'erreur,
-1 est renvoyé et
errno est définie pour
préciser l'erreur.
- EINVAL
- L'identifiant de groupe indiqué dans gid
n'est pas valable dans cet espace de noms utilisateur.
- EPERM
- Le processus appelant n'est pas privilégié
(ne possède pas la capacité CAP_SETGID dans son
espace de noms) et gid ne correspond ni au GID réel, ni au
GID sauvé du processus appelant.
POSIX.1-2001, POSIX.1-2008, SVr4.
L'appel système
setgid() originel de Linux ne gérait que
des identifiants de groupe sur 16 bits. En conséquence,
Linux 2.4 a ajouté
setgid32() qui prend en charge des
identifiants 32 bits. La fonction
setgid() de la glibc qui
l'encapsule gère de manière transparente ces différences
entre noyaux.
Au niveau du noyau, les identifiants utilisateur et de groupe
représentent un attribut par thread. Cependant, POSIX exige que tous
les threads d'un processus partagent les mêmes droits.
L'implémentation de thread de NPTL gère les exigences de POSIX
à l'aide de fonctions enveloppes autour des appels système qui
modifient les UID et les GID du processus. Ces fonctions enveloppe (notamment
celle autour de
setgid()) utilisent une technique fondée sur le
signal pour s'assurer que lorsqu'un thread modifie les droits, tous les autres
threads du processus changent leurs autorisations. Pour des détails,
voir
nptl(7).
getgid(2),
setegid(2),
setregid(2),
capabilities(7),
credentials(7),
user_namespaces(7)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]>,
Cédric Boutillier <
[email protected]>,
Frédéric Hantrais <
[email protected]> et Jean-Philippe
MENGUAL <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 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 à
[email protected]