aboutsummaryrefslogtreecommitdiff
path: root/share/man/man9/DECLARE_MODULE.9
diff options
context:
space:
mode:
authorEd Maste <emaste@FreeBSD.org>2018-02-13 21:22:09 +0000
committerEd Maste <emaste@FreeBSD.org>2018-02-13 21:22:09 +0000
commit920bdda8572083001162f4c497e6685069acc00a (patch)
treed819fcc15cb8bb78ccb7254fc896bdd043d30b44 /share/man/man9/DECLARE_MODULE.9
parent0f18e6f6d6993847e77a9b4ba2b98710ffe2e922 (diff)
Document DECLARE_MODULE_TIED
It was introduced in r213716. Reviewed by: kib Sponsored by: The FreeBSD Foundation
Notes
Notes: svn path=/head/; revision=329244
Diffstat (limited to 'share/man/man9/DECLARE_MODULE.9')
-rw-r--r--share/man/man9/DECLARE_MODULE.915
1 files changed, 13 insertions, 2 deletions
diff --git a/share/man/man9/DECLARE_MODULE.9 b/share/man/man9/DECLARE_MODULE.9
index b5c85772c290..3ffad5b1d0eb 100644
--- a/share/man/man9/DECLARE_MODULE.9
+++ b/share/man/man9/DECLARE_MODULE.9
@@ -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