unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

GETFAUDITFLAGS(3)          Library Functions Manual          GETFAUDITFLAGS(3)



NAME
       getfauditflags - generates the process audit state

SYNOPSIS
       #include <&lt;sys/types.h>&gt;
       #include <&lt;sys/audit.h>&gt;
       #include <&lt;sys/label.h>&gt;

       void getfauditflags(usremasks, usrdmasks, lastmasks)
       audit_state_t *usremasks;
       audit_state_t *usrdmasks;
       audit_state_t *lastmasks;

DESCRIPTION
       getfauditflags  generates  the  process audit state from the user audit
       value as input to getfauditflags and the system audit value  as  speci-
       fied  in  the  audit_control  file.   getfauditflags obtains the system
       audit value by calling getacflg.  The user audit value, pointed  to  by
       usremasks and usrdmasks is passed into getfauditflags.

       usremasks  points  to  audit_state_t  fields which contains two values.
       The first value defines which events are always to be audited when they
       succeed.   The  second  value  defines  which  events  are always to be
       audited when they fail.

       usrdmasks also points to audit_state_t fields which contains  two  val-
       ues.  The first value defines which events are never to be audited when
       they succeed.  The second value defines which events are  never  to  be
       audited when they fail.

       The  structures  pointed  to by usremasks and usrdmasks may be obtained
       from the passwd.adjunct file by calling  getpwaent()  which  returns  a
       pointer to a strucure containing all passwd.adjunct fields for a user.

       lastmasks  points  to  audit_state_t  as well.  The first value defines
       which events are to be audited when they succeed and the  second  value
       defines which events are to be audited when they fail.

       Both  usremasks  and  usrdmasks override the values in the system audit
       values.

DIAGNOSTICS
       -1 is returned on error and 0 on success.

SEE ALSO
       getauditflags(3), getacinfo(3), audit.log(5), audit_control(5)



                               7 September 1988              GETFAUDITFLAGS(3)