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-FilePgetgid()
Psetgid()                                                            GEMDOS

Syntax

WORD Psetgid( gid )
WORD gid;

Function      Psetgid() sets the group ID of the calling process.

Opcode        277 (0x115)

Availability  This function is available under all MiNT versions
              integrated with MultiTOS.

Parameters    gid is the group ID code to assign the calling process
              (0-255).

Binding       move.w   gid,-(sp)
              move.w   #$115,-(sp)
              trap     #1
              addq.l   #4,sp

Return Value  Psetgid() returns gid if successful or EACCDN (-36) if the
              process did not have the authority to change the group ID.

Comments      The group ID of a process may only be changed when it is
              currently 0. Therefore, once the group ID has been set, it
              is fixed and unchangeable. Further attempts to modify it
              will result in an EACCDN error.

See Also      Pgetgid()