summaryrefslogtreecommitdiff
path: root/reference/C/MAN/getgroupd.htm
blob: e6cd339aba52c16bc5bf453c0b1c9c8a2c636fc0 (plain)
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
<TITLE>getgroups</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>



<h3>GETGROUPS(2)        Linux Programmer's Manual        GETGROUPS(2)
</h3>

<h3>NAME
</h3>       getgroups, setgroups - get/set group access list

<h3>SYNOPSIS
</h3>       #include &lt;unistd.h&gt;

       int getgroups(int size, gid_t list[]);


       #define __USE_BSD
       #include &lt;grp.h&gt;

       int setgroups(size_t size, const gid_t *list);

<h3>DESCRIPTION
</h3>       getgroups
              Up  to  size  supplemental  groups  are returned in
              list.  If size is zero, list is not  modified,  but
              the  total  number  of  supplemental groups for the
              process is returned.

       setgroups
              Sets the supplemental groups for the process.  Only
              the super-user may use this function.

<h3>RETURN VALUE
</h3>       getgroups
              On  success, the number of groups stored in list is
              returned (if size is zero, however, the  number  of
              supplemental  group IDs associated with the process
              is returned).  On error, -1 is returned, and  errno
              is set appropriately.

       setgroups
              On  success,  zero  is  returned.   On error, -1 is
              returned, and errno is set appropriately.

<h3>ERRORS
</h3>       EFAULT list has an invalid address.

       EPERM  For setgroups, the user is not the super-user.

       EINVAL For setgroups, gidsetsize is greater  than  NGROUPS
              (32 for Linux 0.99.11).

<h3>CONFORMING TO
</h3>       getgroups conforms to POSIX.1 (and is present in BSD 4.3).
       Since setgroups requires  privilege,  it  is  not  covered
       under POSIX.1.

<h3>BUGS
</h3>       The __USE_BSD flag probably shouldn't be required for set-
       groups.




<h3>Linux 0.99.11              23 July 1993                         1
</h3>




<h3>GETGROUPS(2)        Linux Programmer's Manual        GETGROUPS(2)
</h3>

</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=initgroups.htm>initgroups</a>, 
<pre>























































<h3>Linux 0.99.11              23 July 1993                         2
</h3>


</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>

This manual page was brought to you by <i>mjl_man V-2.0</i>