Sous-routine initgroups

Editer en ligne

Objectif

Initialise l'ID de groupe supplémentaire.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

int initgroups ( User,  BaseGID)
const char *User;
int BaseGID;

Descriptif

Attention: La sous-routine initgroups utilise la famille de sous-routines getgrent et getpwent . Si le programme qui appelle la sous-routine initgroups utilise l'une de ces sous-routines, l'appel de la sous-routine initgroups écrase les zones de mémoire statique utilisées par ces sous-routines.

La sous-routine initgroups lit l'appartenance à un groupe définie du paramètre User spécifié et définit l'ID de groupe supplémentaire du processus en cours sur cette valeur. Le paramètre BaseGID est toujours inclus dans l'ID de groupe supplémentaire. Le groupe supplémentaire est normalement le groupe de l'utilisateur principal. Si l'utilisateur appartient à plusieurs groupes NGROUPS_MAX , définis dans le fichier limits.h , seuls les groupes NGROUPS_MAX sont définis, y compris le groupe BaseGID .

Paramètres

Article Descriptif
Utilisateur Identifie un utilisateur.
BaseGID Indique un groupe supplémentaire à inclure dans l'ensemble de groupes.

Valeurs renvoyées

Article Descriptif
0 % Indique que la sous-routine a abouti.
-1 Indique que la sous-routine a échoué. La variable globale errno est définie pour indiquer l'erreur.