1getauditflags(3BSM) Security and Auditing Library Functionsgetauditflags(3BSM)
2
3
4

NAME

6       getauditflags, getauditflagsbin, getauditflagschar - convert audit flag
7       specifications
8

SYNOPSIS

10       cc [ flag... ] file... -lbsm  -lsocket    -lnsl   [ library... ]
11       #include <sys/param.h>
12       #include <bsm/libbsm.h>
13
14       int getauditflagsbin(char *auditstring, au_mask_t *masks);
15
16
17       int getauditflagschar(char *auditstring, au_mask_t *masks, int verbose);
18
19

DESCRIPTION

21       The getauditflagsbin() function converts the  character  representation
22       of audit values pointed to by auditstring into au_mask_t fields pointed
23       to by masks. These fields indicate which events are to be audited  when
24       they  succeed and which are to be audited when they fail. The character
25       string syntax is described in audit_control(4).
26
27
28       The getauditflagschar() function converts the au_mask_t fields  pointed
29       to  by  masks into a string pointed to by auditstring. If verbose is 0,
30       the short (2-character) flag names are used. If  verbose  is  non-zero,
31       the  long flag names are used. The auditstring argument should be large
32       enough to contain the ASCII representation of the events.
33
34
35       The auditstring argument contains a series of  event  names,  each  one
36       identifying  a  single audit class, separated by commas.  The au_mask_t
37       fields pointed to by masks  correspond  to  binary  values  defined  in
38       <bsm/audit.h>, which is read by  <bsm/libbsm.h>.
39

RETURN VALUES

41       Upon  successful completion, getauditflagsbin() and getauditflagschar()
42       return 0. Otherwise they return −1.
43

ATTRIBUTES

45       See attributes(5) for descriptions of the following attributes:
46
47
48
49
50       ┌─────────────────────────────┬─────────────────────────────┐
51       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
52       ├─────────────────────────────┼─────────────────────────────┤
53       │MT-Level                     │MT-Safe                      │
54       └─────────────────────────────┴─────────────────────────────┘
55

SEE ALSO

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

BUGS

60       This is not a very extensible interface.
61

NOTES

63       The functionality described on this manual page is  available  only  if
64       the Solaris Auditing has been enabled.  See bsmconv(1M) for more infor‐
65       mation.
66
67
68
69SunOS 5.11                        31 Mar 2005              getauditflags(3BSM)
Impressum