Skip to contentSkip to conversation

socketcall.2: Add note about missing glibc wrapper

PATCH In review Alejandro Colomar 2 participants 2 messages Feb 15, 2021 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 socketcall.2: Add note about missing glibc wrapper

......

.../glibc$ grep_glibc_prototype socketcall
.../glibc$

---
 man2/socketcall.2 | 6 ++++++
 1 file changed, 6 insertions(+)
man2/socketcall.2 +6 -0
index a3012d4c7..d1803d906 100644
@@ -31,6 +31,9 @@ socketcall \- socket system calls
 .PP
 .BI "int socketcall(int " call ", unsigned long *" args );
 .fi
+.PP
+.IR Note :
+There is no glibc wrapper for this system call; see NOTES.
 .SH DESCRIPTION
 .BR socketcall ()
 is a common kernel entry point for the socket system calls.
@@ -153,6 +156,9 @@ T}
 This call is specific to Linux, and should not be used in programs
 intended to be portable.
 .SH NOTES
+Glibc does not provide a wrapper for this system call; call it using
+.BR syscall (2).
+.PP
 On a some architectures\(emfor example, x86-64 and ARM\(emthere is no
 .BR socketcall ()
 system call; instead
Signature · 1 line
2.30.0
#1 lore raw

Hi Alex,

Quoted 6 lines · Alejandro Colomar

......

.../glibc$ grep_glibc_prototype socketcall
.../glibc$

Thanks! Patch applied.

Cheers,

Michael

Quoted 29 lines
---
 man2/socketcall.2 | 6 ++++++
 1 file changed, 6 insertions(+)
man2/socketcall.2 +6 -0
index a3012d4c7..d1803d906 100644
@@ -31,6 +31,9 @@ socketcall \- socket system calls
 .PP
 .BI "int socketcall(int " call ", unsigned long *" args );
 .fi
+.PP
+.IR Note :
+There is no glibc wrapper for this system call; see NOTES.
 .SH DESCRIPTION
 .BR socketcall ()
 is a common kernel entry point for the socket system calls.
@@ -153,6 +156,9 @@ T}
 This call is specific to Linux, and should not be used in programs
 intended to be portable.
 .SH NOTES
+Glibc does not provide a wrapper for this system call; call it using
+.BR syscall (2).
+.PP
 On a some architectures\(emfor example, x86-64 and ARM\(emthere is no
 .BR socketcall ()
 system call; instead
Signature · 3 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/