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

setaudid(2) setaudid(2)

(TO BE OBSOLETED)

NAME

setaudid() - set the audit ID (aid) for the current process

SYNOPSIS

#include <sys/audit.h>

int setaudid(aid_t

audid);

Remarks

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

setauduser() instead. See setauduser(3).

DESCRIPTION

setaudid() sets the audit ID (aid) in the audit tag for the current process. This call is restricted to a

user 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 will 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,

setaudid() returns a value of 0; otherwise, it returns −1 and sets

errno

to indicate the error.

ERRORS

setaudid() fails if any of the following conditions are encountered:

[EPERM] The caller is not a user with the SEFLAUDIT privilege.

[EINVAL] The audit ID (audid) is invalid.

AUTHOR

setaudid() was developed by HP.