---
name: "audit_log_user_message"
section: "3"
platform: "linux"
package: "audit"
version: "4.2.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/audit_log_user_message"
---

# audit\_log\_user\_message(3)

log a general user message

## NAME

audit\_log\_user\_message - log a general user message

## SYNOPSIS

```
#include <libaudit.h>
```

**int audit\_log\_user\_message(int** *audit\_fd***, int** *type***, const char \****message***, const char \****hostname***, const char \****addr***, const char \****tty***, int** *result***)"**

## DESCRIPTION

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 *audit\_log\_user\_comm\_message* function instead. The function parameters are as follows:

```
audit_fd - The fd returned by audit_open
type - type of message, ex: AUDIT_USYS_CONFIG, AUDIT_USER_LOGIN
message - the message text being sent
hostname - the hostname if known, NULL if unknown
addr - The network address of the user, NULL if unknown
tty - The tty of the user, if NULL will attempt to figure out
result - 1 is "success" and 0 is "failed"
```

## RETURN VALUE

It returns the sequence number which is \> 0 on success or \<= 0 on error.

## ERRORS

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

## SEE ALSO

[**audit\_log\_user\_comm\_message**(3)](/audit_log_user_comm_message/3.md), [**audit\_log\_acct\_message**(3)](/audit_log_acct_message/3.md), [**audit\_log\_user\_avc\_message**(3)](/audit_log_user_avc_message/3.md), [**audit\_log\_semanage\_message**(3)](/audit_log_semanage_message/3.md).

## AUTHOR

Steve Grubb