]>
git.ipfire.org Git - thirdparty/man-pages.git/log
Alejandro Colomar [Thu, 20 Oct 2022 16:34:43 +0000 (18:34 +0200)]
README: Remove version from LSM file name
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 20 Oct 2022 16:32:49 +0000 (18:32 +0200)]
RELEASE, man-pages.lsm: Remove version from LSM file name
It's not necessary, and removing it simplifies maintenance.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 20 Oct 2022 16:27:43 +0000 (18:27 +0200)]
RELEASE, man-pages-6.01.Announce: Remove .Announce file
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Thu, 20 Oct 2022 16:20:13 +0000 (18:20 +0200)]
README: Rewrite and expand
Let's start making the repository self-contained. The README
should be enough to guide a user into everything that has to do
with the project. The website should be a secondary source, for
those who don't know about the repository yet.
I merged some of the information found in the .Announce file,
which I'll remove.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 19 Oct 2022 14:07:09 +0000 (16:07 +0200)]
lsm: Fix Title and Description
Use the project name for the Title, and a descriptive Description.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 19 Oct 2022 14:00:58 +0000 (16:00 +0200)]
lsm: Author: Remove field
The parser failed to understand several. Since there's nothing
useful we can put there that the parser would accept, just remove
the field.
Acked-by: Aaron Schrab <aaron@schrab.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 19 Oct 2022 13:06:28 +0000 (15:06 +0200)]
RELEASE: Remind to push the git tag
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 19 Oct 2022 13:01:59 +0000 (15:01 +0200)]
RELEASE: Add missing cd(1)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 19 Oct 2022 12:45:29 +0000 (14:45 +0200)]
INSTALL, RELEASE: Add RELEASE file with instructions for releasing
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Wed, 19 Oct 2022 11:08:24 +0000 (13:08 +0200)]
Changes.old: tfix
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 18 Oct 2022 19:29:11 +0000 (21:29 +0200)]
Revert "cmd.mk, install.mk: Avoid modifying existing directories at 'make install'"
This reverts commit
12b6045567037e783d0c3a79f276a15fd748d3a6 .
There was no bug, since make(1) only tries to install the
directory if there was no directory at all. I was confused.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 18 Oct 2022 19:15:02 +0000 (21:15 +0200)]
cmd.mk, install.mk: Avoid modifying existing directories at 'make install'
'install -d' has an issue compared to 'mkdir -p': it doesn't
respect existing directories. It will set the ownership, file
mode, and SELinux contexts (and any other property that would be
set by install(1) to a newly-created directory), overwriting any
existing properties of the existing directory.
'mkdir -p' doesn't have this issue: it is a no-op if the
directory exists. However, it's not an ideal solution either,
since it can't be used to set the properties (owner, mode, ...) of
a newly-created directory.
Therefore, the best solution is to use install(1), but only after
making sure that the directory doesn't exist with test(1).
Reported-by: Andrew Clayton <a.clayton@nginx.com>
Reported-by: Alejandro Colomar <alx@nginx.com>
Link: <https://github.com/nginx/unit/issues/769>
Signed-off-by: Alejandro Colomar <alx@nginx.com>
Alejandro Colomar [Tue, 18 Oct 2022 19:13:01 +0000 (21:13 +0200)]
cmd.mk, install.mk: Move command definitions to cmd.mk
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 18 Oct 2022 18:34:13 +0000 (20:34 +0200)]
Start of man-pages-NEXT: Move Changes to Changes.old
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 18 Oct 2022 18:20:11 +0000 (20:20 +0200)]
Ready for 6.01
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 18 Oct 2022 18:13:31 +0000 (20:13 +0200)]
Changes: Ready for 6.01
A few useful commands:
List of contributors:
$ git log man-pages-6.00..HEAD \
| grep '<.*@.*>' \
| sed 's/^ *//' \
| sed 's/[^:]*: //' \
| sort \
| uniq;
List of new pages:
$ git diff man-pages-6.00..HEAD \
| grep -A1 '^--- /dev/null' \
| grep -v -e '\--' -e '\--- /dev/null' \
| sed 's,+++ b/,,' \
| grep '^man' \
| xargs grep -l '^\.so ' \
| sed 's,.*/,,';
List of new links:
$ git diff man-pages-6.00..HEAD \
| grep -A1 '^--- /dev/null' \
| grep -v -e '\--' -e '\--- /dev/null' \
| sed 's,+++ b/,,' \
| grep '^man' \
| xargs grep -L '^\.so ' \
| sed 's,.*/,,';
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 18 Oct 2022 17:43:50 +0000 (19:43 +0200)]
ferror.3: CAVEATS: Need to get EOF before calling these functions
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Fri, 14 Oct 2022 19:15:28 +0000 (21:15 +0200)]
EOF.3const: Add documentation for EOF
Reported-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 18 Oct 2022 17:27:44 +0000 (19:27 +0200)]
Makefile: Document the V verbose variable
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 18 Oct 2022 17:20:44 +0000 (19:20 +0200)]
Makefile, build-src.mk, dist.mk, verbose.mk, version.mk: Hide errors unless V is defined
Some commands run by the makefiles are not strictly needed by most
users or packagers. Do not print errors if those fail spuriously.
However, since we still want to see those errors in some cases,
use the V variable to conditionally print those errors.
Reported-by: Pierre Labastie <pierre.labastie@neuf.fr>
Cc: Agostino Sarubbo <ago@gentoo.org>
Cc: Mike Gilbert <floppym@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Michael Tokarev [Tue, 18 Oct 2022 08:24:45 +0000 (11:24 +0300)]
system_data_types.7: fix typo in regmatch_t description
The description of rm_eo in regmatch_t structure has a typo
which makes it difficult to understand. Fix this.
Reported-By: Nicolás A. Ortega Froysa <nicolas@ortegas.org>
Signed-off-By: Michael Tokarev <mjt@tls.msk.ru>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Sam James [Thu, 13 Oct 2022 20:58:52 +0000 (21:58 +0100)]
feature_test_macros.7: document _TIME_BITS (time64)
Some notes:
* glibc is the only libc I'm aware of implementing _TIME_BITS for time64
compatibility. It was introduced in glibc-2.34;
* musl libc made a hard switch in 1.2.0, see https://musl.libc.org/time64.html;
* Using _TIME_BITS=64 with glibc requires _FILE_OFFSET_BITS=64 (which is used
for Large File Support)! Extraordinary claims require (some) evidence, so see
https://sourceware.org/git/?p=glibc.git;a=blob;f=sysdeps/unix/sysv/linux/features-time64.h;h=
84d56ee3ff2ecfa0d2499385623f30606f84a1bf .
Reference: https://wiki.gentoo.org/wiki/Project:Toolchain/time64_migration
Reference: https://sourceware.org/pipermail/libc-alpha/2022-January/134985.html
Signed-off-by: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Sam James [Thu, 13 Oct 2022 20:58:51 +0000 (21:58 +0100)]
time_t.3type: reference _TIME_BITS (time64)
Just like we do with _FILE_OFFSET_BITS in off_t.3type.
Reference: https://wiki.gentoo.org/wiki/Project:Toolchain/time64_migration
Reference: https://sourceware.org/pipermail/libc-alpha/2022-January/134985.html
Signed-off-by: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Sam James [Thu, 13 Oct 2022 21:06:26 +0000 (22:06 +0100)]
feature_test_macros.7: document -D_FORTIFY_SOURCE=3
Reference: https://developers.redhat.com/blog/2021/04/16/broadening-compiler-checks-for-buffer-overflows-in-_fortify_source
Reference: https://developers.redhat.com/articles/2022/09/17/gccs-new-fortification-level
Signed-off-by: Sam James <sam@gentoo.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Eric Biggers [Tue, 11 Oct 2022 22:59:14 +0000 (15:59 -0700)]
statx.2, open.2: document STATX_DIOALIGN
Document the STATX_DIOALIGN support for statx()
(https://git.kernel.org/linus/
725737e7c21d2d25 ).
Reviewed-by: Darrick J. Wong <djwong@kernel.org>
Signed-off-by: Eric Biggers <ebiggers@google.com>
[ steve: wfix ]
Cc: Steve Izma <sizma@golden.net>
[ alx: srcfix ]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 9 Oct 2022 16:02:16 +0000 (18:02 +0200)]
dist.mk, All pages: .TH: Generate date at 'make dist'
Replace the date by a placeholder (date) in the repo, as we're
doing with the version (unreleased). It will be filled when the
tarball is generated with 'make dist' (or equivalent) with the
date of the most recent git commit that modifies the page (as was
done previously by update_timestamps.sh, which has been removed).
Scripted change (mostly):
$ find man* -type f \
| xargs sed -Ei '/^\.TH /s/.TH +([^ ]+ +[^ ]+) +[^ ]+ +(.*)/.TH \1 (date) \2/'
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Jakub Wilk [Tue, 11 Oct 2022 06:31:18 +0000 (08:31 +0200)]
Changes: tfix
The past participle of "spread" is just "spread".
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Jakub Wilk [Tue, 11 Oct 2022 06:25:20 +0000 (08:25 +0200)]
prctl.2: tfix
Escape hyphens.
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Tue, 11 Oct 2022 20:50:24 +0000 (22:50 +0200)]
hier.7: tfix
Reported-by: Grigoriy <grigoriyremvar@protonmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Amir Goldstein [Fri, 7 Oct 2022 06:13:28 +0000 (09:13 +0300)]
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>
Alejandro Colomar [Tue, 11 Oct 2022 20:40:50 +0000 (22:40 +0200)]
Start of man-pages-NEXT: Move Changes to Changes.old
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 9 Oct 2022 16:02:16 +0000 (18:02 +0200)]
Ready for 6.00
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 9 Oct 2022 15:34:19 +0000 (17:34 +0200)]
update_timestamps.sh: Ignore inexistent files
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alejandro Colomar [Sun, 9 Oct 2022 15:32:18 +0000 (17:32 +0200)]
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>
Alejandro Colomar [Sun, 9 Oct 2022 15:19:36 +0000 (17:19 +0200)]
Changes: Ready for 6.00
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Štěpán Němec [Sat, 8 Oct 2022 14:05:14 +0000 (16:05 +0200)]
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>
Štěpán Němec [Sat, 8 Oct 2022 14:05:13 +0000 (16:05 +0200)]
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>
Andrea Cervesato [Thu, 6 Oct 2022 13:06:56 +0000 (15:06 +0200)]
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>
Mike Frysinger [Tue, 27 Sep 2022 07:41:32 +0000 (13:26 +0545)]
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>
Alejandro Colomar [Thu, 29 Sep 2022 15:56:22 +0000 (17:56 +0200)]
build-src.mk: Fix CPPFLAGS
'-D' flags also correspond to CPPFLAGS, not CFLAGS.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Alex Colomar [Sun, 18 Sep 2022 11:38:20 +0000 (13:38 +0200)]
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>
Alex Colomar [Sat, 17 Sep 2022 17:21:06 +0000 (19:21 +0200)]
inet_net_pton.3: tfix
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Sat, 17 Sep 2022 15:19:56 +0000 (17:19 +0200)]
setxattr.2: ffix
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Thu, 15 Sep 2022 22:09:59 +0000 (00:09 +0200)]
kcmp.2: EXAMPLES: Make constant string be 'static const'
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Thu, 15 Sep 2022 22:08:46 +0000 (00:08 +0200)]
Various pages: EXAMPLES: Align variable declarations
Also, move some declarations to the top of functions.
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Thu, 15 Sep 2022 21:52:10 +0000 (23:52 +0200)]
getdents.2: EXAMPLES: Use size_t for an offset
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Thu, 15 Sep 2022 20:02:01 +0000 (22:02 +0200)]
cmd.mk, lint-man.mk: Use variables for commands
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Thu, 15 Sep 2022 19:58:13 +0000 (21:58 +0200)]
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>
Alex Colomar [Thu, 15 Sep 2022 16:13:05 +0000 (18:13 +0200)]
Various pages: EXAMPLES: Remove unused variables
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Thu, 15 Sep 2022 14:40:27 +0000 (16:40 +0200)]
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>
Alex Colomar [Thu, 15 Sep 2022 13:52:56 +0000 (15:52 +0200)]
envz_add.3: EXAMPLES: Fix type of variable
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Thu, 15 Sep 2022 13:34:26 +0000 (15:34 +0200)]
printf.3: SYNOPSIS: Remove incorrect header
Reported-by: Sam James <sam@gentoo.org>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Thu, 15 Sep 2022 13:06:33 +0000 (15:06 +0200)]
ipv6.7: wfix
Fixes: 77117f4fc55addbb657d1c87e2f86911d7e432c9
Reported-by: Donald Buczek <buczek@molgen.mpg.de>
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Thu, 15 Sep 2022 12:59:27 +0000 (14:59 +0200)]
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>
Alex Colomar [Tue, 13 Sep 2022 14:46:47 +0000 (16:46 +0200)]
mount_setattr.2: EXAMPLES: Remove unused include
Reported-by: iwyu(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Tue, 13 Sep 2022 14:34:15 +0000 (16:34 +0200)]
__ppc_get_timebase.3, if_nameindex.3, rtime.3: EXAMPLES: wsfix
Reported-by: cpplint(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Tue, 13 Sep 2022 13:58:14 +0000 (15:58 +0200)]
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>
Alex Colomar [Tue, 13 Sep 2022 13:57:37 +0000 (15:57 +0200)]
Various pages: EXAMPLES: Remove unused variables
Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Tue, 13 Sep 2022 13:42:42 +0000 (15:42 +0200)]
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>
Alex Colomar [Tue, 13 Sep 2022 13:20:12 +0000 (15:20 +0200)]
getdents.2: EXAMPLES: Sort includes
Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alejandro Colomar [Tue, 13 Sep 2022 13:13:25 +0000 (15:13 +0200)]
.checkpatch.conf: Ignore some warnings
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Alex Colomar [Mon, 12 Sep 2022 22:56:22 +0000 (00:56 +0200)]
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>
Alex Colomar [Mon, 12 Sep 2022 22:24:28 +0000 (00:24 +0200)]
__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>
Alex Colomar [Mon, 12 Sep 2022 16:54:07 +0000 (18:54 +0200)]
Various pages: EXAMPLES: Remove unused variables
Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Mon, 12 Sep 2022 16:53:30 +0000 (18:53 +0200)]
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>
Alex Colomar [Mon, 12 Sep 2022 16:16:54 +0000 (18:16 +0200)]
getsubopt.3: EXAMPLES: Fix indentation
Fixes: 645259f4357baa3b3931ae24c79648baa155ebdf
Fixes: 35facf001e3682c0bafbdd139d8cfc6a8cb2a301
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Mon, 12 Sep 2022 16:07:40 +0000 (18:07 +0200)]
getpwent_r.3: EXAMPLES: Add missing include
Reported-by: clang(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Mon, 12 Sep 2022 15:06:31 +0000 (17:06 +0200)]
fopencookie.3: EXAMPLES: Remove 'else' after 'return'
Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Mon, 12 Sep 2022 15:05:23 +0000 (17:05 +0200)]
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>
Alex Colomar [Mon, 12 Sep 2022 15:03:08 +0000 (17:03 +0200)]
Various pages: EXAMPLES: Sort includes
Reported-by: clang-tidy(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Sat, 10 Sep 2022 23:10:12 +0000 (01:10 +0200)]
config.yaml: Ignore some clang-tidy warnings
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Sat, 10 Sep 2022 23:00:14 +0000 (01:00 +0200)]
pthread_setschedparam.3: EXAMPLES: Remove trailing semicolon in macro definition
Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Sat, 10 Sep 2022 22:59:28 +0000 (00:59 +0200)]
mq_getattr.3: EXAMPLES: Octal permissions are more readable
Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Sat, 10 Sep 2022 22:59:05 +0000 (00:59 +0200)]
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>
Alex Colomar [Sat, 10 Sep 2022 22:57:38 +0000 (00:57 +0200)]
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>
Alex Colomar [Sat, 10 Sep 2022 22:54:53 +0000 (00:54 +0200)]
Various pages: EXAMPLES: Separate variable declarations from the function body
Reported-by: checkpatch(1)
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Sat, 10 Sep 2022 22:40:53 +0000 (00:40 +0200)]
rtime.3: EXAMPLES: Optimize
Signed-off-by: Alex Colomar <alx.manpages@gmail.com>
Alex Colomar [Sat, 10 Sep 2022 21:45:37 +0000 (23:45 +0200)]
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>
Alex Colomar [Sat, 10 Sep 2022 21:42:09 +0000 (23:42 +0200)]
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>
Alex Colomar [Sat, 10 Sep 2022 21:28:15 +0000 (23:28 +0200)]
_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>
Alejandro Colomar [Sat, 10 Sep 2022 21:21:45 +0000 (23:21 +0200)]
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>
Alejandro Colomar [Fri, 9 Sep 2022 12:15:08 +0000 (14:15 +0200)]
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>
Patrick Reader [Tue, 6 Sep 2022 08:49:16 +0000 (09:49 +0100)]
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>
Amir Goldstein [Tue, 6 Sep 2022 10:18:27 +0000 (13:18 +0300)]
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>
Alejandro Colomar [Mon, 5 Sep 2022 21:03:38 +0000 (23:03 +0200)]
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>
Alejandro Colomar [Mon, 5 Sep 2022 11:43:36 +0000 (13:43 +0200)]
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>
Alejandro Colomar [Mon, 5 Sep 2022 11:38:33 +0000 (13:38 +0200)]
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>
Alejandro Colomar [Mon, 5 Sep 2022 02:24:14 +0000 (04:24 +0200)]
NULL.3const: Fix TH line
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Alejandro Colomar [Sat, 30 Oct 2021 13:29:07 +0000 (15:29 +0200)]
getpw.3: SYNOPSIS: Mark as [[deprecated]]
This function is insecure. Use getpwuid(3).
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Alejandro Colomar [Sat, 30 Oct 2021 13:09:16 +0000 (15:09 +0200)]
matherr.3: SYNOPSIS: Mark as [[deprecated]]
This is no longer supported by glibc.
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Alejandro Colomar [Sat, 30 Oct 2021 12:56:08 +0000 (14:56 +0200)]
__setfpucw.3: SYNOPSIS: Mark __setfpucw() as [[deprecated]]
The function doesn't exist anymore.
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Alejandro Colomar [Sat, 30 Oct 2021 12:54:03 +0000 (14:54 +0200)]
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>
Alejandro Colomar [Sat, 30 Oct 2021 12:49:23 +0000 (14:49 +0200)]
ulimit.3: SYNOPSIS: Mark ulimit() as [[deprecated]]
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Alejandro Colomar [Mon, 5 Sep 2022 02:02:07 +0000 (04:02 +0200)]
ecvt.3: SYNOPSIS: Mark as [[deprecated]]
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Alejandro Colomar [Sat, 30 Oct 2021 13:14:25 +0000 (15:14 +0200)]
ecvt_r.3: SYNOPSIS: Mark as [[deprecated]]
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Alejandro Colomar [Sat, 30 Oct 2021 12:47:27 +0000 (14:47 +0200)]
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>
Alejandro Colomar [Wed, 20 Oct 2021 15:46:20 +0000 (17:46 +0200)]
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>
Alejandro Colomar [Fri, 29 Oct 2021 15:07:37 +0000 (17:07 +0200)]
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>
Alejandro Colomar [Fri, 29 Oct 2021 11:21:23 +0000 (13:21 +0200)]
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>
Alejandro Colomar [Fri, 29 Oct 2021 10:44:40 +0000 (12:44 +0200)]
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>