aboutsummaryrefslogtreecommitdiffstats
path: root/man2/query_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/query_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/query_module.2')
-rw-r--r--man2/query_module.214
1 files changed, 10 insertions, 4 deletions
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),