From owner-p4-projects@FreeBSD.ORG  Tue Aug  9 11:24:59 2005
Return-Path: <owner-p4-projects@FreeBSD.ORG>
X-Original-To: p4-projects@freebsd.org
Delivered-To: p4-projects@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 092D916A421; Tue,  9 Aug 2005 11:24:59 +0000 (GMT)
X-Original-To: perforce@freebsd.org
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 D83FC16A41F
	for <perforce@freebsd.org>; Tue,  9 Aug 2005 11:24:58 +0000 (GMT)
	(envelope-from bb+lists.freebsd.perforce@cyrus.watson.org)
Received: from repoman.freebsd.org (repoman.freebsd.org [216.136.204.115])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A4B8443D49
	for <perforce@freebsd.org>; Tue,  9 Aug 2005 11:24:58 +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 j79BOwDv012062
	for <perforce@freebsd.org>; Tue, 9 Aug 2005 11:24:58 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 j79BOwQ4012059
	for perforce@freebsd.org; Tue, 9 Aug 2005 11:24:58 GMT
	(envelope-from bb+lists.freebsd.perforce@cyrus.watson.org)
Date: Tue, 9 Aug 2005 11:24:58 GMT
Message-Id: <200508091124.j79BOwQ4012059@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>
Cc: 
Subject: PERFORCE change 81723 for review
X-BeenThere: p4-projects@freebsd.org
X-Mailman-Version: 2.1.5
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: Tue, 09 Aug 2005 11:24:59 -0000

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

Change 81723 by rwatson@rwatson_peppercorn on 2005/08/09 11:24:43

	Expand discussion of MAC Framework versioning.

Affected files ...

.. //depot/projects/trustedbsd/mac/sys/kern/kern_mac.c#447 edit

Differences ...

==== //depot/projects/trustedbsd/mac/sys/kern/kern_mac.c#447 (text+ko) ====

@@ -96,10 +96,21 @@
 
 #ifdef MAC
 
-/*
- * Declare that the kernel provides MAC support, version 1.  This permits
- * modules to refuse to be loaded if the necessary support isn't present,
- * even if it's pre-boot.
+/*-
+ * The TrustedBSD MAC Framework declares two version numbers in support of
+ * policy modules:
+ *
+ * - A linker version number, which declares the version of the MAC policy
+ *   ABI.
+ *
+ * - A feature version number, relative to the linker version, which declares
+ *   what if any optional features for the linker version are present.  This
+ *   supports the incremental addition of features in a FreeBSD RELENG
+ *   branch.
+ *
+ * Modules will be unable to load if they do not match the current linker
+ * version due to ABI compatibility concerns.  They may also test for support
+ * for specific API features that they depend on.
  */
 MODULE_VERSION(kernel_mac_support, 3);