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-FilePseteuid()
Psetgid()
Psetregid()
Psetegid()                                                           GEMDOS

Syntax

LONG Psetegid( egid )
WORD egid;

Function      Psetegid() sets the effective group id for the calling process.

Opcode        324 (0x0144)

Availability  Available when a 'MiNT' cookie with a version of at least
              1.11 exists.

Parameters    egid specifies the new effective group id for the
              calling process.

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

Return Value  Psetegid() returns new egid on success or a negative GEMDOS
              error code otherwise.

Caveats       Prior to MiNT version 1.12 this call contained a bug affecting
              its functionality.

              Setting effective group id needs root privileges.

Comments      This call is often used by daemon processes to downgrade their
              privileges to user level.

See Also      Pseteuid(), Psetgid(), Psetregid()