praudit(1)

praudit1

Print the contents of audit trail files

Usage

praudit [-lnpx] [{-r | -s}] [-d del] [file ...]

Overview

The praudit utility prints the contents of the audit trail files to the standard output in human-readable form. If no file argument is specified, the standard input is used by default.

The options are as follows:

-d del

Specifies the delimiter. The default delimiter is the comma.

-l

Prints the entire record on the same line. If this option is not specified, every token is displayed on a different line.

-n

Do not convert user and group IDs to their names but leave in their numeric forms.

-p

Specify this option if input to praudit is piped from the tail(1) utility. This causes praudit to sync to the start of the next record.

-r

Prints the records in their raw, numeric form. This option is exclusive from -s.

-s

Prints the tokens in their short form. Short text representations for record and event type are displayed. This option is exclusive from -r.

-x

Print audit records in the XML output format.

If the raw or short forms are not specified, the default is to print the tokens in their long form. Events are displayed as per their descriptions given in /etc/security/audit_event; UIDs and GIDs are expanded to their names; dates and times are displayed in human-readable format.

Exit status

The praudit utility exits 0 on success, and >0 if an error occurs.

Files

/etc/security/audit_class

Descriptions of audit event classes.

/etc/security/audit_event

Descriptions of audit events.

Releases

47 releases since FreeBSD 6.2-RELEASE; the text changed 5 times.

  1. 6.2
  2. 6.3–7.4
  3. 8.0–9.1
  4. 9.2–10.2
  5. 10.3–11.2
  6. 11.3–16.0

-n since FreeBSD 9.2-RELEASE; -p since FreeBSD 6.3-RELEASE; -x since FreeBSD 6.3-RELEASE.

History

The OpenBSM implementation was created by McAfee Research, the security division of McAfee Inc., under contract to Apple Computer Inc. in 2004. It was subsequently adopted by the TrustedBSD Project as the foundation for the OpenBSM distribution.

Authors

This software was created by McAfee Research, the security research division of McAfee, Inc., under contract to Apple Computer Inc. Additional authors include Wayne Salamon, Robert Watson, and SPARTA Inc.

The Basic Security Module (BSM) interface to audit records and audit event stream format were defined by Sun Microsystems.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.