diff --git a/en_US.ISO8859-1/books/handbook/audit/chapter.sgml b/en_US.ISO8859-1/books/handbook/audit/chapter.sgml
index 564124008f..2cb25f98d0 100644
--- a/en_US.ISO8859-1/books/handbook/audit/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/audit/chapter.sgml
@@ -504,7 +504,7 @@ www:fc,+ex:no
Administering the Audit Subsystem
- Viewing and Reducing Audit Trails
+ Viewing Audit Trails
Audit trails are stored in the BSM binary format, so tools must
be used to modify or convert to text. The praudit
@@ -521,7 +521,47 @@ www:fc,+ex:no
&prompt.root; praudit /var/audit/AUDITFILE
Where AUDITFILE is the audit log to
- dump. Since audit logs may be very large, an administrator will
+ dump.
+
+ Audit trails consist of a series of audit records made up of
+ tokens, which praudit prints sequentially one per
+ line. Each token is of a specific type, such as
+ header holding an audit record header, or
+ path holding a file path from a name
+ lookup. The following is an example of an
+ execve event:
+
+ header,133,10,execve(2),0,Mon Sep 25 15:58:03 2006, + 384 msec
+exec arg,finger,doug
+path,/usr/bin/finger
+attribute,555,root,wheel,90,24918,104944
+subject,robert,root,wheel,root,wheel,38439,38032,42086,128.232.9.100
+return,success,0
+trailer,133
+
+ This audit represents a successful execve
+ call, in which the command "finger doug" has been run. The
+ arguments token contains both the processed command line presented
+ by the shell to the kernel. The path token holds the path to the
+ executable as looked up by the kernel. The attribute token
+ describes the binary, and in particular, includes the file mode
+ which can be used to determine if the application was setuid.
+ The subject token describes the subject process, and stores in
+ sequence the audit user ID, effective user ID and group ID, real
+ user ID and group ID, process ID, session ID, port ID, and login
+ address. Notice that the audit user ID and real user ID differ:
+ the user robert has switched to the
+ root account before running this command, but
+ it is audited using the original authenticated user. Finally, the
+ return token indicates the successful execution, and the trailer
+ concludes the record.
+
+
+
+
+ Reducing Audit Trails
+
+ Since audit logs may be very large, an administrator will
likely want to select a subset of records for using, such as records
associated with a specific user: