1getauditflags(3BSM) Security and Auditing Library Functionsgetauditflags(3BSM)
2
3
4
6 getauditflags, getauditflagsbin, getauditflagschar - convert audit flag
7 specifications
8
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
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
41 Upon successful completion, getauditflagsbin() and getauditflagschar()
42 return 0. Otherwise they return −1.
43
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
57 bsmconv(1M), audit.log(4), audit_control(4), attributes(5)
58
60 This is not a very extensible interface.
61
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)