xref: /titanic_50/usr/src/man/man1m/auditstat.1m (revision 7c1d35456b77b833f089b886b99aa431a24e1377)
te
Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the
fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
auditstat 1M "16 Jun 2009" "SunOS 5.11" "System Administration Commands"
NAME
auditstat - display kernel audit statistics
SYNOPSIS

auditstat [-c count] [-h numlines] [-i interval] [-n]
 [-T u | d ] [-v]
DESCRIPTION

auditstat displays kernel audit statistics. The fields displayed are as follows:

aud

The total number of audit records processed by the audit(2) system call.

ctl

This field is obsolete.

drop

The total number of audit records that have been dropped. Records are dropped according to the kernel audit policy. See auditon(2), AUDIT_CNT policy for details.

enq

The total number of audit records put on the kernel audit queue.

gen

The total number of audit records that have been constructed (not the number written).

kern

The total number of audit records produced by user processes (as a result of system calls).

mem

The total number of Kbytes of memory currently in use by the kernel audit module.

nona

The total number of non-attributable audit records that have been constructed. These are audit records that are not attributable to any particular user.

rblk

The total number of times that the audit queue has blocked waiting to process audit data.

tot

The total number of Kbytes of audit data written to the audit trail.

wblk

The total number of times that user processes blocked on the audit queue at the high water mark.

wrtn

The total number of audit records written. The difference between enq and wrtn is the number of outstanding audit records on the audit queue that have not been written.

OPTIONS

-c count

Display the statistics a total of count times. If count is equal to zero, statistics are displayed indefinitely. A time interval must be specified.

-h numlines

Display a header for every numlines of statistics printed. The default is to display the header every 20 lines. If numlines is equal to zero, the header is never displayed.

-i interval

Display the statistics every interval where interval is the number of seconds to sleep between each collection.

-n

Display the number of kernel audit events currently configured.

-T u | d

Display a time stamp. Specify u for a printed representation of the internal representation of time. See time(2). Specify d for standard date format. See date(1).

-v

Display the version number of the kernel audit module software.

EXIT STATUS

auditstat returns 0 upon success and 1 upon failure.

SEE ALSO

auditconfig(1M), praudit(1M), bsmconv(1M), audit(2), auditon(2), attributes(5)

NOTES

The functionality described in this man page is available only if Solaris Auditing has been enabled. See bsmconv(1M) for more information.