On 4/11/21 9:23 PM, Alejandro Colomar (man-pages) wrote:
Hi Michael,
On 4/5/21 1:49 PM, Michael Kerrisk (man-pages) wrote:
So, I think I'm okay with the syscall() changes in the SYNOPSIS.
It might just take me a moment to get used to them. However, I do
wonder if it is worth retaining a comment in the SYSNOPSIS,
something like:
SYNOPSIS
#include <asm/prctl.h> /* Definition of ARCH_*
constants */
#include <sys/syscall.h> /* Definition of SYS_* constants */
#include <unistd.h>
int syscall(SYS_arch_prctl, int code, unsigned long addr);
int syscall(SYS_arch_prctl, int code, unsigned long *addr);
Note: glibc provides no wrapper for arch_prctl(), necessitating
the use of syscall(2).
I'm not sure what text to write in cases such as faccessat2(2). Could
you have a look at that?
There's actually a wrapper, but it's faccessat(2).
Without something like this, the reader may be puzzled at the use of
syscall().
What do you think?
Yes. I had doubts, and you confirmed them. I'll add that.
Thanks,
Alex
--
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/