CONTRIBUTING.d/patches: wfix

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

CONTRIBUTING.d/patches: Clarify that [PATCH v1] is also valid

And actually, preferable.  Thus, use it in all examples.

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

CONTRIBUTING.d/patches: Say [PATCH] instead of [patch]

Patches are usually generated by git-format-patch(1), which says
[PATCH], not [patch].  To avoid confusion, use the same form here.

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

CONTRIBUTING.d/mail: Remove broken links

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

man/: ffix

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

man/: srcfix: Use \[rs] instead of \e

Scripted change:

$ find man -type f \
| xargs grep -l '\\e' \
| xargs sed -i 's/\\e/\\[rs]/g';

Link: <https://lore.kernel.org/linux-man/20240611122453.qn6jyl4go4bvwkqm@illithid/>
Suggested-by: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: lint-man-so: Skip man.7

We purposefully point to groff_man(7), which is not in this project.

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

share/mk/: lint-man-so: Check that .so link pages point to an existing file

Cc: Adam Sampson <ats@offog.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: lint-man: Merge linting of man(7) and mdoc(7) pages

This simplifies some code, and is also in preparation for the following
commit, which will add more linting operations on both types of manual
pages.

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

share/mk/: $CUT: Add dependency on cut(1)

We'll need it for checking the .so link pages.

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

FICLONERANGE.2const: Update .so for renamed file

Fixes: 733e3228017b ("ioctl.2, ioctl_ficlone*.2, FICLONE{,RANGE}.2const: Move page to FICLONE.2const")
Signed-off-by: Adam Sampson <ats@offog.org>
Message-ID: <20240615132948.20625-1-ats@offog.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

Changes.old: Fix some mistakes

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>

lsm: Released 6.9

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

Changes: Ready for 6.9

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

RELEASE: Document how to obtain a list of contributors

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

bpf-helpers.7: Refresh page

Scripted change:

$ ~/src/linux/linux/6/6.9/scripts/bpf_doc.py \
| rst2man \
>man7/bpf-helpers.7;

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

ioctl*(2), man2const/: Make sashimi and reorganize these pages

ioctl_*.2: De-duplicate references

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

ioctl_userfaultfd.2, UFFDIO_*.2const: Make sashimi

ioctl_userfaultfd.2: Tweak after making sashimi of this page

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

share/mk/: Skip spurious warnings from mandoc(1)

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

UFFDIO_POISON.2const: Tweak after split

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

ioctl_userfaultfd.2, UFFDIO_POISON.2const: Split UFFDIO_POISON from ioctl_userfaultfd(2)

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

UFFDIO_CONTINUE.2const: Tweak after split

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

ioctl_userfaultfd.2, UFFDIO_CONTINUE.2const: Split UFFDIO_CONTINUE from ioctl_userfaultfd(2)

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

UFFDIO_WRITEPROTECT.2const: Tweak after split

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

ioctl_userfaultfd.2, UFFDIO_WRITEPROTECT.2const: Split UFFDIO_WRITEPROTECT from ioctl_userfaultfd(2)

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

UFFDIO_WAKE.2const: Tweak after split

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

ioctl_userfaultfd.2, UFFDIO_WAKE.2const: Split UFFDIO_WAKE from ioctl_userfaultfd(2)

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

UFFDIO_ZEROPAGE.2const: Tweak after split

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

ioctl_userfaultfd.2, UFFDIO_ZEROPAGE.2const: Split UFFDIO_ZEROPAGE from ioctl_userfaultfd(2)

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

UFFDIO_COPY.2const: Tweak after split

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

ioctl_userfaultfd.2, UFFDIO_COPY.2const: Split UFFDIO_COPY from ioctl_userfaultfd(2)

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

UFFDIO_UNREGISTER.2const: Tweak after split

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

ioctl_userfaultfd.2, UFFDIO_UNREGISTER.2const: Split UFFDIO_UNREGISTER from ioctl_userfaultfd(2)

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

UFFDIO_REGISTER.2const: Tweak after split

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

ioctl_userfaultfd.2, UFFDIO_REGISTER.2const: Split UFFDIO_REGISTER from ioctl_userfaultfd(2)

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

UFFDIO_API.2const: Tweak after split

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

ioctl_userfaultfd.2, UFFDIO_API.2const: Split UFFDIO_API from ioctl_userfaultfd(2)

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

ioctl_tty.2, man2const/: Make sashimi

ioctl_tty.2, TIOCTTYGSTRUCT.2const: Split TIOCTTYGSTRUCT from ioctl_tty(2)

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

ioctl_tty.2, TIOC[SG]SOFTCAR.2const: Split TIOC[SG]SOFTCAR from ioctl_tty(2)

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

ioctl_tty.2, TIOCM{[SG]ET,BI[CS],IWAIT}.2const, TIOCGICOUNT.2const: Split TIOC* from ioctl_tty(2)

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

TIOCPKT.2const: Tweak after split

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

ioctl_tty.2, TIOC[G]PKT.2const, TIOC[SG]PTLCK.2const, TIOCGPTPEER.2const: Split TIOC* from ioctl_tty(2)

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

ioctl_tty.2: Fix constness of arguments

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

ioctl_tty.2, TIOC[SG]ETD.2const: Split TIOC[SG]ETD from ioctl_tty(2)

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

TIOCEXCL.2const: Tweak after split

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

ioctl_tty.2, TIOC{E,GE,N}XCL.2const: Split TIOC*XCL from ioctl_tty(2)

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

ioctl_tty.2, TIOC[SG]PGRP.2const, TIOCGSID.2const: Split TIOC* from ioctl_tty(2)

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

ioctl_tty.2, TIOC{NO,SC}TTY.2const: Split TIOC*TTY from ioctl_tty(2)

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

TIOCCONS.2const: Tweak after split

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

ioctl_tty.2, TIOCCONS.2const: Split TIOCCONS from ioctl_tty(2)

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

TIOCSTI.2const: Tweak after split

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

ioctl_tty.2, TIOCSTI.2const: Split TIOCSTI from ioctl_tty(2)

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

ioctl_tty.2, FIONREAD.2const, TIOC{IN,OUT}Q.2const, TCFLSH.2const, TIOCSERGETLSR.2const: Split from ioctl_tty(2)

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

TCXONC.2const: Tweak after split

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

ioctl_tty.2, TCXONC.2const: Split TCXONC from ioctl_tty(2)

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

ioctl_tty.2, T*BRK*.2const: Split T*BRK* from ioctl_tty(2)

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

ioctl_tty.2, TIOC[SG]LCKTRMIOS.2const: Split TIOC[SG]LCKTRMIOS from ioctl_tty(2)

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

TIOCSWINSZ.2const: Tweak after split

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

ioctl_tty.2, TIOC[SG]WINSZ.2const: Split TIOC[SG]WINSZ from ioctl_tty(2)

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

share/mk/: Skip expected warnings

Due to missing 'U' suffixes in UAPI constants.

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

TCSETS.2const: Tweak after split

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

ioctl.2, ioctl_fsmap.2, FS_IOC_GETFSMAP.2const: ioctl_getfsmap(2) => ioctl_fsmap(2)

This name makes it consistent with the header file <linux/fsmap.h>.

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

ioctl_tty.2, TC[SG]ET*.2const: Split TC[SG]ET* from ioctl_tty(2)

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

ioctl_ns.2, ioctl_nsfs.2: Rename page, and make sashimi

ioctl_tty.2: Tweak in preparation for sashimi

-  Move paragraph to CAVEATS.
-  Reword RETURN VALUE for consistency with other pages.
-  Remove some ERRORS that are redundant with ioctl(2).
-  Remove ENOIOCTLCMD; this error doesn't exist in user space.
-  Document includes and structures in SYNOPSIS properly.

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

