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-FilePsetegid()
Psetuid()
Psetreuid()
Pseteuid()                                                           GEMDOS

Syntax

LONG Pseteuid( euid )
WORD euid;

Function      Pseteuid() sets the effective user id for the calling process.

Opcode        323 (0x0143)

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

Parameters    euid specifies the new effective user id for the calling
              process.

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

Return Value  Pseteuid() returns new euid 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 user id needs root privileges.

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

See Also      Psetegid(), Psetuid(), Psetreuid()