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.25  Psetgroups                                                TOS

 Name:         »Psetgroups« - Sets the supplementary group IDs for the 
               calling process.

 Opcode:       328 (0x0148)

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

 Description:  The function Psetgroups sets the supplementary group 
               IDs for the calling process.

               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.

               Setting new supplementary group IDs needs root 
               privileges.

               The NGROUPS_MAX value is returned by Sysconf().

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

 Availability: Available from MiNT 1.11 onwards.

 Group:        Process functions

 See also:     Binding   Pgetgroups   Sysconf