From owner-p4-projects@FreeBSD.ORG Sun Oct 19 12:26:43 2008 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 615251065699; Sun, 19 Oct 2008 12:26:43 +0000 (UTC) Delivered-To: perforce@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0BEBD1065692 for ; Sun, 19 Oct 2008 12:26:43 +0000 (UTC) (envelope-from brueffer@freebsd.org) Received: from repoman.freebsd.org (repoman.freebsd.org [IPv6:2001:4f8:fff6::29]) by mx1.freebsd.org (Postfix) with ESMTP id E5E048FC15 for ; Sun, 19 Oct 2008 12:26:42 +0000 (UTC) (envelope-from brueffer@freebsd.org) Received: from repoman.freebsd.org (localhost [127.0.0.1]) by repoman.freebsd.org (8.14.3/8.14.3) with ESMTP id m9JCQgMb082061 for ; Sun, 19 Oct 2008 12:26:42 GMT (envelope-from brueffer@freebsd.org) Received: (from perforce@localhost) by repoman.freebsd.org (8.14.3/8.14.3/Submit) id m9JCQgus082059 for perforce@freebsd.org; Sun, 19 Oct 2008 12:26:42 GMT (envelope-from brueffer@freebsd.org) Date: Sun, 19 Oct 2008 12:26:42 GMT Message-Id: <200810191226.m9JCQgus082059@repoman.freebsd.org> X-Authentication-Warning: repoman.freebsd.org: perforce set sender to brueffer@freebsd.org using -f From: Christian Brueffer To: Perforce Change Reviews Cc: Subject: PERFORCE change 151559 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 19 Oct 2008 12:26:43 -0000 http://perforce.freebsd.org/chv.cgi?CH=151559 Change 151559 by brueffer@brueffer_haakonia on 2008/10/19 12:25:50 Consistently use mdoc macros, improve style. Affected files ... .. //depot/projects/trustedbsd/openbsm/man/getaudit.2#10 edit Differences ... ==== //depot/projects/trustedbsd/openbsm/man/getaudit.2#10 (text+ko) ==== @@ -24,9 +24,9 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $P4: //depot/projects/trustedbsd/openbsm/man/getaudit.2#9 $ +.\" $P4: //depot/projects/trustedbsd/openbsm/man/getaudit.2#10 $ .\" -.Dd April 19, 2005 +.Dd October 19, 2008 .Dt GETAUDIT 2 .Os .Sh NAME @@ -58,9 +58,7 @@ The .Fa auditinfo_t data structure is defined as follows: -.nf -.in +4n - +.Bd -literal -offset indent struct auditinfo { au_id_t ai_auid; /* Audit user ID */ au_mask_t ai_mask; /* Audit masks */ @@ -68,47 +66,39 @@ au_asid_t ai_asid; /* Audit session ID */ }; typedef struct auditinfo auditinfo_t; -.in -.fi +.Ed .Pp The .Fa ai_auid variable contains the audit identifier which is recorded in the audit log for each event the process caused. -.PP - +.Pp The .Fa au_mask_t data structure defines the bit mask for auditing successful and failed events -out of the predefined list of event classes. It is defined as follows: -.nf -.in +4n - +out of the predefined list of event classes. +It is defined as follows: +.Bd -literal -offset indent struct au_mask { unsigned int am_success; /* success bits */ unsigned int am_failure; /* failure bits */ }; typedef struct au_mask au_mask_t; -.in -.fi -.PP - +.Ed +.Pp The .Fa au_termid_t data structure defines the Terminal ID recorded with every event caused by the -process. It is defined as follows: -.nf -.in +4n - +process. +It is defined as follows: +.Bd -literal -offset indent struct au_tid { dev_t port; u_int32_t machine; }; typedef struct au_tid au_tid_t; -.in -.fi -.PP - +.Ed +.Pp The .Fa ai_asid variable contains the audit session ID which is recorded with every event @@ -119,11 +109,10 @@ system call uses the expanded .Fa auditinfo_addr_t -data structure supports Terminal IDs with larger addresses such as those used -in IP version 6. It is defined as follows: -.nf -.in +4n - +data structure and supports Terminal IDs with larger addresses +such as those used in IP version 6. +It is defined as follows: +.Bd -literal -offset indent struct auditinfo_addr { au_id_t ai_auid; /* Audit user ID. */ au_mask_t ai_mask; /* Audit masks. */ @@ -131,25 +120,20 @@ au_asid_t ai_asid; /* Audit session ID. */ }; typedef struct auditinfo_addr auditinfo_addr_t; -.in -.fi +.Ed .Pp - The .Fa au_tid_addr_t data structure which includes a larger address storage field and an additional field with the type of address stored: -.nf -.in +4n - +.Bd -literal -offset indent struct au_tid_addr { dev_t at_port; u_int32_t at_type; u_int32_t at_addr[4]; }; typedef struct au_tid_addr au_tid_addr_t; -.in -.fi +.Ed .Pp These system calls require an appropriate privilege to complete. .Sh RETURN VALUES