Debian Codegraph @

upstream/debian-trixie/man3/audit_log_user_avc_message.3

raw
1 .TH "AUDIT_LOG_USER_AVC_MESSAGE" "3" "Oct 2006" "Red Hat" "Linux Audit API"
2 .SH NAME
3 audit_log_user_avc_message \- log a user avc message
4 .SH SYNOPSIS
5 .B #include <libaudit.h>
6 .sp
7 .B int audit_log_user_avc_message(int audit_fd, int type, const char *message,
8 const char *hostname, const char *addr, const char *tty, uid_t auid)
9
10 .SH DESCRIPTION
11
12 This function will log a message to the audit system using a predefined message format. This function should be used by all apps that are SE Linux object managers. The function parameters are as follows:
13
14 .nf
15 audit_fd - The fd returned by audit_open
16 type - type of message, ex: AUDIT_USER_AVC
17 message - the message being sent
18 hostname - the hostname if known
19 addr - The network address of the user
20 tty - The tty of the user, if NULL will attempt to figure out
21 auid - The auid of the person related to the avc message
22 .fi
23
24 These values should correspond to who the message is about.
25
26 .SH "RETURN VALUE"
27
28 It returns the sequence number which is > 0 on success or <= 0 on error.
29
30 .SH "ERRORS"
31
32 This function returns \-1 on failure. Examine errno for more info.
33
34 .SH "SEE ALSO"
35
36 .BR audit_log_user_message (3),
37 .BR audit_log_acct_message (3),
38 .BR audit_log_user_comm_message (3),
39 .BR audit_log_semanage_message (3).
40
41 .SH AUTHOR
42 Steve Grubb