Re: [PATCH 00/45] Add LIBRARY section (based on FreeBSD manual pages)

[Eugene Syromyatnikov <evgsyr@xxxxxxxxx>]

On Sat, Sep 11, 2021 at 6:01 PM Alejandro Colomar
<alx.manpages@xxxxxxxxx> wrote:
> Alejandro Colomar (45):
>   _exit.2: Add LIBRARY section
>   keyctl.2: Add LIBRARY section

>   request_key.2: Add LIBRARY section
>   write.2: Add LIBRARY section
>   wait4.2: Add LIBRARY section
>   wait.2: Add LIBRARY section
>   vmsplice.2: Add LIBRARY section
>   vm86.2: Add LIBRARY section
>   vhangup.2: Add LIBRARY section
>   vfork.2: Add LIBRARY section
>   utimensat.2: Add LIBRARY section
>   utime.2: Add LIBRARY section
>   ustat.2: Add LIBRARY section
>   userfaultfd.2: Add LIBRARY section
>   unshare.2: Add LIBRARY section
>   uname.2: Add LIBRARY section
>   umount.2: Add LIBRARY section
>   tkill.2: Add LIBRARY section
>   unlink.2: Add LIBRARY section
>   umask.2: Add LIBRARY section
>   truncate.2: Add LIBRARY section
>   timer_getoverrun.2: Add LIBRARY section
>   timerfd_create.2: Add LIBRARY section
>   timer_delete.2: Add LIBRARY section
>   timer_create.2: Add LIBRARY section
>   time.2: Add LIBRARY section
>   tee.2: Add LIBRARY section
>   syslog.2: Add LIBRARY section
>   sysinfo.2: Add LIBRARY section
>   syscall.2: Add LIBRARY section
>   sync_file_range.2: Add LIBRARY section
>   sync.2: Add LIBRARY section
>   symlink.2: Add LIBRARY section
>   swapon.2: Add LIBRARY section
>   subpage_prot.2: Add LIBRARY section
>   statx.2: Add LIBRARY section
>   stat.2: Add LIBRARY section
>   spu_run.2: Add LIBRARY section
>   spu_create.2: Add LIBRARY section
>   splice.2: Add LIBRARY section
>   socketpair.2: Add LIBRARY section
>   socketcall.2: Add LIBRARY section
>   sigwaitinfo.2: Add LIBRARY section

I'm not sure about these, my understanding is that the primary purpose
of section 2 is syscalls, userspace-kernel interface, and not their
libc wrappers.  Even intro(2) states that it is Linux-specific:
“Section  2  of the manual describes the Linux system calls.  A system
call is an entry point into the Linux kernel.” Tying it to libc feels
like a bit of a stretch, even though it is the exceedingly common
interface for invoking them.

-- 
Eugene Syromyatnikov
mailto:evgsyr@xxxxxxxxx
xmpp:esyr@jabber.{ru|org}