1AUDIT_LOG_USER_MESSAGE(3)       Linux Audit API      AUDIT_LOG_USER_MESSAGE(3)
2
3
4

NAME

6       audit_log_user_message - log a general user message
7

SYNOPSIS

9       #include <libaudit.h>
10
11       int audit_log_user_message(int audit_fd, int type, const char *message,
12       const char *hostname, const char *addr, const char *tty, int result)
13
14

DESCRIPTION

16       This function will log a message to the audit system using a predefined
17       message  format.  This  function should be used by all ELF console apps
18       that do not manipulate accounts or groups. If the application is  writ‐
19       ten    in    Python    or    another    interpreter,   then   use   the
20       audit_log_user_comm_message function instead. The  function  parameters
21       are as follows:
22
23       audit_fd - The fd returned by audit_open
24       type - type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGIN
25       message - the message text being sent
26       hostname - the hostname if known, NULL if unknown
27       addr - The network address of the user, NULL if unknown
28       tty - The tty of the user, if NULL will attempt to figure out
29       result - 1 is "success" and 0 is "failed"
30
31

RETURN VALUE

33       It  returns  the  sequence  number  which  is > 0 on success or <= 0 on
34       error.
35
36

ERRORS

38       This function returns -1 on failure. Examine errno for more info.
39
40

SEE ALSO

42       audit_log_user_comm_message(3),              audit_log_acct_message(3),
43       audit_log_user_avc_message(3), audit_log_semanage_message(3).
44
45

AUTHOR

47       Steve Grubb
48
49
50
51Red Hat                            July 2016         AUDIT_LOG_USER_MESSAGE(3)