ioctl_nsfs.2: Tweak after making sashimi of this page

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

NS_GET_OWNER_UID.2const: Tweak after split

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

ioctl_nsfs.2, NS_GET_OWNER_UID.2const: Split NS_GET_OWNER_UID from ioctl_nsfs(2)

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

NS_GET_NSTYPE.2const: Tweak after split

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

ioctl_nsfs.2, NS_GET_NSTYPE.2const: Split NS_GET_NSTYPE from ioctl_nsfs(2)

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

ioctl_fs.2, man/: Reorganize <linux/fs.h> ioctl(2)s

NS_GET_USERNS.2const: Tweak after split

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

ioctl_nsfs.2, NS_GET_{USERNS,PARENT}.2const: Split NS_GET_* from ioctl_nsfs(2)

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

ioctl_ns.2, ioctl_nsfs.2, man/: Move page to ioctl_nsfs.2

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

ioctl.2, ioctl_fs.2: Add overview page for <linux/fs.h> ioctl(2)s

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

share/mk/: Skip spurious warning from mandoc(1)

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

ioctl.2, PAGEMAP_SCAN.2const: Move page to PAGEMAP_SCAN.2const

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

ioctl_pagemap_scan.2: Move structure definitions to SYNOPSIS

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

ioctl_iflags.2, FS_IOC_[GS]ETFLAGS.2const, man/: Move page to FS_IOC_SETFLAGS.2const

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

ioctl.2, ioctl_fslabel.2, FS_IOC_[GS]ETFSLABEL.2const: Move page to FS_IOC_SETFSLABEL.2const

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

ioctl.2, ioctl_fideduperange.2, FIDEDUPERANGE.2const: Move page to FIDEDUPERANGE.2const

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

ioctl.2, ioctl_ficlone*.2, FICLONE{,RANGE}.2const: Move page to FICLONE.2const

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

ioctl_fat.2, man2const/: Make sashimi

ioctl_fat.2, VFAT_IOCTL_READDIR_{BOTH,SHORT}.2const: Split VFAT_IOCTL_READDIR_* from ioctl_fat(2)

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

ioctl_fat.2, FAT_IOCTL_GET_VOLUME_ID.2const: Split FAT_IOCTL_GET_VOLUME_ID from ioctl_fat(2)

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

ioctl_console.2, ioctl_kd.2, ioctl_vt.2, man2const/: Make sashimi

ioctl_fat.2, FAT_IOCTL_[GS]ET_ATTRIBUTES.2const: Split FAT_IOCTL_[GS]ET_ATTRIBUTES from ioctl_fat(2)

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

ioctl_console.2: Tweak after making sashimi of this page

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

ioctl_kd.2: Tweak after split

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

ioctl_console.2, ioctl_kd.2, man2const/: Split ioctl_kd(2) from ioctl_console(2)

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

ioctl_vt.2: Tweak after split

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

ioctl_console.2, ioctl_vt.2, VT_*.2const: Split VT_* from ioctl_console(2)

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

TIOCLINUX.2const: Tweak after split

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

ioctl_console.2, TIOCLINUX.2const: Split TIOCLINUX from ioctl_console(2)

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

ioctl_console.2: SYNOPSIS: Add section

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

sched_setattr.2: Document sched_util_{min,max}

Utilization attributes were added in Linux v5.3 via commit a509a7cd7974
("sched/uclamp: Extend sched_setattr() to support utilization
clamping"). Borrow some documentation from there, with a bit of
editorial trimming and augmentation.

The "reset" (-1 / UINT32_MAX) behavior was added in Linux 5.11 via
commit 480a6ca2dc6e ("sched/uclamp: Allow to reset a task uclamp
constraint value").

Cc: Dietmar Eggemann <dietmar.eggemann@arm.com>
Cc: Patrick Bellasi <patrick.bellasi@arm.com>
Cc: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Brian Norris <briannorris@chromium.org>
Message-ID: <20240613204823.3184609-1-briannorris@chromium.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>