hier.7: tfix

Reported-by: Grigoriy <grigoriyremvar@protonmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

fanotify_mark.2: Document FAN_MARK_IGNORE

A new flavor of FAN_MARK_IGNORED_MASK that helps to resolve the
ambiguity around the combination of event flags and ignore mask.

It is also more strict in the events and flags allowed to be
set in a non-directory inode mark mask and it mandates the use
of FAN_MARK_IGNORED_SURV_MODIFY flag on filesystem, mount and
directory inode marks.

Reviewed-by: Jan Kara <jack@suse.cz>
Reviewed-by: Matthew Bobrowski <repnop@google.com>
Signed-off-by: Amir Goldstein <amir73il@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Start of man-pages-NEXT: Move Changes to Changes.old

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Ready for 6.00

Signed-off-by: Alejandro Colomar <alx@kernel.org>

update_timestamps.sh: Ignore inexistent files

Signed-off-by: Alejandro Colomar <alx@kernel.org>

getent.1, iconv.1, intro.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, mtrace.1, pldd.1, sprof.1, time.1, _exit.2, _syscall.2, accept.2, access.2, acct.2, add_key.2, adjtimex.2, alarm.2, alloc_hugepages.2, arch_prctl.2, bdflush.2, bind.2, bpf.2, brk.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, close_range.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, execveat.2, exit_group.2, fallocate.2, fanotify_init.2, fanotify_mark.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_mempolicy.2, get_robust_list.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpid.2, getpriority.2, getrandom.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, getxattr.2, idle.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl.2, ioctl_console.2, ioctl_fat.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_fslabel.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kexec_load.2, keyctl.2, kill.2, landlock_add_rule.2, landlock_create_ruleset.2, landlock_restrict_self.2, link.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, mbind.2, membarrier.2, memfd_create.2, memfd_secret.2, migrate_pages.2, mincore.2, mkdir.2, mknod.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, mount_setattr.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, open_by_handle_at.2, openat2.2, outb.2, pause.2, pciconfig_read.2, perf_event_open.2, perfmonctl.2, personality.2, pidfd_getfd.2, pidfd_open.2, pidfd_send_signal.2, pipe.2, pivot_root.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_madvise.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readv.2, reboot.2, recv.2, recvmmsg.2, remap_file_pages.2, removexattr.2, rename.2, request_key.2, restart_syscall.2, rmdir.2, rt_sigqueueinfo.2, s390_guarded_storage.2, s390_pci_mmio_write.2, s390_runtime_instr.2, s390_sthyi.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, seccomp.2, seccomp_unotify.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, sendmmsg.2, set_mempolicy.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setns.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, setup.2, setxattr.2, sgetmask.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, spu_create.2, spu_run.2, stat.2, statfs.2, statx.2, stime.2, subpage_prot.2, swapon.2, symlink.2, sync.2, sync_file_range.2, syscall.2, syscalls.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unshare.2, uselib.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, vmsplice.2, wait.2, wait4.2, write.2, open_how.2type, CPU_SET.3, FILE.3, INFINITY.3, MAX.3, MB_CUR_MAX.3, MB_LEN_MAX.3, _Generic.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, a64l.3, abort.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_cancel.3, aio_error.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, backtrace.3, basename.3, bcmp.3, bcopy.3, bindresvport.3, bsd_signal.3, bsearch.3, bstring.3, bswap.3, btowc.3, btree.3, byteorder.3, bzero.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cexp2.3, cfree.3, cimag.3, circleq.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, closedir.3, cmsg.3, confstr.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctermid.3, ctime.3, daemon.3, dbopen.3, des_crypt.3, difftime.3, dirfd.3, div.3, dl_iterate_phdr.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, drand48_r.3, duplocale.3, dysize.3, ecvt.3, ecvt_r.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fclose.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, fgetgrent.3, fgetpwent.3, fgetwc.3, fgetws.3, fileno.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fnmatch.3, fopen.3, fopencookie.3, fpathconf.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, fread.3, frexp.3, fseek.3, fseeko.3, ftime.3, ftok.3, fts.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getentropy.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getpass.3, getprotoent.3, getprotoent_r.3, getpt.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getusershell.3, getutent.3, getutmp.3, getw.3, getwchar.3, glob.3, gnu_get_libc_version.3, grantpt.3, group_member.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, index.3, inet.3, inet_net_pton.3, inet_ntop.3, inet_pton.3, initgroups.3, insque.3, intro.3, isalpha.3, isatty.3, isfdtype.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, lio_listio.3, list.3, localeconv.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc.3, malloc_get_state.3, malloc_hook.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, mempcpy.3, memset.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, nan.3, netlink.3, newlocale.3, nextafter.3, nextup.3, nl_langinfo.3, ntp_gettime.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setsigmask_np.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_equal.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_mutex_consistent.3, pthread_mutexattr_getpshared.3, pthread_mutexattr_init.3, pthread_mutexattr_setrobust.3, pthread_rwlockattr_setkind_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_spin_init.3, pthread_spin_lock.3, pthread_testcancel.3, pthread_tryjoin_np.3, pthread_yield.3, ptsname.3, putenv.3, putgrent.3, putpwent.3, puts.3, putwchar.3, qecvt.3, qsort.3, raise.3, rand.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, readdir_r.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rewinddir.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, siginterrupt.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sincos.3, sinh.3, sleep.3, slist.3, sockatmark.3, sqrt.3, stailq.3, statvfs.3, stdarg.3, stdin.3, stdio.3, stdio_ext.3, stpcpy.3, stpncpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strfry.3, strftime.3, string.3, strlen.3, strnlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tailq.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, towctrans.3, towlower.3, towupper.3, trunc.3, tsearch.3, ttyname.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, undocumented.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, updwtmp.3, uselocale.3, usleep.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, NULL.3const, sysexits.h.3head, aiocb.3type, blkcnt_t.3type, blksize_t.3type, cc_t.3type, clock_t.3type, clockid_t.3type, dev_t.3type, div_t.3type, double_t.3type, epoll_event.3type, fenv_t.3type, id_t.3type, intN_t.3type, intmax_t.3type, intptr_t.3type, iovec.3type, itimerspec.3type, lconv.3type, mode_t.3type, off_t.3type, ptrdiff_t.3type, regex_t.3type, size_t.3type, sockaddr.3type, stat.3type, time_t.3type, timer_t.3type, timespec.3type, timeval.3type, tm.3type, va_list.3type, void.3type, cciss.4, console_codes.4, cpuid.4, dsp56k.4, fd.4, full.4, fuse.4, hd.4, hpsa.4, initrd.4, intro.4, lirc.4, loop.4, lp.4, mem.4, mouse.4, msr.4, null.4, pts.4, ram.4, random.4, rtc.4, sd.4, sk98lin.4, smartpqi.4, st.4, tty.4, ttyS.4, vcs.4, veth.4, wavelan.4, acct.5, charmap.5, core.5, dir_colors.5, elf.5, filesystems.5, ftpusers.5, gai.conf.5, group.5, host.conf.5, hosts.5, hosts.equiv.5, intro.5, issue.5, locale.5, motd.5, networks.5, nologin.5, nscd.conf.5, nss.5, nsswitch.conf.5, passwd.5, proc.5, protocols.5, repertoiremap.5, resolv.conf.5, rpc.5, securetty.5, services.5, shells.5, slabinfo.5, sysfs.5, termcap.5, tmpfs.5, ttytype.5, tzfile.5, utmp.5, intro.6, address_families.7, aio.7, armscii-8.7, arp.7, ascii.7, attributes.7, boot.7, bootparam.7, bpf-helpers.7, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, complex.7, cp1251.7, cp1252.7, cpuset.7, credentials.7, ddp.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, fifo.7, futex.7, glob.7, hier.7, hostname.7, icmp.7, inode.7, inotify.7, intro.7, ip.7, ipc_namespaces.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, kernel_lockdown.7, keyrings.7, koi8-r.7, koi8-u.7, landlock.7, libc.7, locale.7, mailaddr.7, man-pages.7, man.7, math_error.7, mount_namespaces.7, mq_overview.7, namespaces.7, netdevice.7, netlink.7, network_namespaces.7, nptl.7, numa.7, operator.7, packet.7, path_resolution.7, persistent-keyring.7, pid_namespaces.7, pipe.7, pkeys.7, posixoptions.7, process-keyring.7, pthreads.7, pty.7, queue.7, random.7, raw.7, regex.7, rtld-audit.7, rtnetlink.7, sched.7, sem_overview.7, session-keyring.7, shm_overview.7, sigevent.7, signal-safety.7, signal.7, sock_diag.7, socket.7, spufs.7, standards.7, suffixes.7, symlink.7, system_data_types.7, sysvipc.7, tcp.7, termio.7, thread-keyring.7, time.7, time_namespaces.7, udp.7, udplite.7, unicode.7, units.7, unix.7, uri.7, user-keyring.7, user-session-keyring.7, user_namespaces.7, utf-8.7, uts_namespaces.7, vdso.7, vsock.7, x25.7, xattr.7, iconvconfig.8, intro.8, ld.so.8, ldconfig.8, nscd.8, sln.8, tzselect.8: tstamp

Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes: Ready for 6.00

