fnmatch.3: Update FNM_CASEFOLD availability, FNM_IGNORECASE alias
Every system I looked at already had FNM_CASEFOLD,
so calling it "GNU" is misleading at best;
Solaris (and the illumos gate) call it FNM_IGNORECASE
but also provide FNM_CASEFOLD as an alias.
Charlie Jenkins [Mon, 1 Jul 2024 19:00:37 +0000 (12:00 -0700)]
__riscv_flush_icache.3, riscv_flush_icache.2: Add page (and link page)
riscv_flush_icache() has been present in syscall.2, but had no page for
itself. Add the page for this syscall.
The syscall is named riscv_flush_icache(), but the glibc function is
named __riscv_flush_icache(). To handle this, name the syscall page
riscv_flush_icache.2 and point to the libc page __riscv_flush_icache.3.
Mikołaj Kołek [Tue, 2 Jul 2024 19:19:28 +0000 (21:19 +0200)]
perf_event_open.2: Document combining inherit and cpus = -1 preventing the use of mmap
After calling perf_event_open() with cpus == -1 and the inherit bit,
using mmap on the perf file descriptor to create a ring-buffer fails
with EINVAL. This behavior wasn't previously documented in the man
page and is caused by the following lines in the perf_mmap function in
<kernel/events/core.c>:
/*
* Don't allow mmap() of inherited per-task counters. This would
* create a performance issue due to all children writing to the
* same rb.
*/
if (event->cpu == -1 && event->attr.inherit)
return -EINVAL;
Signed-off-by: Mikołaj Kołek <kolek.mikolaj@gmail.com>
Message-ID: <CAHGiy6-nx0PwBi6xwoG8PN5qND-krGh_rvpfmVc31-QSv04C6g@mail.gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
наб [Fri, 28 Jun 2024 21:07:02 +0000 (23:07 +0200)]
printf.3: Rework '
As it stands, this is worse than useless
(defined as: I had to test it explicitly against strfmon() and look at
POSIX myself to make sure the manual wasn't lying to me
https://101010.pl/@nabijaczleweli/112694726416515899):
No-one cares if some compiler doesn't understand something from 1994.
(Careful readers will note it's been 30 years.)
"SUSv2 doesn't have this, SUSv3 does" is reefer-induced:
this figures in SUSv1 (XPG Issue 4 Version 2)
and the CHANGE HISTORY clearly notes ' was added in i4, not i4v2.
It's important that these aren't actually grouped by the thousand,
but, instead, by "what the locale says".
Each locale has two groupings: monetary and non-monetary,
and it's paramount to indicate which is which
(hi_IN is 3,2... monetary and 3... non-monetary;
mjw_IN is 3,2... both).
It waxes poetic for way too long about "how to set a locale".
Also replace "The Single UNIX Specification adds" with "POSIX adds".
The SUS is, on a good day, a profile of POSIX you pay 300$ for.
Maybe you could swing this back when it was an "extension"
(so, only required in the SUS profile)
but it's just shaded CX ("this is intentionally different from C")
in Issue 8. It's really irrelevant here.
Also add this to HISTORY
(and call it something sane there;
the Proper nomenclature is absolutely meaningless to normal people).
The most important bit for every HISTORY reader is the 1994 date.
Kir Kolyshkin [Mon, 17 Jun 2024 23:10:26 +0000 (16:10 -0700)]
semctl.2: Fix wrong section reference
The man page says:
> GETPID
> Return the sempid value for the semnum-th semaphore of
> the set. This is the PID of the process that last
> performed an operation on that semaphore (but see NOTES).
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.
Kir Kolyshkin [Mon, 17 Jun 2024 23:10:24 +0000 (16:10 -0700)]
open.2: Fix wrong section reference
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about O_SYNC and O_DSYNC
is now under VERSIONS / Synchronized I/O.
Kir Kolyshkin [Mon, 17 Jun 2024 23:10:21 +0000 (16:10 -0700)]
mkdir.2: Fix wrong section reference
The man page says:
> Whether other mode bits are honored for the created directory depends
> on the operating system. For Linux, see VERSIONS below.
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about permission
inheritance is in VERSIONS.
Kir Kolyshkin [Mon, 17 Jun 2024 23:10:17 +0000 (16:10 -0700)]
getpriority.2: Move info from NOTES to HISTORY
In the spirit of commit 4131356cd ("man*/, man-pages.7: VERSIONS,
STANDARDS, HISTORY: Reorganize sections"), move the historical
information about EPERM error from NOTES to HISTORY, and fix the
section reference accordingly.
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-6-kolyshkin@gmail.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
Kir Kolyshkin [Mon, 17 Jun 2024 23:10:16 +0000 (16:10 -0700)]
gethostname.2: Fix section reference
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Kir Kolyshkin [Mon, 17 Jun 2024 23:10:15 +0000 (16:10 -0700)]
execve.2: Fix wrong section reference
The man page says:
> For portable use, optional-arg should either be absent, or be
> specified as a single word (i.e., it should not contain white
> space); see NOTES below.
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the discussion about optional-arg is in
VERSIONS.
Kir Kolyshkin [Mon, 17 Jun 2024 23:10:13 +0000 (16:10 -0700)]
cacheflush.2: Fix section reference
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Dev Jain [Tue, 11 Jun 2024 09:08:23 +0000 (14:38 +0530)]
signal.7: Fix wrong mention of sigprocmask
The handler is registered with sigaction(2), not sigprocmask(2). Even
if the purpose of writing sigprocmask(2) here was to mention blocked
signals, the statement currently concerns the "addition" of blocked
signals; signals blocked through sigprocmask(2) would already be present
in the thread context of blocked signals.
Fixes: e7a5700f2313 (getcontext.3, signal.7: tfix) Signed-off-by: Dev Jain <dev.jain@arm.com> Reviewed-by: Mark Brown <broonie@kernel.org> Cc: Ingo Molnar <mingo@kernel.org> Cc: Thomas Gleixner <tglx@linutronix.de> Cc: Mark Rutland <mark.rutland@arm.com> Cc: Ryan Roberts <ryan.roberts@arm.com> Cc: Suzuki Poulouse <suzuki.poulose@arm.com> Cc: Anshuman Khandual <anshuman.khandual@arm.com> Cc: <DeepakKumar.Mishra@arm.com> Cc: Aneesh Kumar K.V <aneesh.kumar@kernel.org> Cc: <linux-kernel@vger.kernel.org>
Message-ID: <20240611090823.820724-3-dev.jain@arm.com> Signed-off-by: Alejandro Colomar <alx@kernel.org>
Kir Kolyshkin [Sun, 16 Jun 2024 20:13:20 +0000 (13:13 -0700)]
readdir.3: Fix wrong section references
There are references to NOTES section, but since the commit 4131356cd
("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize
sections") the relevant information is in VERSIONS.
- Move description of files to FILES section.
- Use linux.git/... for Linux documentation files in SEE ALSO.
- Remove old names of Linux documentation files.
Kir Kolyshkin [Sun, 16 Jun 2024 01:19:04 +0000 (18:19 -0700)]
strtod.3: Fix wrong section reference
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections"), the discussion about n-char-sequence refers to
NOTES, while the relevant information is now in VERSIONS.
Kir Kolyshkin [Sun, 16 Jun 2024 01:19:03 +0000 (18:19 -0700)]
strtok.3: Fix section reference
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Kir Kolyshkin [Sun, 16 Jun 2024 01:19:02 +0000 (18:19 -0700)]
stailq.3: Fix section reference
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Kir Kolyshkin [Sun, 16 Jun 2024 01:19:01 +0000 (18:19 -0700)]
sigpause.3: Fix section reference
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Currently, the relevant information is kind of split between VERSIONS
and HISTORY, but VERSIONS is somewhat more relevant.
Kir Kolyshkin [Sun, 16 Jun 2024 01:18:58 +0000 (18:18 -0700)]
getdtablesize.3: Fix section reference
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Kir Kolyshkin [Sun, 16 Jun 2024 01:18:57 +0000 (18:18 -0700)]
ceil.3, rint.3, round.3: mv NOTES section to HISTORY
Commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections") removed the NOTES section from floor(3), moving
the explanation of overflow errors to HISTORY.
The very same explanation is also there in ceil(3), rint(3), and
round(3). Let's move it to HISTORY as well, for uniformity.
Kir Kolyshkin [Sun, 16 Jun 2024 01:18:55 +0000 (18:18 -0700)]
posix_fallocate.3: Fix section references
There are references to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Kir Kolyshkin [Sun, 16 Jun 2024 01:18:54 +0000 (18:18 -0700)]
exec.3: Fix section reference
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
projects / thirdparty / man-pages.git / log
