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 console apps that
18       do not manipulate accounts or groups. The function  parameters  are  as
19       follows:
20
21       audit_fd - The fd returned by audit_open
22       type - type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGIN
23       message - the message text being sent
24       hostname - the hostname if known, NULL if unknown
25       addr - The network address of the user, NULL if unknown
26       tty - The tty of the user, if NULL will attempt to figure out
27       result - 1 is "success" and 0 is "failed"
28
29

RETURN VALUE

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

ERRORS

36       This function returns -1 on failure. Examine errno for more info.
37
38

SEE ALSO

40       audit_log_user_comm_message(3),              audit_log_acct_message(3),
41       audit_log_user_avc_message(3), audit_log_semanage_message(3).
42
43

AUTHOR

45       Steve Grubb
46
47
48
49Red Hat                            Oct 2006          AUDIT_LOG_USER_MESSAGE(3)