src/lib/libc/sys/aio_fsync.2, branch release/11.1.0 FreeBSD source tree MFC 304476: Fix various nits in the aio operation manpages. 2016-08-22T17:52:10+00:00 John Baldwin jhb@FreeBSD.org 2016-08-22T17:52:10+00:00 14720199b8b34a7b1ea8b1ba6ef47ed1a32f5580 - Avoid double use of "request" in a single sentence. Instead, describe aio_sigevent as being used to request notification of the associated operation's completion. This matches the language used to describe aio_sigevent in aio(4). - Simplify the prohibition on modifying buffers while requests are in flight. - Fix case mismatch. - Drop note about not using stack variables. C programmers should be able to figure out if a stack variable is safe based on the later warning about the life cycle requirements of control blocks. - Remove prohibition on modifying the I/O buffer for aio_fsync() since it does not use an I/O buffer. For aio_mlock(), prohibit modifications to the mapping (e.g. due to mprotect, munmap, mmap, etc.) but do not prohibit modifications to the memory backing the buffer (stores into the pages backing the buffer). 
- Avoid double use of "request" in a single sentence.  Instead, describe
  aio_sigevent as being used to request notification of the associated
  operation's completion.  This matches the language used to describe
  aio_sigevent in aio(4).
- Simplify the prohibition on modifying buffers while requests are in
  flight.
- Fix case mismatch.
- Drop note about not using stack variables. C programmers should be able
  to figure out if a stack variable is safe based on the later warning
  about the life cycle requirements of control blocks.
- Remove prohibition on modifying the I/O buffer for aio_fsync() since
  it does not use an I/O buffer.  For aio_mlock(), prohibit modifications
  to the mapping (e.g. due to mprotect, munmap, mmap, etc.) but do not
  prohibit modifications to the memory backing the buffer (stores into
  the pages backing the buffer).
MFC 303164: Add more documentation regarding unsafe AIO requests. 2016-07-28T20:31:30+00:00 John Baldwin jhb@FreeBSD.org 2016-07-28T20:31:30+00:00 442ba837953b8d6e1b506b82fedfd29b0b2adf42 The asynchronous I/O changes made previously result in different behavior out of the box. Previously all AIO requests failed with ENOSYS / SIGSYS unless aio.ko was explicitly loaded. Now, some AIO requests complete and others ("unsafe" requests) fail with EOPNOTSUPP. Reword the introductory paragraph in aio(4) to add a general description of AIO before describing the vfs.aio.enable_unsafe sysctl. Remove the ENOSYS error description from aio_fsync(2), aio_read(2), and aio_write(2) and replace it with a description of EOPNOTSUPP. Remove the ENOSYS error description from aio_mlock(2). Log a message to the system log the first time a process requests an "unsafe" AIO request that fails with EOPNOTSUPP. This is modeled on the log message used for processes using the legacy pty devices. Approved by: re (gjb) 
The asynchronous I/O changes made previously result in different
behavior out of the box. Previously all AIO requests failed with
ENOSYS / SIGSYS unless aio.ko was explicitly loaded. Now, some AIO
requests complete and others ("unsafe" requests) fail with EOPNOTSUPP.

Reword the introductory paragraph in aio(4) to add a general
description of AIO before describing the vfs.aio.enable_unsafe sysctl.

Remove the ENOSYS error description from aio_fsync(2), aio_read(2),
and aio_write(2) and replace it with a description of EOPNOTSUPP.

Remove the ENOSYS error description from aio_mlock(2).

Log a message to the system log the first time a process requests an
"unsafe" AIO request that fails with EOPNOTSUPP. This is modeled on
the log message used for processes using the legacy pty devices.

Approved by:	re (gjb)
MFC 302899: Add documentation for the sigevent structure. 2016-07-25T23:37:47+00:00 John Baldwin jhb@FreeBSD.org 2016-07-25T23:37:47+00:00 2eee5356232bfecf91a01da1f7e712cd4382325e - Add a sigevent(3) manpage to give a general overview of the sigevent structure and the available notification mechanisms. - Document that AIO requests contain a nested sigevent structure that can be used to request completion notification. - Expand the sigevent details in other manuals to note details such as the extra values stored in a queued signal's information or in a posted kevent. Approved by: re (gjb) 
- Add a sigevent(3) manpage to give a general overview of the sigevent
  structure and the available notification mechanisms.
- Document that AIO requests contain a nested sigevent structure that can
  be used to request completion notification.
- Expand the sigevent details in other manuals to note details such as
  the extra values stored in a queued signal's information or in a posted
  kevent.

Approved by:	re (gjb)
- Fix EBADF description, in following the future POSIX tc and what FreeBSD 2013-12-27T16:57:38+00:00 Sergey Kandaurov pluknet@FreeBSD.org 2013-12-27T16:57:38+00:00 d3178d7d2775aa1027499772bfdbaa134429e75a actually implements. - Improve grammar: use more preferred "can", not "could". Submitted by: jilles 
  actually implements.
- Improve grammar: use more preferred "can", not "could".

Submitted by:	jilles
Provide the manual page for aio_fsync(2). 2013-12-26T19:16:30+00:00 Sergey Kandaurov pluknet@FreeBSD.org 2013-12-26T19:16:30+00:00 e44aa9fde0a36f3a24b2ee5771ef0eea94d6e71f Reviewed by: davidxu MFC after: 1 week 
Reviewed by:	davidxu
MFC after:	1 week