aboutsummaryrefslogtreecommitdiffstats
path: root/man2/create_module.2
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2014-05-02 08:51:50 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2014-05-08 11:15:37 +0200
commit4a9c7a5ecbc27dc31c4b46f153b64c77dcdf4a11 (patch)
tree36c6337f1dd3858cc5be327e04814cb8b1528dfc /man2/create_module.2
parent1205c84585e22991b1256550e4fd80e82ff77abc (diff)
downloadman-pages-4a9c7a5ecbc27dc31c4b46f153b64c77dcdf4a11.tar.gz
create_module.2, delete_module.2, init_module.2, query_module.2: Clarify glibc header file declaration/ABI wrapper details
create_module(), delete_module(), init_module(), and query_module() are not declared in header files, but through an accident of history glibc provides an ABI for them that it continues to maintain, for compatibility reasons. Reported-by: Lucas De Marchi <lucas.demarchi@profusion.mobi> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man2/create_module.2')
-rw-r--r--man2/create_module.215
1 files changed, 14 insertions, 1 deletions
diff --git a/man2/create_module.2 b/man2/create_module.2
index 868fc7cac9..80f1c0394e 100644
--- a/man2/create_module.2
+++ b/man2/create_module.2
@@ -16,8 +16,11 @@ create_module \- create a loadable module entry
.sp
.BI "caddr_t create_module(const char *" name ", size_t " size );
.fi
+
+.IR Note :
+No declaration of this function is provided in glibc headers; see NOTES.
.SH DESCRIPTION
-.BR Note :
+.IR Note :
This system call is present only in kernels before Linux 2.6.
.BR create_module ()
@@ -62,6 +65,16 @@ it was removed in Linux 2.6.
.SH CONFORMING TO
.BR create_module ()
is Linux-specific.
+.SH NOTES
+The
+.BR create_module ()
+system call is not suported by glibc.
+No declaration is provided in glibc headers, but,
+through a quirk of history, glibc does export an ABI for this system call.
+Therefore, in order to employ this system call,
+it is sufficient to manually declare the interface in your code;
+alternatively, you can invoke the system call using
+.BR syscall (2).
.SH SEE ALSO
.BR delete_module (2),
.BR init_module (2),