table of contents
other sections
GETGROUPS(2) | Manuel du programmeur Linux | GETGROUPS(2) |
NOM¶
getgroups, setgroups - Lire et écrire la liste des groupes supplémentaires d'un processusSYNOPSIS¶
#include <sys/types.h>Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :
DESCRIPTION¶
getgroups() renvoie dans la liste list les identifiants des groupes additionnels du processus appelant. Le paramètre size doit indiquer le nombre maximal d'éléments qui peuvent être stockés dans le tampon pointé par list. Si le processus appelant a plus que size groupes additionnels, cela génère une erreur. Il n'est pas spécifié si l'identifiant du groupe effectif du processus appelant est inclus dans la liste renvoyée (ainsi une application devrait également appeler getegid(2) et ajouter ou supprimer la valeur résultante).VALEUR RENVOYÉE¶
En cas de succès, getgroups() renvoie le nombre d'identifiants de groupes additionnels. En cas d'erreur, -1 est renvoyé et errno contient le code d'erreur.ERREURS¶
- EFAULT
- list pointe en dehors de l'espace d'adressage accessible.
- EINVAL
- size est inférieur au nombre d'identifiants de groupes additionnels, et n'est pas nul.
- EINVAL
- size est plus grand que NGROUPS_MAX (32 avant Linux 2.6.4 ; 65536 depuis Linux 2.6.4).
- ENOMEM
- Plus de mémoire disponible.
- EPERM
- L'appelant n'a pas les privilèges nécessaires.
CONFORMITɶ
SVr4, BSD 4.3. getgroups() est conforme à POSIX.1-2001. Comme setgroups() nécessite des privilèges, il n'est pas couvert par POSIX.1-2001.NOTES¶
Un processus peut avoir jusqu'à NGROUPS_MAX identifiants de groupes additionnels en plus de son identifiant de groupe effectif. Le jeu d'identifiants de groupes additionnels est hérité du processus parent, et est préservé au travers des appels à execve(2).long ngroups_max; ngroups_max = sysconf(_SC_NGROUPS_MAX);La valeur de retour maximale de getgroups() ne peut pas être plus grande que 1 plus cette valeur.
VOIR AUSSI¶
getgid(2), setgid(2), getgrouplist(3), initgroups(3), capabilities(7), credentials(7)COLOPHON¶
Cette page fait partie de la publication 3.44 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <http://www.kernel.org/doc/man-pages/>.TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>. Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Julien Cristau et l'équipe francophone de traduction de Debian (2006-2009). Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet manpages-fr. Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».22 novembre 2010 | Linux |