HP-UX Reference (11i v3 07/02) - 2 System Calls (vol 5)

getaudid(2) getaudid(2)

(TO BE OBSOLETED)

NAME

getaudid() - get the audit ID (aid) for the current process

SYNOPSIS

#include <sys/audit.h>

int getaudid(void);

Remarks

This function is provided purely for backward compatibility. HP recommends that new applications use

getauduser() instead. See getauduser(3).

DESCRIPTION

getaudid() returns the audit ID (aid) for the current process. This call is restricted to users with the

SELFAUDIT privilege.

Security Restrictions

Some or all of the actions associated with this system call require the

SELFAUDIT privilege. Processes

owned by the superuser have this privilege. Processes owned by other users may have this privilege,

depending on system conﬁguration. See privileges (5) for more information about privileged access on sys-

tems that support ﬁne-grained privileges.

RETURN VALUE

Upon successful completion, the audit ID is returned; otherwise, a

-1 is returned.

ERRORS

getaudid() fails if the following is true:

[EPERM] The caller does not have the SELFAUDIT privilege.

AUTHOR

getaudid() was developed by HP.