Signed-off-by: Alejandro Colomar <alx@kernel.org>

pivot_root.2: Fix a typo/thinko

(To obtain a prefix of a given pathname, we have to append (suffix)
'/..' at its end.)

Signed-off-by: Štěpán Němec <stepnem@smrk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

memfd_create.2, mlock.2, poll.2, select.2, fopen.3, capabilities.7: tfix

Signed-off-by: Štěpán Němec <stepnem@smrk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

proc.5: tfix

"KernelPageSize" and "MMUPageSize" are repeated in the
/proc/[pid]/smaps format example.

Signed-off-by: Andrea Cervesato <andrea.cervesato@suse.com>
Fixes: 6861f8f0c7 "proc.5: Improve description of the KernelPageSize and [...]"
Signed-off-by: Alejandro Colomar <alx@kernel.org>

unix.7: fix section reference wrt length

The description of Linux path length handling has always been in the
BUGS section.  The commit that added this see-also note incorrectly
referred to the NOTES section instead.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

build-src.mk: Fix CPPFLAGS

'-D' flags also correspond to CPPFLAGS, not CFLAGS.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

wcsnlen.3: Fix off-by-one error

Same change as in 45323bbef7fb06eec3fa210ee6c1651bbc57c38d.

Cc: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

inet_net_pton.3: tfix

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

