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: