Sous-routine getgroups
Objectif
Obtient l'ID de groupe supplémentaire du processus en cours.
Bibliothèque
Bibliothèque C standard (libc.a)
Syntaxe
Descriptif
La sous-routine getgroups obtient l'ID de groupe supplémentaire du processus. La liste est stockée dans le tableau désigné par le paramètre GIDSet . Le paramètre NGroups indique le nombre d'entrées pouvant être stockées dans ce tableau. La sous-routine getgroups ne renvoie jamais plus d'entrées que le nombre spécifié par la constante NGROUPS_MAX . (La constante NGROUPS_MAX est définie dans le fichier limits.h .) Si la valeur du paramètre NGroups est 0, la sous-routine getgroups renvoie le nombre de groupes du groupe supplémentaire.
Paramètres
| Article | Descriptif |
|---|---|
| GIDSet | Pointe vers le tableau dans lequel est stocké l'ID de groupe supplémentaire du processus de l'utilisateur. |
| NGroupes | Indique le nombre d'entrées pouvant être stockées dans le tableau désigné par le paramètre GIDSet . |
Valeurs renvoyées
Une fois l'opération terminée, la sous-routine getgroups renvoie le nombre d'éléments stockés dans le tableau désigné par le paramètre GIDSet . Si la sous-routine getgroups échoue, la valeur -1 est renvoyée et la variable globale errno est définie pour indiquer l'erreur.
Codes d'erreur
La sous-routine getgroups échoue si l'un des codes d'erreur suivants est vrai:
| Article | Descriptif |
|---|---|
| EFAULT | Les paramètres NGroups et GIDSet spécifient un tableau qui se trouve partiellement ou complètement en dehors de l'espace adresse alloué du processus. |
| EINVAL | Le paramètre NGroups est inférieur au nombre de groupes du groupe supplémentaire. |