setxattr.2: ffix

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

kcmp.2: EXAMPLES: Make constant string be 'static const'

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Align variable declarations

Also, move some declarations to the top of functions.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

getdents.2: EXAMPLES: Use size_t for an offset

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

cmd.mk, lint-man.mk: Use variables for commands

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

lint-man.mk: Support both UTF8 and non-UTF8 systems

Systems using the C locale can now also run 'make lint', and will
test the ascii device.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Remove unused variables

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Use unsigned types for loop iterators

Looping with unsigned types is safer.  See the link below.

When the iterators are used for accessing an array, use size_t;
otherwise, use the most appropriate unsigned type, which in most
cases is just 'unsigned int'.

Also adjust other variables that have to interact with the
iterators, to avoid comparison of integers of different
signedness.

Link: <https://gustedt.wordpress.com/2013/07/15/a-praise-of-size_t-and-other-unsigned-types/>
Cc: Jens Gustedt <jens.gustedt@inria.fr>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

envz_add.3: EXAMPLES: Fix type of variable

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

printf.3: SYNOPSIS: Remove incorrect header

Reported-by: Sam James <sam@gentoo.org>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

ipv6.7: wfix

Fixes: 77117f4fc55addbb657d1c87e2f86911d7e432c9
Reported-by: Donald Buczek <buczek@molgen.mpg.de>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

semop.2: Fix truncated comment on sempid

Fixes: bdd915e20f87346dc07b93f8f26386feb92d2c44
Reported-by: GUO Zihua <guozihua@huawei.com>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

mount_setattr.2: EXAMPLES: Remove unused include

