Security and Auditing Library Functions       getauditflags(3BSM)

NAME
     getauditflags, getauditflagsbin, getauditflagschar - convert
     audit flag specifications

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

     int getauditflagsbin(char *auditstring, au_mask_t *masks);

     int getauditflagschar(char *auditstring,  au_mask_t  *masks,
     int verbose);

DESCRIPTION
     getauditflagsbin() converts the character representation  of
     audit values pointed to by auditstring into au_mask_t fields
     pointed to by masks. These fields indicate which events  are
     to  be audited when they succeed and which are to be audited
     when they fail. The character string syntax is described  in
     audit_control(4).

     getauditflagschar() converts the au_mask_t fields pointed to
     by  masks  into a string pointed to by auditstring.  If ver-
     bose is zero, the short (2-character) flag names  are  used.
     If verbose is non-zero, the long flag names are used. audit-
     string should be large enough to contain the ASCII represen-
     tation of the events.

     auditstring contains a series of event names, each one iden-
     tifying  a  single  audit  class,  separated by commas.  The
     au_mask_t fields pointed to by masks  correspond  to  binary
     values   defined   in   <bsm/audit.h>,   which  is  read  by
     <bsm/libbsm.h>.

RETURN VALUES
     getauditflagsbin() and getauditflagschar(): -1  is  returned
     on error and 0 on success.

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

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

SEE ALSO

SunOS 5.8           Last change: 29 Dec 1996                    1

Security and Auditing Library Functions       getauditflags(3BSM)

     bsmconv(1M), audit.log(4), audit_control(4), attributes(5)

BUGS
     This is not a very extensible interface.

NOTES
     The functionality described in this man  page  is  available
     only  if  the  Basic Security Module (BSM) has been enabled.
     See bsmconv(1M) for more information.

SunOS 5.8           Last change: 29 Dec 1996                    2