Debian Codegraph @

upstream/debian-unstable/man3/audit_log_user_message.3

raw
1 .TH "AUDIT_LOG_USER_MESSAGE" "3" "July 2016" "Red Hat" "Linux Audit API"
2 .SH NAME
3 audit_log_user_message \- log a general user message
4 .SH SYNOPSIS
5 .nf
6 .B #include <libaudit.h>
7 .PP
8 .BI "int audit_log_user_message(int " audit_fd ", int " type ", const char *" message ", const char *" hostname ", const char *" addr ", const char *" tty ", int " result )"
9 .fi
10
11 .SH DESCRIPTION
12 This function will log a message to the audit system using a predefined message format. This function should be used by all ELF console apps that do not manipulate accounts or groups. If the application is written in Python or another interpreter, then use the
13 .I audit_log_user_comm_message
14 function instead. The function parameters are as follows:
15
16 .nf
17 \fIaudit_fd\fP - The fd returned by audit_open
18 \fItype\fP - type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGIN
19 \fImessage\fP - the message text being sent
20 \fIhostname\fP - the hostname if known, NULL if unknown
21 \fIaddr\fP - The network address of the user, NULL if unknown
22 \fItty\fP - The tty of the user, if NULL will attempt to figure out
23 \fIresult\fP - 1 is "success" and 0 is "failed"
24 .fi
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_comm_message (3),
37 .BR audit_log_acct_message (3),
38 .BR audit_log_user_avc_message (3),
39 .BR audit_log_semanage_message (3).
40
41 .SH AUTHOR
42 Steve Grubb