Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.12.9  Pgetgroups                                                 TOS

 Name:         »Pgetgroups« - Gets the supplementary group IDs for the 
               calling process.

 Opcode:       327 (0x0147)

 Syntax:       int32_t Pgetgroups( int16_t len, int16_t *gidset);

 Description:  The function Pgetgroups obtains the supplementary group 
               IDs for the calling process.

               len specifies the length (in words) of the array to be 
               filled with the supplementary group IDs available. 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 currently available 
               for the calling process.

               gidset is a pointer to a word array to be filled with 
               retrieved ids.

               The NGROUPS_MAX value is returned by Sysconf().

 Return value: Returns a number of supplementary group IDs for the 
               process on success or a negative GEMDOS error code 
               otherwise.

 Availability: This function is available from MiNT 1.11 onwards.

 Group:        Process functions

 See also:     Binding   Psetgroups   Sysconf