Skip to content

Commit

Permalink
Remove _POSIX_PRIORITIZED_IO references from man pages
Browse files Browse the repository at this point in the history
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.

MFC after:	1 week
Sponsored by:	Axcient
Reviewed by:	Pau Amma <[email protected]>
Differential Revision: https://reviews.freebsd.org/D42622
  • Loading branch information
asomers committed Dec 18, 2023
1 parent 66d77e0 commit 18e2c41
Show file tree
Hide file tree
Showing 3 changed files with 2 additions and 28 deletions.
7 changes: 1 addition & 6 deletions lib/libc/sys/aio_fsync.2
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down
14 changes: 0 additions & 14 deletions lib/libc/sys/aio_read.2
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
9 changes: 1 addition & 8 deletions lib/libc/sys/aio_write.2
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down

0 comments on commit 18e2c41

Please sign in to comment.