1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright 1993 Rickard E. Faith (faith@cs.unc.edu)
.\"
.\" Traduction 10/10/1996 Christophe BLAESS (ccb@club-internet.fr)
.\" Mise jour 25/04/98 (LDP-man-pages-1.19)
.\"
.TH GETGROUPS 2 "25 Avril 1998" "Linux" "Manuel du programmeur Linux"
.SH NOM
getgroups, setgroups \- Lire/crire la liste des groupes supplmentaires d'un processus.
.SH SYNOPSIS
.B #include <unistd.h>
.sp
.BI "int getgroups(int " size ", gid_t " list []);
.sp 2
.B #define __USE_BSD
.br
.B #include <grp.h>
.sp
.BI "int setgroups(size_t " size ", const gid_t *" list );
.SH DESCRIPTION
.TP
.B getgroups
retourne une liste
.IR list
contenant jusqu'a
.I size
groupes aditionnels.
Si
.I size
vaut zro,
.I list
n'est pas modifie, mais le nombre total de groupes supplmentaires
pour le processus est renvoy.
.TP
.B setgroups
fixe des groupes supplmentaires pour le processus. Seul le Super\-User peut
utiliser cette fonction.
.SH "VALEUR RENVOYE"
.TP
.B getgroups
renvoie le nombre de groupes supplmentaires du processus
s'il reussit, ou \-1 s'il choue, auquel cas
.I errno
contient le code d'erreur.
.TP
.B setgroups
renvoie 0 s'il reussit, ou \-1 s'il choue, auquel cas
.I errno
contient le code d'erreur.
.SH ERREURS
.TP
.B EFAULT
.I list
pointe en dehors de l'espace d'adressage accessible.
.TP
.B EPERM
Pour
.BR setgroups ,
l'utilisateur n'est pas le Super\-User.
.TP
.B EINVAL
Pour
.BR setgroups ,
.I size
est plus grand que
.B NGROUPS
(32 avec Linux 2.0.32).
Pour
.BR getgroups ,
.I size
est infrieur au nombre de groupes supplmentaires, et n'est pas nul.
.SH "CONFORMIT"
SVr4, SVID (version 4 uniquement), X/OPEN, 4.3BSD.
.B getgroups
est conforme a POSIX.1 (et prsent dans BSD 4.3). Comme
.B setgroups
ncessite des privilges, il n'est pas couvert par POSIX.1.
.SH BUGS
La constante symbolique
.B __USE_BSD
ne devrait probablement pas tre ncessaire pour utiliser
.BR setgroups .
.SH "VOIR AUSSI"
.BR initgroups (3),
.BR getgid (2),
.BR setgid (2)
.SH TRADUCTION
Christophe Blaess, 1997.
|
