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()
Pgetauid()
Psetuid()
Psetreuid()
Psetauid()                                                           GEMDOS

Syntax

LONG Psetauid( auid )
WORD auid;

Function      Psetauid() sets the audit user id for the calling process.

Opcode        326 (0x0146)

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

Parameters    auid specifies the new audit user id for the calling process.

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

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

Comments      Audit id never changes once set to != 0 (because Psetauid()
              only allows to change the id when it is equal to 0) and can
              therefore be used to determine who the initially logged in
              user was.

See Also      Pseteuid(), Pgetauid(), Psetuid(), Psetreuid()