audit_set_enabled(3)

audit_set_enabled3

Enable or disable auditing

Usage

#include <libaudit.h>

int audit_set_enabled(intfd,uint32_t"enabled);"

Overview

audit_set_enabled is used to control whether or not the audit system is active. When the audit system is enabled (enabled set to 1), every syscall will pass through the audit system to collect information and potentially trigger an event.

If the audit system is disabled (enabled set to 0), syscalls do not enter the audit system and no data is collected. There may be some events generated by MAC subsystems like SE Linux even though the audit system is disabled. It is possible to suppress those events, too, by adding an audit rule with flags set to AUDIT_FILTER_EXCLUDE

Return value

The return value is <= 0 on error, otherwise it is the netlink sequence id number. This function can have any error that sendto would encounter.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 3 times.

  1. 5.0–9
  2. 10–11
  3. 12–13
  4. Arch

Author

Steve Grubb

From audit 4.2.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.