svn commit: r329244 - head/share/man/man9

[Ed Maste]

Author: emaste
Date: Tue Feb 13 21:22:09 2018
New Revision: 329244
URL: https://svnweb.freebsd.org/changeset/base/329244

Log:
  Document DECLARE_MODULE_TIED
  
  It was introduced in r213716.
  
  Reviewed by:	kib
  Sponsored by:	The FreeBSD Foundation

Modified:
  head/share/man/man9/DECLARE_MODULE.9

Modified: head/share/man/man9/DECLARE_MODULE.9
==============================================================================
--- head/share/man/man9/DECLARE_MODULE.9	Tue Feb 13 21:14:27 2018	(r329243)
+++ head/share/man/man9/DECLARE_MODULE.9	Tue Feb 13 21:22:09 2018	(r329244)
@@ -28,7 +28,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd January 6, 2005
+.Dd February 13, 2018
 .Dt DECLARE_MODULE 9
 .Os
 .Sh NAME
@@ -39,6 +39,7 @@
 .In sys/kernel.h
 .In sys/module.h
 .Fn DECLARE_MODULE "name" "moduledata_t data" "sub" "order"
+.Fn DECLARE_MODULE_TIED "name" "moduledata_t data" "sub" "order"
 .Sh DESCRIPTION
 The
 .Fn DECLARE_MODULE
@@ -55,7 +56,17 @@ and
 Of course, it can also be called directly, for example in
 order to implement dynamic sysctls.
 .Pp
-The arguments it expects are:
+A module declared with
+.Fn DECLARE_MODULE_TIED
+will load only if the running kernel version
+(as specified by
+.Dv __FreeBSD_version )
+is identical to that on which it was built.
+This declaration should be used by modules which depend on interfaces beyond
+the stable kernel KBI (such as ABI emulators or hypervisors that rely on
+internal kernel structures).
+.Pp
+The arguments are:
 .Bl -tag -width indent
 .It Fa name
 The module name, which will be used in the