LONG Psetgroups(len, gidset)
WORD len;
WORD *gidset;
| Psetgroups() sets the supplementary group ids for the calling process. | |
| Opcode | 328 (0x0148) |
| Availability | Available when a 'MiNT' cookie with a version of at least 1.11 exists. |
| Parameters | len specifies the length (in
words) of the array containing the supplementary group ids to be
set. This value must be a positive number not greater than
NGROUPS_MAX. If len is a zero, the call will return the
number of supplementary group ids those have been set.
gidset is a pointer to a word array containing the new supplementary group ids for the process. |
| Binding |
pea gidset move.w len,-(sp) move.w #$0148,-(sp) trap #1 addq.l #8,sp |
| Return Value | Psetgroups() returns a number of new supplementary group ids for the process on success or a negative GEMDOS error code otherwise. |
| Caveats | Setting new supplementary group ids needs root privileges. |
| Comments | The NGROUPS_MAX value is returned by Sysconf(). |
| See Also | Pgetgroups(), Sysconf() |