Manual Pages for UNIX Operating System command usage for man getfauditflags

Security and Auditing Library Functions      getfauditflags(3BSM)



NAME
     getfauditflags - generate process audit state

SYNOPSIS
     cc [ flag... ] file... -lbsm   -lsocket   -lnsl  [ library... ]
     #include 
     #include 

     int getfauditflags(au_mask_t *usremasks, au_mask_t *usrdmasks,
          au_mask_t *lastmasks);


DESCRIPTION
     The getfauditflags()  function  generates  a  process  audit
     state  by  combining  the  audit masks  passed as parameters
     with the user default audit mask gained from the kernel. See
     the  -setflags  option  of  the  auditconfig(1M) utility for
     information about how to set the mask.


     The usremasks argument points to au_mask_t fields that  con-
     tains  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.


     The usrdmasks argument points to au_mask_t fields that  con-
     tains  two values.  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 can  be
     obtained  by  calling getauditflagsbin(3BSM) with the values
     of the  audit_flags  keyword  for  a  user's  entry  in  the
     user_attr(4) database.


     The output of  this  function  is  stored  in  lastmasks,  a
     pointer  of  type au_mask_t as well. The first value defines
     which events are to be audited when  they  succeed  and  the
     second  defines  which  events  are  to be audited when they
     fail.


     Both usremasks and usrdmasks override the values in the sys-
     tem audit values.

RETURN VALUES
     Upon successful completion, getfauditflags() returns 0. Oth-
     erwise it returns -1.



SunOS 5.11          Last change: 22 Jun 2010                    1






Security and Auditing Library Functions      getfauditflags(3BSM)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     auditconfig(1M),     getauditflags(3BSM),      audit.log(4),
     user_attr(4), attributes(5), audit_flags(5)







































SunOS 5.11          Last change: 22 Jun 2010                    2