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>

man-pages.7: Correct escaping of \~ advice

\e[ti] renders as \[ti] -- using \[ti] in a man page will produce a
literal tilde (~), not a nonbreaking space.

The intention here is to recommend \~, which produces a nonbreaking
space, so we need some more escaping.

Apply bold formatting too, which I believe is in accordance with the
advice in this section.

Fixes: 36f73ba37945 ("man-pages.7: Recommend using \[..] instead of \(.. escapes")
Signed-off-by: Brian Norris <briannorris@chromium.org>
Message-ID: <20240613205329.3240669-1-briannorris@chromium.org>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

sched_setattr.2: ERRORS: Break EINVAL into separate blocks

The current EINVAL description has a complex boolean expression, and I'm
planning to add one more condition to it. Let's separate it into
different EINVAL descriptions to make it easier to read.  Tweak the
punctuation a bit too while I'm at it.

Signed-off-by: Brian Norris <briannorris@chromium.org>
Message-ID: <20240612204504.2651521-1-briannorris@chromium.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

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

$ make lint-man-mandoc
MANDOC .tmp/man/man2/ioctl_eventpoll.2.lint-man.mandoc.touch
mandoc: .tmp/man/man2/ioctl_eventpoll.2:25:2: STYLE: fill mode already disabled, skipping: EX
mandoc: .tmp/man/man2/ioctl_eventpoll.2:35:2: STYLE: fill mode already enabled, skipping: fi
make: *** [/home/alx/src/linux/man-pages/man-pages/contrib/share/mk/lint/man/mandoc.mk:39: .tmp/man/man2/ioctl_eventpoll.2.lint-man.mandoc.touch] Error 1

Link: <https://lists.gnu.org/archive/html/groff/2024-06/msg00010.html>
Cc: Joe Damato <jdamato@fastly.com>
Cc: "G. Branden Robinson" <branden@debian.org>
Cc: Ingo Schwarze <schwarze@openbsd.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ioctl_eventpoll.2, EPIOC[GS]PARAMS.2const: New page describing epoll ioctl(2)

A new page is added which describes epoll fd ioctls: EPIOCSPARAMS and
EPIOCGPARAMS which allow the user to control epoll-based busy polling.

Also add link pages for EPIOCSPARAMS and EPIOCGPARAMS.

Signed-off-by: Joe Damato <jdamato@fastly.com>
Message-ID: <20240611210941.1791446-2-jdamato@fastly.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ctime.3, tzset.3, tm.3type: Adjust for POSIX, and don't overpromise

Merge changes from Paul Eggert.

Link: <https://lore.kernel.org/linux-man/d054fc63-6ea4-425b-94ce-14402d448ccf@cs.ucla.edu/T/>
Cc: Paul Eggert <eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

tm.3type: HISTORY: Say when tm_zone, tm_gmtoff standardized

Message-ID: <20240611153005.3066-12-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

tzset.3: STANDARDS: timezone & daylight in POSIX.1-2001

Message-ID: <20240611153005.3066-11-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

ctime.3, tzset.3: Update more POSIX citations and quotes

Message-ID: <20240611153005.3066-10-eggert@cs.ucla.edu>
Co-developed-by: Alejandro Colomar <alx@kernel.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

tm.3type: Update STANDARDS, HISTORY

The current standards are C23 and POSIX.1-2024.
This stuff was first standardized in C89 and POSIX.1-1988.

Message-ID: <20240611153005.3066-9-eggert@cs.ucla.edu>
Link: <https://www.reddit.com/r/C_Programming/comments/1ay92d4/latest_working_draft_n3220/?rdt=49226>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

tzset.3: Omit colon in example

Message-ID: <20240611153005.3066-8-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

tzset.3: TZ=":EST5" works

Message-ID: <20240611153005.3066-7-eggert@cs.ucla.edu>
[alx: \fI => .I]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

tzset.3: Use NZ's current rules in example

Message-ID: <20240611153005.3066-6-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>