From owner-p4-projects@FreeBSD.ORG  Sun Apr 24 16:49:21 2005
Return-Path: <owner-p4-projects@FreeBSD.ORG>
Delivered-To: p4-projects@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 0214F16A4D0; Sun, 24 Apr 2005 16:49:21 +0000 (GMT)
Delivered-To: perforce@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B8EA816A4CE
	for <perforce@freebsd.org>; Sun, 24 Apr 2005 16:49:20 +0000 (GMT)
Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9BC3B43D2F
	for <perforce@freebsd.org>; Sun, 24 Apr 2005 16:49:20 +0000 (GMT)
	(envelope-from bb+lists.freebsd.perforce@cyrus.watson.org)
Received: from repoman.freebsd.org (localhost [127.0.0.1])
	by repoman.freebsd.org (8.13.1/8.13.1) with ESMTP id j3OGnKZv000672
	for <perforce@freebsd.org>; Sun, 24 Apr 2005 16:49:20 GMT
	(envelope-from bb+lists.freebsd.perforce@cyrus.watson.org)
Received: (from perforce@localhost)
	by repoman.freebsd.org (8.13.1/8.13.1/Submit) id j3OGnKQ4000669
	for perforce@freebsd.org; Sun, 24 Apr 2005 16:49:20 GMT
	(envelope-from bb+lists.freebsd.perforce@cyrus.watson.org)
Date: Sun, 24 Apr 2005 16:49:20 GMT
Message-Id: <200504241649.j3OGnKQ4000669@repoman.freebsd.org>
X-Authentication-Warning: repoman.freebsd.org: perforce set sender to
	bb+lists.freebsd.perforce@cyrus.watson.org using -f
From: Robert Watson <rwatson@FreeBSD.org>
To: Perforce Change Reviews <perforce@freebsd.org>
Subject: PERFORCE change 75896 for review
X-BeenThere: p4-projects@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: p4 projects tree changes <p4-projects.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/p4-projects>
List-Post: <mailto:p4-projects@freebsd.org>
List-Help: <mailto:p4-projects-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 24 Apr 2005 16:49:21 -0000

http://perforce.freebsd.org/chv.cgi?CH=75896

Change 75896 by rwatson@rwatson_paprika on 2005/04/24 16:48:55

	Document that including audit_internal.h in applications is a bad
	idea, as it relies on internal knowledge of audit representation.

Affected files ...

.. //depot/projects/trustedbsd/openbsm/bsm/audit_internal.h#2 edit

Differences ...

==== //depot/projects/trustedbsd/openbsm/bsm/audit_internal.h#2 (text+ko) ====

@@ -24,6 +24,14 @@
 #ifndef _LIBBSM_INTERNAL_H
 #define	_LIBBSM_INTERNAL_H
 
+/*
+ * audit_internal.h contains private interfaces that are shared by user space
+ * and the kernel for the purposes of assembling audit records.  Applications
+ * should not include this file or use the APIs found within, or it may be
+ * broken with future releases of OpenBSM, which may delete, modify, or
+ * otherwise break these interfaces or the assumptions they rely on.
+ */
+
 /* We could determined the header and trailer sizes by
  * defining appropriate structures. We hold off that approach
  * till we have a consistant way of using structures for all tokens.