From: наб <nabijaczleweli@nabijaczleweli.xyz>
To: util-linux@vger.kernel.org
Subject: [PATCH] Fix mmap/ioctl(3p) references in manual
Date: Fri, 7 Apr 2023 16:48:06 +0200 [thread overview]
Message-ID: <xirr7enxyybsuyjjroo3v452yjio3b3bfw4hdmctzhundq4wgg@ymt5yxyrni3q> (raw)
[-- Attachment #1: Type: text/plain, Size: 3036 bytes --]
mmap(3p) is passable, inasmuch as it does actually describe mmap(2).
ioctl(3p), on the other hand, describes XSI STREAMS, which bear no
relation to ioctl(2) under Linux, much less ioctl_console(2).
Both live in the non-free manpages-posix-dev.
---
Based on 2.39-rc2 tarball.
diff '--color=auto' -ur util-linux-2.39-rc2.orig/sys-utils/setarch.8.adoc util-linux-2.39-rc2/sys-utils/setarch.8.adoc
--- util-linux-2.39-rc2.orig/sys-utils/setarch.8.adoc 2023-03-23 16:21:32.792172791 +0100
+++ util-linux-2.39-rc2/sys-utils/setarch.8.adoc 2023-04-07 16:40:55.820024243 +0200
@@ -70,10 +70,10 @@
This makes *select*(2), *pselect*(2), and *ppoll*(2) system calls preserve the timeout value instead of modifying it to reflect the amount of time not slept when interrupted by a signal handler. Use when _program_ depends on this behavior. For more details see the timeout description in *select*(2) manual page. Turns on *STICKY_TIMEOUTS*.
*-X*, *--read-implies-exec*::
-If this is set then *mmap*(3p) *PROT_READ* will also add the *PROT_EXEC* bit - as expected by legacy x86 binaries. Notice that the ELF loader will automatically set this bit when it encounters a legacy binary. Turns on *READ_IMPLIES_EXEC*.
+If this is set then *mmap*(2) *PROT_READ* will also add the *PROT_EXEC* bit - as expected by legacy x86 binaries. Notice that the ELF loader will automatically set this bit when it encounters a legacy binary. Turns on *READ_IMPLIES_EXEC*.
*-Z*, *--mmap-page-zero*::
-SVr4 bug emulation that will set *mmap*(3p) page zero as read-only. Use when _program_ depends on this behavior, and the source code is not available to be fixed. Turns on *MMAP_PAGE_ZERO*.
+SVr4 bug emulation that will set *mmap*(2) page zero as read-only. Use when _program_ depends on this behavior, and the source code is not available to be fixed. Turns on *MMAP_PAGE_ZERO*.
include::man-common/help-version.adoc[]
diff '--color=auto' -ur util-linux-2.39-rc2.orig/term-utils/setterm.1.adoc util-linux-2.39-rc2/term-utils/setterm.1.adoc
--- util-linux-2.39-rc2.orig/term-utils/setterm.1.adoc 2023-03-23 16:21:32.794172780 +0100
+++ util-linux-2.39-rc2/term-utils/setterm.1.adoc 2023-04-07 16:42:33.388375375 +0200
@@ -134,7 +134,7 @@
Displays the terminal reset string, which typically resets the terminal to its power-on state.
*--resize*::
-Reset terminal size by assessing maximum row and column. This is useful when actual geometry and kernel terminal driver are not in sync. Most notable use case is with serial consoles, that do not use *ioctl*(3p) but just byte streams and breaks.
+Reset terminal size by assessing maximum row and column. This is useful when actual geometry and kernel terminal driver are not in sync. Most notable use case is with serial consoles, that do not use *ioctl*(2) but just byte streams and breaks.
*--reverse* on|off::
Turns reverse video mode on or off. Except on a virtual console, *--reverse off* turns off all attributes (bold, half-brightness, blink, reverse).
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
next reply other threads:[~2023-04-07 14:48 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-04-07 14:48 наб [this message]
2023-04-11 10:57 ` [PATCH] Fix mmap/ioctl(3p) references in manual Karel Zak
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=xirr7enxyybsuyjjroo3v452yjio3b3bfw4hdmctzhundq4wgg@ymt5yxyrni3q \
--to=nabijaczleweli@nabijaczleweli.xyz \
--cc=util-linux@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).