Imported Upstream version 2.4.3
[platform/upstream/audit.git] / docs / audit_log_user_avc_message.3
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 uid)
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 uid - The auid of the person related to the avc message
22 .fi
23
24 .SH "RETURN VALUE"
25
26 It returns the sequence number which is > 0 on success or <= 0 on error.
27
28 .SH "ERRORS"
29
30 This function returns \-1 on failure. Examine errno for more info.
31
32 .SH "SEE ALSO"
33
34 .BR audit_log_user_message (3),
35 .BR audit_log_acct_message (3),
36 .BR audit_log_user_avc_message (3),
37 .BR audit_log_semanage_message (3).
38
39 .SH AUTHOR
40 Steve Grubb