| Age | Commit message (Collapse) | Author | Files | Lines |
|---|
|
Cc: Christian Brauner <brauner@kernel.org>
Cc: Miklos Szeredi <mszeredi@redhat.com>
Cc: <linux-fsdevel@vger.kernel.org>
Cc: <kernel-team@fb.com>
Signed-off-by: Josef Bacik <josef@toxicpanda.com>
Message-ID: <2d72a44fa49f47bd7258d7efb931926b26de4004.1720549824.git.josef@toxicpanda.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Document the PR_RISCV_SET_ICACHE_FLUSH_CTX flag for prctl(2) that is
supported as of Linux 6.10.
Cc: Alexandre Ghiti <alexghiti@rivosinc.com>
Signed-off-by: Charlie Jenkins <charlie@rivosinc.com>
Message-ID: <20240709-fencei_prctl-v5-1-a0391069f746@rivosinc.com>
[alx: ffix + consistent line breaks]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Reported-by: gcc(1) (`make build-ex-cc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Reported-by: gcc(1) (`make build-ex-cc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Reported-by: gcc(1) (`make build-ex-cc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
GCC now enables -Wunused-result by default.
Reported-by: gcc(1) (`make build-ex-cc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Mention -1 return code on failure for landlock_add_rule(2),
landlock_create_ruleset(2) and landlock_restrict_self(2).
Although it's a common rule to return -1 on error, it's better to be
explicit (as the other man pages are).
Fixes: a01d04a69 ("landlock_add_rule.2: Document new syscall")
Fixes: ca5163697 ("landlock_create_ruleset.2: Document new syscall")
Fixes: 3f7e4f808 ("landlock_restrict_self.2: Document new syscall")
Reviewed-by: Günther Noack <gnoack@google.com>
Cc: Mickaël Salaün <mic@linux.microsoft.com>
Cc: Mickaël Salaün <mic@digikod.net>
Cc: <linux-security-module@vger.kernel.org>
Signed-off-by: Petr Vorel <pvorel@suse.cz>
Message-ID: <20240712172246.151258-2-pvorel@suse.cz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Follow the pattern to replace "to indicate the cause of the error"
with "to indicate the error".
Suggested-by: Alejandro Colomar <alx@kernel.org>
Acked-by: Günther Noack <gnoack@google.com>
Cc: Mickaël Salaün <mic@linux.microsoft.com>
Cc: Mickaël Salaün <mic@digikod.net>
Signed-off-by: Petr Vorel <pvorel@suse.cz>
Message-ID: <20240712172246.151258-1-pvorel@suse.cz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <2lnvud6qnttulm34ns3lsrafguzrdjdgnnnp4yrlsdl6c2yoef@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Ma Xinjian <maxj.fnst@fujitsu.com>
Message-ID: <20240710081926.10913-1-maxj.fnst@fujitsu.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <z3bixugjnrhlcli53tmdogma7op7uwstwlitgl7u4mmyqfs3pc@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Cc: Christian Brauner <brauner@kernel.org>
Cc: Miklos Szeredi <mszeredi@redhat.com>
Cc: <linux-fsdevel@vger.kernel.org>
Cc: <kernel-team@fb.com>
Signed-off-by: Josef Bacik <josef@toxicpanda.com>
Message-ID: <5b4a8408a21970d0ee4bea5cee4c74cb39851c0d.1720549824.git.josef@toxicpanda.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <atyx4os7275jhfsrnblyr6ykxwghjzdpdnvnrvxcskei7kbb6n@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Fix a copy-paste error in SYNOPSIS:
FIONREAD was mentioned twice,
but another IOCTL was missing.
Fixes: c6267fb68309 ("ioctl_tty.2, FIONREAD.2const, TIOC{IN,OUT}Q.2const, TCFLSH.2const, TIOCSERGETLSR.2const: Split from ioctl_tty(2)")
Signed-off-by: Günther Noack <gnoack@google.com>
Message-ID: <20240705142844.1142998-1-gnoack@google.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Ma Xinjian <maxj.fnst@fujitsu.com>
Message-ID: <20240704064108.27257-1-maxj.fnst@fujitsu.com>
[alx: Remove comment]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
Signed-off-by: Charlie Jenkins <charlie@rivosinc.com>
Message-ID: <20240701-flush_icache-v2-1-15f7a35a0d13@rivosinc.com>
[alx: ffix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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>
|
|
Fixes: ce23e8188f8f ("fmod.3: Add example section")
Closes: <https://bugzilla.kernel.org/show_bug.cgi?id=219017>
Reported-by: Benjamin Otte <otte@gnome.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <o2vchme4dchemjo4diziac5rlmhtsaze2yi72fzo5r67umlwny@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
This mirrors str[n]casecmp and is much more useful,
but more importantly these didn't crosslink at all.
The RETURN VALUE section is now copied from strncasecmp.3.
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <wr4xqnhilpx7yszqxcggo7scpt3bnrfha3ohfs6uxwibhfafel@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Document the new statx.stx_subvol field.
This would be clearer if we had a proper API for walking subvolumes that
we could refer to, but that's still coming.
Link: https://lore.kernel.org/linux-fsdevel/20240308022914.196982-1-kent.overstreet@linux.dev/
Signed-off-by: Kent Overstreet <kent.overstreet@linux.dev>
[jpg: mention supported FSes and formatting improvements]
Signed-off-by: John Garry <john.g.garry@oracle.com>
Cc: Eric Biggers <ebiggers@kernel.org>
Cc: <linux-fsdevel@vger.kernel.org>
Message-ID: <20240620130017.2686511-1-john.g.garry@oracle.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Put the subsection title in the .SS line.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Linux 6.8 added STATX_MNT_ID_UNIQUE support.
Link: <https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=98d2b43081972>
Signed-off-by: Josef Bacik <josef@toxicpanda.com>
Cc: Christian Brauner <brauner@kernel.org>
Cc: Miklos Szeredi <mszeredi@redhat.com>
Cc: <linux-fsdevel@vger.kernel.org>
Cc: <kernel-team@fb.com>
Message-ID: <a45b2623a25357f33978b49963dad5f99b984386.1719341580.git.josef@toxicpanda.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Fixes: b17819960602 ("string_copying.7: wfix")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Say 'length-bounded' instead of 'known-lenght'. Eric Blake used that
term in an email, and I think it's more clear than the old one.
Link: <https://lore.kernel.org/linux-man/lpqjinqeylacuismlzsnnhy7hiuv7so6dlcccnclzmmjknnlux@asvvn6j4qrl2/T/>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
This reverts commit fa2ca6f2e080a16eebd528defef9deaea6145477.
The groff(1) bug that required that workaround has been fixed.
Link: <https://savannah.gnu.org/bugs/?65894>
Link: <https://lists.gnu.org/archive/html/groff/2024-06/msg00036.html>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The man page says:
> Permissions are inherited by the child created by fork (2)
> (but see NOTES).
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the relevant information is in HISTORY.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240618173524.1797697-1-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The man page says:
> This is the glibc and POSIX interface; see
> NOTES for information on the raw system call.
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-17-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The man page says:
> The length of the arrays in a struct utsname is unspecified (see NOTES);
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS and
HISTORY.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-16-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-15-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The man page says:
> There is no definition of struct old_linux_dirent; see NOTES.
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-14-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
While at it, fix the typesetting.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-13-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The man page says:
> On success, the new nice value is returned (but see NOTES below).
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-12-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The man page says:
> See NOTES for information on feature test macro requirements.
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-11-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-10-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The man page says:
> (Historically, the rules were different; see NOTES.)
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), the historical rules moved to HISTORY.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-9-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The man page says:
> The use of the timezone structure is obsolete; the tz argument should
> normally be specified as NULL. (See NOTES below.)
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this information is in VERSIONS.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-7-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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>
|
|
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-5-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-4-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The man page says:
> For the prototype of the raw clone() system call, see NOTES
Since the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections"), this prototype is in VERSIONS.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-3-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240617231035.1766780-2-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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>
|
|
The set of blocked signals is updated from struct sigaction after the
kernel dumps ucontext. Mention this to avoid misunderstanding.
Signed-off-by: Dev Jain <dev.jain@arm.com>
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: Mark Brown <broonie@kernel.org>
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-2-dev.jain@arm.com>
[alx: semantic newlines; ffix]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Message-ID: <20240616233931.53760-1-jeremy@baxters.nz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
EX/EE can't be nested within nf/ni. The mandoc(1) reports weren't
spurious.
Re-enable the mandoc(1) warnings, and fix the code.
Fixes: 31203a0c8dbf ("share/mk/: Globally disable two spurious mandoc(1) warnings")
Link: <https://lists.gnu.org/archive/html/groff/2024-06/msg00019.html>
Reported-by: Douglas McIlroy <douglas.mcilroy@dartmouth.edu>
Cc: "G. Branden Robinson" <branden@debian.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections") results in a few problems with setjmp(3):
1. "Feature Test Macro Requirements for glibc" refers to NOTES, while
those macros are now described in HISTORY.
2. The discussion about saving signal mask is now split between HISTORY
and NOTES.
Fix the references accordingly.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616201946.1663626-1-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
While at it, unify the "see XXX" style.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616201323.1662948-1-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
This workarounds a groff -Thtml bug.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
- Move description of files to FILES section.
- Use linux.git/... for Linux documentation files in SEE ALSO.
- Remove old names of Linux documentation files.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
And remove them from XFAIL, since they don't fail anymore.
Reported-by: mandoc(1) (`make lint-man-mandoc`)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-12-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-11-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-10-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-9-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-6-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Cc: Kir Kolyshkin <kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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.
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-5-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
There are references to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-3-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
There is a reference to NOTES section, which no longer exists since
the commit 4131356cd ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY:
Reorganize sections").
Fixes: 4131356cdab8 ("man*/, man-pages.7: VERSIONS, STANDARDS, HISTORY: Reorganize sections")
Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
Message-ID: <20240616011920.1627949-2-kolyshkin@gmail.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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>
|
|
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>
|
|
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>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
ioctl_userfaultfd(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
ioctl_userfaultfd(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
from ioctl_userfaultfd(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
ioctl_userfaultfd(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
ioctl_userfaultfd(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
ioctl_userfaultfd(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
ioctl_userfaultfd(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
ioctl_userfaultfd(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
ioctl_userfaultfd(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
TIOC* from ioctl_tty(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Split TIOC* from ioctl_tty(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
TIOCSERGETLSR.2const: Split from ioctl_tty(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
- 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_fsmap(2)
This name makes it consistent with the header file <linux/fsmap.h>.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
FS_IOC_SETFLAGS.2const
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
FS_IOC_SETFSLABEL.2const
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
FIDEDUPERANGE.2const
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
VFAT_IOCTL_READDIR_* from ioctl_fat(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
from ioctl_fat(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
FAT_IOCTL_[GS]ET_ATTRIBUTES from ioctl_fat(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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>
|
|
\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>
|
|
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>
|
|
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>
|
|
Message-ID: <20240611153005.3066-12-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Message-ID: <20240611153005.3066-11-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
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>
|
|
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>
|
|
Message-ID: <20240611153005.3066-8-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Message-ID: <20240611153005.3066-7-eggert@cs.ucla.edu>
[alx: \fI => .I]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Message-ID: <20240611153005.3066-6-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Message-ID: <20240611153005.3066-5-eggert@cs.ucla.edu>
[alx: use mathematical notation for the range, and \fI => .I]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Message-ID: <20240611153005.3066-4-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
New section CAVEATS for why time zone state is dicey.
Message-ID: <20240611153005.3066-3-eggert@cs.ucla.edu>
[alx: use .I instead of \fI]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Message-ID: <20240611153005.3066-2-eggert@cs.ucla.edu>
[alx: use em dashes instead of commas]
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
* man/man3/ctime.3: Simplify by referring to tzset(3) for details
about how it sets tzname etc. This simplifies a later patch,
which changes tzset(3)'s description.
Message-ID: <20240611153005.3066-1-eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Some prctl()s just ignore unused parameters. Users don't need to
specify them all.
Fixes: 2534dc7ad5e9 ("prctl.2, PR_*.2const: Make sashimi")
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Link: <https://lore.kernel.org/linux-man/ddbdyaiptesjalgfmztxideej67e3yaob7ucsmbf6qvriwxiif@dohhxrqgwhrf/T/#med306b5b003f9cc7cc2de69fcdd7ee2d056d0954>
Cc: Xi Ruoyao <xry111@xry111.site>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
For some reason, neither chattr(1) nor this page document it;
this is supported by all tested filesystems (ext4, tmpfs, ZFS).
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <vzoykfmkokepn2gq3nqb2vvlbim32vky3vnac2x2avmkyzcdez@tarta.nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
The open_by_handle_at equivalent in FreeBSD is called fhopen, not
openfh.
Signed-off-by: Christoph Hellwig <hch@lst.de>
Message-ID: <20240527113800.1098633-1-hch@lst.de>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
PR_TASK_PERF_EVENTS_* from prctl(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
prctl(2)
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
|
Signed-off-by: Alejandro Colomar <alx@kernel.org>
|
