aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--man2/create_module.215
-rw-r--r--man2/delete_module.211
-rw-r--r--man2/init_module.220
-rw-r--r--man2/query_module.214
4 files changed, 51 insertions, 9 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),
diff --git a/man2/delete_module.2 b/man2/delete_module.2
index 12f738907b..3084a483f1 100644
--- a/man2/delete_module.2
+++ b/man2/delete_module.2
@@ -31,7 +31,7 @@ delete_module \- unload a kernel module
.fi
.IR Note :
-There is no glibc wrapper for this system call; see NOTES.
+No declaration of this function is provided in glibc headers; see NOTES.
.SH DESCRIPTION
The
.BR delete_module ()
@@ -173,7 +173,14 @@ was not specified in
.BR delete_module ()
is Linux-specific.
.SH NOTES
-Glibc does not provide a wrapper for this system call; call it using
+The
+.BR delete_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).
The uninterruptible sleep that may occur if
diff --git a/man2/init_module.2 b/man2/init_module.2
index 0e00c04a5a..a0f175eb3c 100644
--- a/man2/init_module.2
+++ b/man2/init_module.2
@@ -37,7 +37,11 @@ init_module, finit_module \- load a kernel module
.fi
.IR Note :
-There are no glibc wrappers for these system calls; see NOTES.
+glibc provides no header file declaration of
+.BR init_module ()
+and no wrapper function for
+.BR finit_module ();
+see NOTES.
.SH DESCRIPTION
.BR init_module ()
loads an ELF image into kernel space,
@@ -258,7 +262,19 @@ and
.BR finit_module ()
are Linux-specific.
.SH NOTES
-Glibc does not provide a wrapper for these system calls; call them using
+The
+.BR init_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).
+
+Glibc does not provide a wrapper for
+.BR finit_module ();
+call it using
.BR syscall (2).
Information about currently loaded modules can be found in
diff --git a/man2/query_module.2 b/man2/query_module.2
index 17d4e4f721..489e4faa4c 100644
--- a/man2/query_module.2
+++ b/man2/query_module.2
@@ -19,9 +19,9 @@ query_module \- query the kernel for various bits pertaining to modules
.fi
.IR Note :
-There is no glibc wrapper for this system call; see NOTES.
+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 query_module ()
@@ -181,8 +181,14 @@ can be obtained from
and the files under the directory
.IR /sys/module .
-Glibc does not provide a wrapper for this system call;
-in the unlikely event that you need to use it on an old kernel, use
+The
+.BR query_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 create_module (2),