getfauditflags man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

getfauditflags(3BSM)Security and Auditing Library Functiongetfauditflags(3BSM)

NAME
       getfauditflags - generate process audit state

SYNOPSIS
       cc [ flag... ] file... -lbsm   -lsocket	 -lnsl	[ library... ]
       #include <sys/param.h>
       #include <bsm/libbsm.h>

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

DESCRIPTION
       The  getfauditflags()  function generates a process audit state by com‐
       bining the audit masks  passed as  parameters  with  the	 system	 audit
       masks  specified	 in  the  audit_control(4)  file. The getfauditflags()
       function obtains the system audit  value	 by  calling  getacflg()  (see
       getacinfo(3BSM)).

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

       The usrdmasks argument points to au_mask_t  fields  that	 contains  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
       from  the  audit_user(4)	 file  by  calling  getauusernam(3BSM),	 which
       returns a pointer to a strucure containing all audit_user(4) fields for
       a user.

       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 system audit
       values.

RETURN VALUES
       Upon successful completion, getfauditflags() returns  0.	 Otherwise  it
       returns −1.

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

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │MT-Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       bsmconv(1M),  getacinfo(3BSM), getauditflags(3BSM), getauusernam(3BSM),
       audit.log(4), audit_control(4), audit_user(4), attributes(5)

NOTES
       The functionality described on this manual page is  available  only  if
       the Solaris Auditing has been enabled.  See bsmconv(1M) for more infor‐
       mation.

SunOS 5.11			  31 Mar 2005		  getfauditflags(3BSM)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net