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

Syntax

LONG Psetreuid( ruid, euid )
WORD ruid;
WORD euid;

Function      Psetreuid() sets the real and/or effective user id for the
              calling process.

Opcode        334 (0x014e)

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

Parameters    ruid specifies the new real user id and euid specifies
              the new effective user id for the calling process. If either
              argument is -1, only the other gets changed.

Binding       move.w  euid,-(sp)
              move.w  ruid,-(sp)
              move.w  #$014e,-(sp)
              trap    #1
              addq.l  #6,sp

Return Value  Psetreuid() returns E_OK on success or a negative GEMDOS
              error code otherwise.

Caveats       Setting user ids needs root privileges.

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

See Also      Psetregid(), Pseteuid()