Hello Michael,
I cleaned up the includes (add missing ones, remove unneeded ones,
...), explained why each of them is needed (except for the one
providing the prototype), a few ffixes, and changed prototypes to
use syscall() when there's no wrapper.
I thought of adding a new section 'LIBRARY', as in FreeBSD's
manual pages, instead of assuming glibc, and having non-standard
clarifications in NOTES for non-glibc functions; but that would be
for a future patch-set after this one.
I highly doubt that I can finish this before 5.12, so maybe you
prefer to start a new branch to not release 5.12 with a mix of
styles...; up to you :-)
I didn't separate the syscall() changes from the #include changes,
because in most cases one implies the other, so I considered this
as a SYNOPSIS general improvement.
Cheers,
Alex
Alejandro Colomar (35):
system_data_types.7: Add 'struct sockaddr'
sockaddr.3: New link to system_data_types(7)
system_data_types.7: Add 'socklen_t'
socklen_t.3: New link to system_data_types(7)
access.2: Use syscall(SYS_...); for system calls without a wrapper
add_key.2: Remove unused include
alloc_hugepages.2: Use syscall(SYS_...); for system calls without a
wrapper
arch_prctl.2: Use syscall(SYS_...); for system calls without a wrapper
arch_prctl.2: SYNOPSIS: Remove unused includes
capget.2: Use syscall(SYS_...); for system calls without a wrapper
clone.2: Use syscall(SYS_...); for system calls without a wrapper
delete_module.2: Add missing include
dup.2: SYNOPSIS: Use consistent comments through pages
execveat.2: Use syscall(SYS_...); for system calls without a wrapper
exit_group.2: Use 'noreturn' in prototypes
exit_group.2: Use syscall(SYS_...); for system calls without a wrapper
fanotify_init.2: Add comment: why more than one include is needed
fcntl.2: Remove unused include
futex.2: Use syscall(SYS_...); for system calls without a wrapper
futimesat.2: ffix
getdents.2: Use syscall(SYS_...); for system calls without a wrapper
getpriority.2: Remove unused include
getrlimit.2, getrusage.2: Remove unused include
getunwind.2: Use syscall(SYS_...); for system calls without a wrapper
get_robust_list.2: Use syscall(SYS_...); for system calls without a
wrapper
delete_module.2: Use syscall(SYS_...); for system calls without a
wrapper
init_module.2: Use syscall(SYS_...); for system calls without a
wrapper
io_cancel.2: Use syscall(SYS_...); for system calls without a wrapper
ioctl_fat.2: Make clear why is each header exactly needed.
ioctl_fat.2: ffix
ioctl_ficlonerange.2: Make clear why is each header exactly needed.
ioctl_fideduperange.2: Make clear why exactly is each header needed
ioctl_fslabel.2: ffix
ioctl_fslabel.2: Make clear why exactly is each header needed
ioctl_getfsmap.2: Make clear why exactly is each header needed
man2/access.2 | 11 +++++---
man2/add_key.2 | 1 -
man2/alloc_hugepages.2 | 7 ++---
man2/arch_prctl.2 | 15 ++++-------
man2/capget.2 | 20 +++++++-------
man2/clone.2 | 17 +++++-------
man2/delete_module.2 | 9 ++++---
man2/dup.2 | 2 +-
man2/execveat.2 | 14 ++++------
man2/exit_group.2 | 5 ++--
man2/fanotify_init.2 | 2 +-
man2/fcntl.2 | 1 -
man2/futex.2 | 19 +++++---------
man2/futimesat.2 | 2 +-
man2/get_robust_list.2 | 19 ++++++--------
man2/getdents.2 | 12 ++++++---
man2/getpriority.2 | 13 ----------
man2/getrlimit.2 | 1 -
man2/getrusage.2 | 9 -------
man2/getunwind.2 | 14 +++-------
man2/init_module.2 | 20 ++++++--------
man2/io_cancel.2 | 16 +++++-------
man2/ioctl_fat.2 | 7 ++---
man2/ioctl_ficlonerange.2 | 2 +-
man2/ioctl_fideduperange.2 | 3 ++-
man2/ioctl_fslabel.2 | 4 +--
man2/ioctl_getfsmap.2 | 4 +--
man3/sockaddr.3 | 1 +
man3/socklen_t.3 | 1 +
man7/system_data_types.7 | 53 ++++++++++++++++++++++++++++++++++++++
30 files changed, 156 insertions(+), 148 deletions(-)
create mode 100644 man3/sockaddr.3
create mode 100644 man3/socklen_t.3
--
2.31.0
