SETRESUID

Section: Manuel du programmeur Linux (2)
Updated: 30 juillet 2003
Index


NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
HISTORIQUE
NOTES
VOIR AUSSI
TRADUCTION

NOM

setresuid, setresgid - Fixer les UIDs ou les GIDs réels, effectifs et sauvés.

SYNOPSIS

#define _GNU_SOURCE
#include <unistd.h>
int setresuid(uid_t ruid, uid_t euid, uid_t suid);
int setresgid(gid_t rgid, gid_t egid, gid_t sgid);

DESCRIPTION

setresuid fixe les UIDs réel, effectif et sauvé du processus apppelant.
Un processus utilisateur non-privilégié (dont les UID réel, effectif et sauvé sont tous non-nuls) peut fixer son UID réel et son UID sauvé avec sa valeur d'UID actuel, d'UID effectif actuel, ou d'UID sauvé.
Le Super-Utilisateur peut positionner son UID réel, effectif ou sauvé à une valeur quelconque.
Si l'un des paramètres vaut -1, la valeur correspondante n'est pas modifiée.
De manière analogue setresgid fixe les GIDs réel, effectif et sauvé du processus appelant avec les mêmes restrictions pour les processus n'ayant aucun GID nul.

VALEUR RENVOYÉE

Les appels setresuid et setresgid renvoient 0 s'ils réussissent, ou -1 s'ils échouent auquel cas errno contient le code d'erreur.

ERREURS

EPERM
Le processus n'a pas de privilèges et essaye de modifier ses IDs de manière interdite.

CONFORMITÉ

Cet appel-système n'est pas standard.

HISTORIQUE

Cet appel-système a d'abord été introduit dans HP-UX. Il est disponible sous Linux depuis le noyau 2.1.44. A présent, on le rencontre également dans FreeBSD (pour l'émulation binaire de Linux).

NOTES

Sous HP-UX et FreeBSD, le prototype se trouve dans <unistd.h>. Sous Linux, le prototype est fourni pas la GlibC depuis la version 2.3.2 à condition que la constante _GNU_SOURCE soit définie. Sous Linux, il n'y a pas encore de fichier d'en-tête incluant ce prototype, ce qui peut être considéré comme un défaut de la GlibC. Les programmes utilisant cet appel-système doivent en déclarer le prototype eux-mêmes.

VOIR AUSSI

getuid(2), setuid(2), setreuid(2), getresuid(2)

TRADUCTION

Christophe Blaess, 1996-2003.