From nobody Thu Oct 26 21:12:16 2023 X-Original-To: dev-commits-src-main@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 4SGdm1367Wz4yHck; Thu, 26 Oct 2023 21:12:17 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4SGdm10fyzz3X3B; Thu, 26 Oct 2023 21:12:17 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1698354737; 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=7cjXBRTnn/61HJ8FltDaIvopbeqwHI0bl6S1slztPis=; b=ITRGGU/2lgJ7VguXX0lBXzxt39yxpPeRO4oBf7ZZmCviBVio5FAevAggW0WMYFbYGP2P4+ up9UclNMPOMvXjr69ItVJxveDlQEJo1mWLYbp0wuSvs4sGPj2beEUmbImb9C7liXDdx6ly knpKCwxU+pVAETBNNKaQPxpXfHx9b4IeSqGDX2pD1HfnbYrisEWoSCPEJv5L0oJoKbGoMN +7WbVdJmf6BOqDN0nVFZtfGTllJXF32jukkBlxKAN0pwKC2rCq7Zn4V3vpK535q7uC9kEm Sfs+tkntT3XOdS9S3cv83XVmP8ZmDvm9uvgcbLvTbgfxKE+ZE0SHtJtIPR9ZrA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1698354737; 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=7cjXBRTnn/61HJ8FltDaIvopbeqwHI0bl6S1slztPis=; b=AUm7BbKAsP6hNp7rSIvar3bjyz21Dp9PQaKvo0x7YwhFafTAcUpa8myo9eyaCstkEL9n+4 GdeKPCFhzZb8a2992p1Otu0035HWGG27qExoGNWsyDHNGN3iTYD9K+GFzdHPukpiw4Vc5q Rh6Iq/xIKEGdL6M/nJ777aQTpD2gnMw9a+pTdkjQAH3hnFkw/dKHBJkQEqSwZ+QszA/q/Z tO8PeHDgpF9pkmz7s5FzMkLJaS1HM3a1jqOXOmZ54XTTwh2WXt+tEr04EACtOtAp2tVIIy o1PGfOXTsyz5Aoi3RYthj2G0fq3aIoN2r9EYv6BQ70RFXYgfVyq/rNsRMk/Wyw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1698354737; a=rsa-sha256; cv=none; b=acXUHXYQlqJv9o8taVXzR/tTkXC/5LdQasplagTj/u9kmjBkjQeS+kINa3HyvE2MHb052Q 47PdpjME1mDP9fT+KdGH2jCJ1ZzuoMKh1XurTax7sMP096wpAUcQcAOY4pxx3bwKGAuO0Z er7atJwBV8OyD2T5BnvcaduV+Xl/nsvEJ545t5vwRO/S1LWmh5JWLpviL1YerjXyd+W0ss PNY4ZtzA0FOihFvUjfYxxmZaZid3By2E7oGRih/JLHg29f4TUr/UY0DvEt9HRzUUwjvWP/ IXGmnk1ykCReVgqGhFKBjXv4eRemAC8z/4cHqXeM8FfIDGJbOA3wgq0NBbTiOg== 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 4SGdm06bnlzmqm; Thu, 26 Oct 2023 21:12:16 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 39QLCGaR056549; Thu, 26 Oct 2023 21:12:16 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 39QLCGI5056546; Thu, 26 Oct 2023 21:12:16 GMT (envelope-from git) Date: Thu, 26 Oct 2023 21:12:16 GMT Message-Id: <202310262112.39QLCGI5056546@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Konstantin Belousov Subject: git: 4f03a2cae8ae - main - pthread_mutexattr(3), _condattr(3): reference libthr(3) List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: kib X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 4f03a2cae8ae96446064da4e8a533ab24172bdcb Auto-Submitted: auto-generated The branch main has been updated by kib: URL: https://cgit.FreeBSD.org/src/commit/?id=4f03a2cae8ae96446064da4e8a533ab24172bdcb commit 4f03a2cae8ae96446064da4e8a533ab24172bdcb Author: Konstantin Belousov AuthorDate: 2023-10-23 23:03:42 +0000 Commit: Konstantin Belousov CommitDate: 2023-10-26 21:11:53 +0000 pthread_mutexattr(3), _condattr(3): reference libthr(3) Reviewed by: emaste Sponsored by: The FreeBSD Foundation MFC after: 3 days Differential revision: https://reviews.freebsd.org/D42344 --- share/man/man3/pthread_condattr.3 | 7 ++++++- share/man/man3/pthread_mutexattr.3 | 7 ++++++- 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/share/man/man3/pthread_condattr.3 b/share/man/man3/pthread_condattr.3 index f11b50070d3d..f3b1d3639827 100644 --- a/share/man/man3/pthread_condattr.3 +++ b/share/man/man3/pthread_condattr.3 @@ -24,7 +24,7 @@ .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.Dd May 31, 2016 +.Dd October 27, 2023 .Dt PTHREAD_CONDATTR 3 .Os .Sh NAME @@ -112,6 +112,10 @@ threads in the same process as the one that created the object. The condition variable it is attached to may be accessed by threads in processes other than the one that created the object. .El +See +.Xr libthr 3 +for details of the implementation of shared condition variables, +and their limitations. .Sh RETURN VALUES If successful, these functions return 0. Otherwise, an error number is returned to indicate the error. @@ -153,6 +157,7 @@ The value specified in is not one of the allowed values. .El .Sh SEE ALSO +.Xr libthr 3 , .Xr pthread_cond_init 3 , .Xr pthread_cond_timedwait 3 .Sh STANDARDS diff --git a/share/man/man3/pthread_mutexattr.3 b/share/man/man3/pthread_mutexattr.3 index 30537b9a9f86..8f4d0d9a06a4 100644 --- a/share/man/man3/pthread_mutexattr.3 +++ b/share/man/man3/pthread_mutexattr.3 @@ -29,7 +29,7 @@ .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE .\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -.Dd October 1, 2021 +.Dd October 27, 2023 .Dt PTHREAD_MUTEXATTR 3 .Os .Sh NAME @@ -150,6 +150,10 @@ threads in processes other than the one that created the object, assuming other processes share access to the memory where the mutex was allocated. .El +See +.Xr libthr 3 +for details of the implementation of the shared mutexes, +and their limitations. .Pp The .Fn pthread_mutexattr_setrobust @@ -334,6 +338,7 @@ Invalid value for .Fa attr . .El .Sh SEE ALSO +.Xr libthr 3 , .Xr pthread_mutex_init 3 .Sh STANDARDS The