Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 19 Jan 2024 20:21:16 GMT
From:      Alan Somers <asomers@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: 08ac19609ca0 - stable/13 - Remove _POSIX_PRIORITIZED_IO references from man pages
Message-ID:  <202401192021.40JKLGfW014172@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch stable/13 has been updated by asomers:

URL: https://cgit.FreeBSD.org/src/commit/?id=08ac19609ca0ab1529c63482fbfdf7bb1605edce

commit 08ac19609ca0ab1529c63482fbfdf7bb1605edce
Author:     Alan Somers <asomers@FreeBSD.org>
AuthorDate: 2023-11-15 17:56:05 +0000
Commit:     Alan Somers <asomers@FreeBSD.org>
CommitDate: 2024-01-19 20:20:51 +0000

    Remove _POSIX_PRIORITIZED_IO references from man pages
    
    We don't support it, so there's no need to tell readers what would
    happen if we did.  Also, don't remind the user that a certain field is
    ignored by aio_read.  Mentioning every ignored field would make the man
    pages too verbose.
    
    Sponsored by:   Axcient
    Reviewed by:    Pau Amma <pauamma@gundo.com>
    Differential Revision: https://reviews.freebsd.org/D42622
    
    (cherry picked from commit 18e2c4175f78f1aaa648dd7fb7530220aed23671)
---
 lib/libc/sys/aio_fsync.2 |  7 +------
 lib/libc/sys/aio_read.2  | 14 --------------
 lib/libc/sys/aio_write.2 |  9 +--------
 3 files changed, 2 insertions(+), 28 deletions(-)

diff --git a/lib/libc/sys/aio_fsync.2 b/lib/libc/sys/aio_fsync.2
index f386e0653b21..46fc5d95bcfd 100644
--- a/lib/libc/sys/aio_fsync.2
+++ b/lib/libc/sys/aio_fsync.2
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd January 6, 2021
+.Dd November 15, 2023
 .Dt AIO_FSYNC 2
 .Os
 .Sh NAME
@@ -57,11 +57,6 @@ or
 for the behavior of
 .Xr fdatasync 2 .
 .Pp
-If _POSIX_PRIORITIZED_IO is defined, and the descriptor supports it,
-then the enqueued operation is submitted at a priority equal to that
-of the calling process minus
-.Fa iocb->aio_reqprio .
-.Pp
 The
 .Fa iocb
 pointer may be subsequently used as an argument to
diff --git a/lib/libc/sys/aio_read.2 b/lib/libc/sys/aio_read.2
index c6f062fa406d..092315e70c91 100644
--- a/lib/libc/sys/aio_read.2
+++ b/lib/libc/sys/aio_read.2
@@ -71,20 +71,6 @@ the
 structure is defined in
 .Xr readv 2 .
 .Pp
-If _POSIX_PRIORITIZED_IO is defined, and the descriptor supports it,
-then the enqueued operation is submitted at a priority equal to that
-of the calling process minus
-.Fa iocb->aio_reqprio .
-.Pp
-The
-.Fa iocb->aio_lio_opcode
-argument
-is ignored by the
-.Fn aio_read
-and
-.Fn aio_readv
-system calls.
-.Pp
 The
 .Fa iocb
 pointer may be subsequently used as an argument to
diff --git a/lib/libc/sys/aio_write.2 b/lib/libc/sys/aio_write.2
index efc0938a5cf9..32ad53019ed2 100644
--- a/lib/libc/sys/aio_write.2
+++ b/lib/libc/sys/aio_write.2
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd January 2, 2021
+.Dd November 15, 2023
 .Dt AIO_WRITE 2
 .Os
 .Sh NAME
@@ -84,13 +84,6 @@ is not set for the file descriptor, the write operation will occur at
 the absolute position from the beginning of the file plus
 .Fa iocb->aio_offset .
 .Pp
-If
-.Dv _POSIX_PRIORITIZED_IO
-is defined, and the descriptor supports it, then the enqueued
-operation is submitted at a priority equal to that of the calling
-process minus
-.Fa iocb->aio_reqprio .
-.Pp
 The
 .Fa iocb
 pointer may be subsequently used as an argument to



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202401192021.40JKLGfW014172>