Reported-by: iwyu(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

__ppc_get_timebase.3, if_nameindex.3, rtime.3: EXAMPLES: wsfix

Reported-by: cpplint(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

setbuf.3: Don't build example program

The example program is invalid on purpose; don't build it.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Remove unused variables

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

build-src.mk, cmd.mk: Add libbsd to the build of example programs

Some programs need libbsd for using errc(3).

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

getdents.2: EXAMPLES: Sort includes

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

.checkpatch.conf: Ignore some warnings

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Use <err.h> functions

When reporting errors, prefer using conventional <err.h>
functions, rather than home-made macros.  Home-made macros are
necessary for portable programs, so in documentation about
portable functions, keep using the macros.  However, in the
documentation for functions that are only available in GNU/Linux
and/or BSD systems, prefer <err.h>, which is available in both
systems.

Do the same in example programs documenting portable functions but
in which we already require _GNU_SOURCE for some other reason.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

__ppc_get_timebase.3, __ppc_yield.3: Remove incorrect text

This was accidentally introduced in a scripted change.

Fixes: 45186a5da74285d72199744eb5d2888fe348f680
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Remove unused variables

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

matherr.3: EXAMPLES: Can't build program

The documented functions don't exist anymore.

Reported-by: clang(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

getsubopt.3: EXAMPLES: Fix indentation

Fixes: 645259f4357baa3b3931ae24c79648baa155ebdf
Fixes: 35facf001e3682c0bafbdd139d8cfc6a8cb2a301
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

getpwent_r.3: EXAMPLES: Add missing include

Reported-by: clang(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

fopencookie.3: EXAMPLES: Remove 'else' after 'return'

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

encrypt.3: SYNOPSIS: Mark functions as [[deprecated]]

These functions don't exist anymore.

Reported-by: clang(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Sort includes

Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

config.yaml: Ignore some clang-tidy warnings

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

pthread_setschedparam.3: EXAMPLES: Remove trailing semicolon in macro definition

Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

mq_getattr.3: EXAMPLES: Octal permissions are more readable

Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Use %s __func__

Instead of hardcoding the function name.

Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Fix alignment

In some cases, add braces, for readability.

Link: <https://nginx.org/en/docs/dev/development_guide.html#code_style>
Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Various pages: EXAMPLES: Separate variable declarations from the function body

Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

rtime.3: EXAMPLES: Optimize

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

bsearch.3: EXAMPLES: Use ARRAY_SIZE()

This is more generic code, and hopefully, it will inspire other to
use such a pattern.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

bsearch.3: EXAMPLES: Separate struct and variable definitions

Separate struct definition from variable definition.
Also use 'static' and 'const' when possible.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

_Generic.3: EXAMPLES: Allow taking a pointer to &my_imaxabs

And show the pointer value in the example, and show also those
of &labs and &llabs to compare.

Cc: JeanHeyd Meneide <wg14@soasis.org>
Cc: Florian Weimer <fweimer@redhat.com>
Cc: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Cc: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Many pages: EXAMPLES: Add wrapper comments SRC BEGIN and SRC END

This is used by the Makefile to extract the example program.

Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

Revert "src.mk, All pages: Move man* to man/"

This reverts commit 70ac1c4785fc1e158ab2349a962dba2526bf4fbc.

Link: <https://lore.kernel.org/linux-man/YxcV4h+Xn7cd6+q2@pevik/T/>
Reported-by: Petr Vorel <pvorel@suse.cz>
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Cc: Stefan Puiu <stefan.puiu@gmail.com>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>

unshare.2: add note about potential capabilities confusion

Link: <https://bugzilla.kernel.org/show_bug.cgi?id=216215>
Signed-off-by: Patrick Reader <_@pxeger.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

fanotify_mark.2: Document FAN_MARK_EVICTABLE

Add section about evictable inode marks and example use case.
Add possible error case EEXIST related to evictable marks.

Reviewed-by: Matthew Bobrowski <repnop@google.com>
Reviewed-by: Jan Kara <jack@suse.cz>
Signed-off-by: Amir Goldstein <amir73il@gmail.com>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

src.mk, All pages: Move man* to man/

The root of the repository is becoming a bit overpopulated and
unorganized, due to the recent addition of more mandirs, and more
informative and configuration files too.  Let's create a specific
mandir <man/> that contains the mandirs <man[1-8]*>.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

lint-man.mk: Don't discard unrecognized control sequences

This shouldn't change anything if everything is correct, but it
may help detect some weird bugs in corner cases.

Reported-by: Ralph Corderoy <ralph@inputplus.co.uk>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

Revert "lint-man.mk: Use ascii instead of utf8"

This reverts commit f1a71d4a836d48f81832415626d27521854f85c6.

The issues motivating that patch were not real, and I guess I had
another problem, probably caused by me (EBCAK).  Since I can't
reproduce the issues that lead to the change, and it's preferrable
to test exactly what users will be reading on their terminals,
let's use UTF-8 again for the tests, which is what most users will
be reading.

Reported-by: Ralph Corderoy <ralph@inputplus.co.uk>

NULL.3const: Fix TH line

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getpw.3: SYNOPSIS: Mark as [[deprecated]]

This function is insecure.  Use getpwuid(3).

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

matherr.3: SYNOPSIS: Mark as [[deprecated]]

This is no longer supported by glibc.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

__setfpucw.3: SYNOPSIS: Mark __setfpucw() as [[deprecated]]

The function doesn't exist anymore.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

ftw.3: SYNOPSIS: Mark ftw() as [[deprecated]]

Use nftw(3) instead.  ftw(3) has issues with [sig]longjmp(3).

Link: <https://stackoverflow.com/q/19617783/6872717>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

ulimit.3: SYNOPSIS: Mark ulimit() as [[deprecated]]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

ecvt.3: SYNOPSIS: Mark as [[deprecated]]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

ecvt_r.3: SYNOPSIS: Mark as [[deprecated]]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

qecvt.3: SYNOPSIS: Mark q*cvt() as [[deprecated]]

Use snprintf(3) instead.  Most Unix systems lack these functions.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

ctime.3: SYNOPSIS: Use VLA notation for [as]ctime_r() buffer

As N2417 (a proposal for C2x that was not accepted) suggests.
This syntax is very informative, and also, if used by library
implementers, can improve static analysis.

Since it is backwards compatible with pointer syntax, we can do
this.  Also, the reason for not being accepted, as Jens noted,
was incompatibility with C++.  But IMO, that's not something that
we should care too much.  Users of other languages should know
what to expect when reading C code, and are expected to know C/C++
incompatibilities.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Cc: Jens Gustedt <jens.gustedt@loria.fr>
Cc: Glibc <libc-alpha@sourceware.org>

getpass.3: SYNOPSIS: Mark getpass() as [[deprecated]]

Suggest readpassphrase(3bsd) as an alternative.

Some implementations of getpass(3) may suffer from the same issues
that gets(3) suffers and some more.  See the long discussion in
the mailing list for more details (link at the bottom of this
commit message).  I'll quote some relevant parts here:

Eugene Syromyatnikov <evgsyr@gmail.com>:
{
And the only mention of getpass() in POSIX (at least,
since the 2001's edition) indeed seems to be [1], in the
list of functions that have not been carried forward from
XSH5, the 1997 revision of “System Interfaces and Headers”
(that is, SUSv2)[2], where it is inherited from SUSv1[4]
from XPG[5] and, as Alejandro already mentioned, marked as
obsolete, per XPG3 to XPG4 migration guide[6]; the
previous, 1988, version of POSIX[3] does not mention
getpass() at all.

[1] https://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap01.html
[2] https://pubs.opengroup.org/onlinepubs/7908799/xsh/getpass.html
[3] https://mirror.math.princeton.edu/pub/oldlinux/download/c953.pdf
[4] https://pubs.opengroup.org/onlinepubs/9695969499/toc.pdf
[5] https://bitsavers.computerhistory.org/pdf/xOpen/X_Open_Portability_Guide_1985/xpg_2_xopen_system_v_specification_2.pdf
[6] http://archive.opengroup.org/publications/archive/CDROM/g501.pdf
}

Theo de Raadt <deraadt@openbsd.org>:
{
The community finally had the balls to get rid of gets(3).

getpass(3) shares the same flaw, that the buffer size
isn't passed.  This has been an issue in the past, and
incorrectly led to readpassphrase(3).

readpassphrase(3) has a few too many features/extensions
for my taste, but at least it is harder to abuse.
}

Alejandro Colomar <alx.manpages@gmail.com>:
{
I found readpassphrase(3) in FreeBSD and OpenBSD.  It is
also present in libbsd(7), which is available in most
Linux distributions.  I also found it on a Mac that I have
access.

NetBSD has getpass_r(3) instead.  It is not in any other
system I have access.
}

Zack Weinberg <zack@owlfolio.org>:
{
I was about to post exactly the same thing.  getpass(3)
is not deprecated because there's a better replacement,
it's deprecated because it's _unsafe_.  The glibc
implementation wraps getline(3) and therefore  doesn't
truncate the passphrase or overflow a fixed-size buffer,
no matter how long the input is, but portable code cannot
rely on that.  And come to think of it, using getline(3)
means that prefixes of the passphrase may be left lying
around in malloc's free lists.

(getpass also cannot be made thread safe, due to recycling
of a static buffer, but a program in which multiple
threads are racing to prompt the user for passwords would
be a UX disaster anyway, so I don't think that's a
critical flaw the way it is for e.g. strtok(3).)

The Linux manpage project's documentation is, as I
understand it, for Linux with glibc _first_, but not
_only_; it should not describe this function as
not-deprecated just because glibc has patched its worst
problems and doesn't offer any better API.
}

List: <https://lore.kernel.org/linux-man/6d8642e9-71f7-4a83-9791-880d04f67d17@www.fastmail.com/T/#t>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Cc: Git <git@vger.kernel.org>
Cc: Glibc <libc-alpha@sourceware.org>
Cc: OpenBSD <tech@openbsd.org>
Cc: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Cc: Benoit Lecocq <benoit@openbsd.org>
Cc: Klemens Nanni <kn@openbsd.org>
Cc: Randall <rsbecker@nexbridge.com>
Cc: Eugene Syromyatnikov <evgsyr@gmail.com>
Cc: Theo de Raadt <deraadt@openbsd.org>
Cc: Zack Weinberg <zack@owlfolio.org>
Cc: Florian Weimer <libc-alpha@sourceware.org>

gsignal.3: SYNOPSIS: Mark [gs]signal() as [[deprecated]]

They are obsolete in other systems, and broken in glibc.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

re_comp.3: SYNOPSIS: Mark these functions as [[deprecated]]

They are MT unsafe, and replaced by the MT-safe POSIX regex(3)
functions.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

rexec.3: SYNOPSIS: Mark rexec*() as [[deprecated]]

They are insecure, and replaced by rcmd(3).

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

toascii.3: SYNOPSIS: Mark toascii() as [[deprecated]]

It cannot be used portably in a localized application.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

scalb.3: SYNOPSIS: Mark these functions as [[deprecated]]

Use scalbn(3) instead.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getcwd.3: SYNOPSIS: Use VLA notation for getwd()'s argument

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

gethostbyname.3: Move non-deprecated functions to the top

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

gethostbyname.3: SYNOPSIS: Mark several symbols as [[deprecated]]

*hostent*() are the only ones that are not deprecated, AFAICS.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

bcmp.3: SYNOPSIS: Mark bcmp() as [[deprecated]]

Use memcmp(3) instead.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

gets.3: SYNOPSIS: Mark gets() as [[deprecated]]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

resolver.3: SYNOPSIS: Use [[deprecated]] instead of a 'Deprecated' subsection

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

perror.3: SYNOPSIS: Mark sys_errlist[] and sys_nerr as [[deprecated]]

They are no longer exposed by glibc.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getcwd.3: SYNOPSIS: Mark getwd() as [[deprecated]]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

strsignal.3: SYNOPSIS: Mark sys_siglist[] as [[deprecated]]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

inet.3: SYNOPSIS: Mark inet_ntoa() as [[deprecated]]

See inet_ntop(3).

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

strcpy.3: SYNOPSIS: Add missing 'restrict'

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

pthread_mutexattr_setrobust.3: SYNOPSIS: Mark *_np() old functions as [[deprecated]]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

readdir_r.3: SYNOPSIS: Mark as [[deprecated]]

Glibc:

dirent/dirent.h:183:
extern int readdir_r (DIR *__restrict __dirp,
                      struct dirent *__restrict __entry,
                      struct dirent **__restrict __result)
     __nonnull ((1, 2, 3)) __attribute_deprecated__;

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

pthread_yield.3: SYNOPSIS: Mark as [[deprecated]]

sched_yield(3) is identical and is in POSIX.
See glibc commit c2fd60a5861efef48252f5cc7efc70e1d8a0da9a.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

getipnodebyname.3: SYNOPSIS: Mark as [[deprecated]]

These functions are not anymore in glibc.  All other systems
call them deprecated.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

gamma.3: SYNOPSIS: Mark as [[deprecated]]

These functions are misleading, and in some systems mean a
different thing (tgamma(3) vs lgamma(3)).  Never use gamma(3).

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

bcopy.3: SYNOPSIS: Mark as [[deprecated]]

memmove(3) completely replaces bcopy(3), being an almost identical
function, except for the different order in the arguments.

memmove(3) is part of ISO C and POSIX.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

uselib.2: SYNOPSIS: Mark as [[deprecated]]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

sysfs.2: SYNOPSIS: Mark as [[deprecated]]

Use proc(5) instead.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

setpgid.2: SYNOPSIS: Mark BSD versions of getpgrp() and setpgrp() as [[deprecated]]

The BSD version of getpgrp(2) was superseeded by the POSIX one.
The BSD version of setpgrp(2) was superseeded by the POSIX one.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

futimesat.2: SYNOPSIS: Mark as [[deprecated]]

Use utimensat(2) instead.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

sgetmask.2: SYNOPSIS: Mark as [[deprecated]]

Use sigprocmask(2) instead.

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

tkill.2: SYNOPSIS: Mark tkill() as [[deprecated]]

tkill(2) has been superseeded by tgkill(2).

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

sysctl.2: SYNOPSIS: Mark as [[deprecated]]

This syscall no longer exists!

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>

pthread_mutex_consistent.3: Mark *_np() old function as [[deprecated]]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>