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

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

[Alejandro Colomar]

Glibc bug: <https://sourceware.org/bugzilla/show_bug.cgi?id=27380>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---
 man2/process_madvise.2 | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/man2/process_madvise.2 b/man2/process_madvise.2
index d33c32f63..9dc90ced1 100644
--- a/man2/process_madvise.2
+++ b/man2/process_madvise.2
@@ -36,6 +36,10 @@ process_madvise \- give advice about use of memory to a process
 .BI "                        unsigned long " vlen ", int " advice ,
 .BI "                        unsigned int " flags ");"
 .fi
+.PP
+.IR Note :
+There is no glibc wrapper for this system call; see NOTES.
+.\" FIXME: See <https://sourceware.org/bugzilla/show_bug.cgi?id=27380>
 .SH DESCRIPTION
 The
 .BR process_madvise()
@@ -218,6 +222,9 @@ Support for this system call is optional,
 depending on the setting of the
 .B CONFIG_ADVISE_SYSCALLS
 configuration option.
+.SH NOTES
+Glibc does not provide a wrapper for this system call; call it using
+.BR syscall (2).
 .SH SEE ALSO
 .BR madvise (2),
 .BR pidfd_open (2),
-- 
2.30.0

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

[Michael Kerrisk (man-pages)]

Hi Alex,

On 2/11/21 6:44 PM, Alejandro Colomar wrote:
> Glibc bug: <https://sourceware.org/bugzilla/show_bug.cgi?id=27380>
> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Thanks. Patch applied.

Cheers,

Michael

> ---
>  man2/process_madvise.2 | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/man2/process_madvise.2 b/man2/process_madvise.2
> index d33c32f63..9dc90ced1 100644
> --- a/man2/process_madvise.2
> +++ b/man2/process_madvise.2
> @@ -36,6 +36,10 @@ process_madvise \- give advice about use of memory to a process
>  .BI "                        unsigned long " vlen ", int " advice ,
>  .BI "                        unsigned int " flags ");"
>  .fi
> +.PP
> +.IR Note :
> +There is no glibc wrapper for this system call; see NOTES.
> +.\" FIXME: See <https://sourceware.org/bugzilla/show_bug.cgi?id=27380>
>  .SH DESCRIPTION
>  The
>  .BR process_madvise()
> @@ -218,6 +222,9 @@ Support for this system call is optional,
>  depending on the setting of the
>  .B CONFIG_ADVISE_SYSCALLS
>  configuration option.
> +.SH NOTES
> +Glibc does not provide a wrapper for this system call; call it using
> +.BR syscall (2).
>  .SH SEE ALSO
>  .BR madvise (2),
>  .BR pidfd_open (2),
> 


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