[PATCH] socketcall.2: Add note about missing glibc wrapper

[PATCH] socketcall.2: Add note about missing glibc wrapper

[Alejandro Colomar]

......

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

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---
 man2/socketcall.2 | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/man2/socketcall.2 b/man2/socketcall.2
index a3012d4c7..d1803d906 100644
--- a/man2/socketcall.2
+++ b/man2/socketcall.2
@@ -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
-- 
2.30.0

Re: [PATCH] socketcall.2: Add note about missing glibc wrapper

[Michael Kerrisk (man-pages)]

Hi Alex,

On 2/15/21 2:15 PM, Alejandro Colomar wrote:
> ......
> 
> .../glibc$ grep_glibc_prototype socketcall
> .../glibc$
> 
> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Thanks! Patch applied.

Cheers,

Michael

> ---
>  man2/socketcall.2 | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/man2/socketcall.2 b/man2/socketcall.2
> index a3012d4c7..d1803d906 100644
> --- a/man2/socketcall.2
> +++ b/man2/socketcall.2
> @@ -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
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/