From nobody Wed Sep 24 04:43:20 2025 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4cWkkK09D6z68TMN; Wed, 24 Sep 2025 04:43:21 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R12" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4cWkkJ6gCfz3RVB; Wed, 24 Sep 2025 04:43:20 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758689000; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=tqEbz0TVk0/bz9RgAm46tBkNxQrlhSYHjRmk7Avoz1k=; b=tPd4WiibDHPKlJ1cte0YippW+9MHrczKwtpLIuMlhooBdgMgwMC9fjTv49wzRPvjGu8LxI iYGFhaE52MqCaQlgqc5+tHK7hg7he4g+JIaNW00PrAcGNJIucXRLCt9vxBX6I+ZTO8byHy 3b7nj2iO032DSD48Koxa91cXdZM8gfEy2N/I3I/h7j5InF2l6WVua0DaoK9GPn5/pKe1Ez QmFqcTbRKoHBl7teqASAjR1lPEhrKSbqub0GJ+RqSEjIUT93m6Ovkbm2x9NZu7vw4cPE6B rLq91OHyOM3wzgBFBRweOrLt/cOt/lB3xFYV3Z+fwGuJgMOtx1uiKZ3bn4vj0w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1758689000; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=tqEbz0TVk0/bz9RgAm46tBkNxQrlhSYHjRmk7Avoz1k=; b=p6ytQ9YN3Bgi+ppjX2EwN0RnWiHdWm0YoeMHW1Zi2eqkJok/J2EjxTkf+rs5jQ5GhRY22G tqUgGpCfP1bZk67aBB3Y0hSRJLIDzhtQhRp+wiw6JChbfNunyX+0jjQLfRM8cxESUr7zc5 /Ut9/vNZscYg6tMwqeq50rPwjtosBlgl5NDFjZQVmG7Zdp6TIBXPBOrwqcL2kAKzg1H/fX d2QVxVm2inNZqYJNUn9bvjrn2mKpmDeq6zix8RnOYG7Hz+fKnaVeLXIRlvhmFk7oCK8pLR uJqKjZSKv0bxHHINPEgi+xr41pXkjedVFUr7CpfGxSuxgIxNYZR5ptNZqyCplQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1758689000; a=rsa-sha256; cv=none; b=nzGa169c9pH3EVspZJbHA/RxyA/7Z/OoJZYAtrtNbptnQKDIl/2Kktn/SnKgFxCxlDajAf zh2aKpBFAtU1eUuBppIZmM6rlNPihdllCvPtlx4gHopR69VrRvBS9U6R8XKWNKs2ZplThR bsnsZi2MojBA7W/LBe6tzkq/w1RokbJtRkvuP98LfuaIxFhfx2j18nbp+Ed70b0ZlvKD6q VSP9inCwPEh+HZfE8IFnELSvBDWFb1kzDnfZBWFncdX/lEBRWR4MjskpqHA8g9MLhyjmti eP/DH/xFA0RivYWSWjYabv0wvoi5u//fLVilbiVdoMYvvMre6esVYO1oY0dmZw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4cWkkJ69ZGz2Dy; Wed, 24 Sep 2025 04:43:20 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 58O4hKBA091528; Wed, 24 Sep 2025 04:43:20 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 58O4hKmF091525; Wed, 24 Sep 2025 04:43:20 GMT (envelope-from git) Date: Wed, 24 Sep 2025 04:43:20 GMT Message-Id: <202509240443.58O4hKmF091525@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Enji Cooper Subject: git: 9620fa7091a2 - stable/14 - aio_*(2): mention ENOSYS under ERRORS List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ngie X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: 9620fa7091a27f4c903aaee7d119a1f2d52926fa Auto-Submitted: auto-generated The branch stable/14 has been updated by ngie: URL: https://cgit.FreeBSD.org/src/commit/?id=9620fa7091a27f4c903aaee7d119a1f2d52926fa commit 9620fa7091a27f4c903aaee7d119a1f2d52926fa Author: Enji Cooper AuthorDate: 2025-03-25 21:57:52 +0000 Commit: Enji Cooper CommitDate: 2025-09-24 04:42:51 +0000 aio_*(2): mention ENOSYS under ERRORS ENOSYS can occur if aio(4) is not loaded in the kernel. Document this behavior so consumers on FreeBSD can better understand that this is a possible scenario. Clean up the manpages slightly while here: - Sort `ERRORS` by errno(3). - Use `.Fx` instead of `FreeBSD`. MFC after: 2 weeks Reviewed by: ziaee PR: 190942 Differential Revision: https://reviews.freebsd.org/D49502 (cherry picked from commit d97e44784bb5a510b7af7593c86cfbcff73855c4) --- lib/libc/sys/aio_cancel.2 | 7 +++++++ lib/libc/sys/aio_error.2 | 7 +++++++ lib/libc/sys/aio_fsync.2 | 7 +++++++ lib/libc/sys/aio_mlock.2 | 7 +++++++ lib/libc/sys/aio_read.2 | 11 ++++++++++- lib/libc/sys/aio_return.2 | 7 +++++++ lib/libc/sys/aio_suspend.2 | 7 +++++++ lib/libc/sys/aio_waitcomplete.2 | 11 +++++++++-- lib/libc/sys/aio_write.2 | 11 ++++++++++- 9 files changed, 71 insertions(+), 4 deletions(-) diff --git a/lib/libc/sys/aio_cancel.2 b/lib/libc/sys/aio_cancel.2 index 42d074054716..928a8b325e5f 100644 --- a/lib/libc/sys/aio_cancel.2 +++ b/lib/libc/sys/aio_cancel.2 @@ -80,6 +80,13 @@ The .Fa fildes argument is an invalid file descriptor. +.It Bq Er ENOSYS +The +.Fn aio_cancel +system call is not supported. +This can occur if +.Xr aio 4 +support is not present. .El .Sh SEE ALSO .Xr aio_error 2 , diff --git a/lib/libc/sys/aio_error.2 b/lib/libc/sys/aio_error.2 index 69eb7cd90ee2..2579d2f33052 100644 --- a/lib/libc/sys/aio_error.2 +++ b/lib/libc/sys/aio_error.2 @@ -72,6 +72,13 @@ The .Fa iocb argument does not reference an outstanding asynchronous I/O request. +.It Bq Er ENOSYS +The +.Fn aio_error +system call is not supported. +This can occur if +.Xr aio 4 +support is not present. .El .Sh SEE ALSO .Xr aio_cancel 2 , diff --git a/lib/libc/sys/aio_fsync.2 b/lib/libc/sys/aio_fsync.2 index 46fc5d95bcfd..0b863773eaf2 100644 --- a/lib/libc/sys/aio_fsync.2 +++ b/lib/libc/sys/aio_fsync.2 @@ -136,6 +136,13 @@ argument is not a valid descriptor. .It Bq Er EINVAL This implementation does not support synchronized I/O for this file. +.It Bq Er ENOSYS +The +.Fn aio_fsync +system call is not supported. +This can occur if +.Xr aio 4 +support is not present. .El .Pp If the request is successfully enqueued, but subsequently cancelled diff --git a/lib/libc/sys/aio_mlock.2 b/lib/libc/sys/aio_mlock.2 index 02d54304c631..f89ad10936aa 100644 --- a/lib/libc/sys/aio_mlock.2 +++ b/lib/libc/sys/aio_mlock.2 @@ -98,6 +98,13 @@ The request was not queued because of system resource limitations. The asynchronous notification method in .Fa iocb->aio_sigevent.sigev_notify is invalid or not supported. +.It Bq Er ENOSYS +The +.Fn aio_mlock +system call is not supported. +This can occur if +.Xr aio 4 +support is not present. .El .Pp If the request is successfully enqueued, but subsequently cancelled diff --git a/lib/libc/sys/aio_read.2 b/lib/libc/sys/aio_read.2 index 3a9601754c06..811d0b234168 100644 --- a/lib/libc/sys/aio_read.2 +++ b/lib/libc/sys/aio_read.2 @@ -173,6 +173,13 @@ points outside the process's allocated address space. The asynchronous notification method in .Fa iocb->aio_sigevent.sigev_notify is invalid or not supported. +.It Bq Er ENOSYS +The +.Fn aio_read +system call is not supported. +This can occur if +.Xr aio 4 +support is not present. .It Bq Er EOPNOTSUPP Asynchronous read operations on the file descriptor .Fa iocb->aio_fildes @@ -263,7 +270,9 @@ The .Fn aio_read2 and .Fn aio_readv -system calls are FreeBSD extensions, +system calls are +.Fx +extensions, and should not be used in portable code. .Sh HISTORY The diff --git a/lib/libc/sys/aio_return.2 b/lib/libc/sys/aio_return.2 index 499b85ef20d8..49e1abf201ec 100644 --- a/lib/libc/sys/aio_return.2 +++ b/lib/libc/sys/aio_return.2 @@ -79,6 +79,13 @@ The I/O operation was submitted with and the value of the .Fa aio_lio_opcode is invalid. +.It Bq Er ENOSYS +The +.Fn aio_return +system call is not supported. +This can occur if +.Xr aio 4 +support is not present. .El .Sh SEE ALSO .Xr aio_cancel 2 , diff --git a/lib/libc/sys/aio_suspend.2 b/lib/libc/sys/aio_suspend.2 index c46b0292c34e..ebc3c15d059f 100644 --- a/lib/libc/sys/aio_suspend.2 +++ b/lib/libc/sys/aio_suspend.2 @@ -89,6 +89,13 @@ contains more asynchronous I/O requests than the variable, or at least one of the requests is not valid. .It Bq Er EINTR the suspend was interrupted by a signal. +.It Bq Er ENOSYS +The +.Fn aio_suspend +system call is not supported. +This can occur if +.Xr aio 4 +support is not present. .El .Sh SEE ALSO .Xr aio_cancel 2 , diff --git a/lib/libc/sys/aio_waitcomplete.2 b/lib/libc/sys/aio_waitcomplete.2 index 1f20eca942ab..0a38155d7c75 100644 --- a/lib/libc/sys/aio_waitcomplete.2 +++ b/lib/libc/sys/aio_waitcomplete.2 @@ -91,8 +91,6 @@ The .Fn aio_waitcomplete system call fails if: .Bl -tag -width Er -.It Bq Er EINVAL -The specified time limit is invalid. .It Bq Er EAGAIN The process has not yet called .Fn aio_read @@ -101,6 +99,15 @@ or .It Bq Er EINTR A signal was delivered before the timeout expired and before any asynchronous I/O requests completed. +.It Bq Er EINVAL +The specified time limit is invalid. +.It Bq Er ENOSYS +The +.Fn aio_waitcomplete +system call is not supported. +This can occur if +.Xr aio 4 +support is not present. .It Bq Er EWOULDBLOCK .It Bq Er EINPROGRESS The specified time limit expired before any asynchronous I/O requests diff --git a/lib/libc/sys/aio_write.2 b/lib/libc/sys/aio_write.2 index f59406b8ab36..a7108a87e378 100644 --- a/lib/libc/sys/aio_write.2 +++ b/lib/libc/sys/aio_write.2 @@ -182,6 +182,13 @@ points outside the process's allocated address space. The asynchronous notification method in .Fa iocb->aio_sigevent.sigev_notify is invalid or not supported. +.It Bq Er ENOSYS +The +.Fn aio_write +system call is not supported. +This can occur if +.Xr aio 4 +support is not present. .It Bq Er EOPNOTSUPP Asynchronous write operations on the file descriptor .Fa iocb->aio_fildes @@ -265,7 +272,9 @@ The .Fn aio_write2 and .Fn aio_writev -system calls are FreeBSD extensions, +system calls are +.Fx +extensions, and should not be used in portable code. .Sh HISTORY The