Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FilePgetgroups()
Sysconf()
Psetgroups()                                                         GEMDOS

Syntax

LONG Psetgroups( len, gidset )
WORD len;
WORD *gidset;

Function      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()