From owner-svn-src-all@freebsd.org Sat Aug 10 08:29:25 2019 Return-Path: Delivered-To: svn-src-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 68D85B66B6; Sat, 10 Aug 2019 08:29:25 +0000 (UTC) (envelope-from kib@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) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 465Fdd25H9z4XXt; Sat, 10 Aug 2019 08:29:25 +0000 (UTC) (envelope-from kib@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 3DE43231B1; Sat, 10 Aug 2019 08:29:25 +0000 (UTC) (envelope-from kib@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id x7A8TPAM065290; Sat, 10 Aug 2019 08:29:25 GMT (envelope-from kib@FreeBSD.org) Received: (from kib@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id x7A8TO4P065285; Sat, 10 Aug 2019 08:29:24 GMT (envelope-from kib@FreeBSD.org) Message-Id: <201908100829.x7A8TO4P065285@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: kib set sender to kib@FreeBSD.org using -f From: Konstantin Belousov Date: Sat, 10 Aug 2019 08:29:24 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-12@freebsd.org Subject: svn commit: r350833 - stable/12/share/man/man3 X-SVN-Group: stable-12 X-SVN-Commit-Author: kib X-SVN-Commit-Paths: stable/12/share/man/man3 X-SVN-Commit-Revision: 350833 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 10 Aug 2019 08:29:25 -0000 Author: kib Date: Sat Aug 10 08:29:23 2019 New Revision: 350833 URL: https://svnweb.freebsd.org/changeset/base/350833 Log: MFC r350683, r350684: Clarify the robustness guarantees. Modified: stable/12/share/man/man3/pthread_cond_wait.3 stable/12/share/man/man3/pthread_mutex_consistent.3 stable/12/share/man/man3/pthread_mutex_lock.3 stable/12/share/man/man3/pthread_mutex_timedlock.3 stable/12/share/man/man3/pthread_mutex_trylock.3 Directory Properties: stable/12/ (props changed) Modified: stable/12/share/man/man3/pthread_cond_wait.3 ============================================================================== --- stable/12/share/man/man3/pthread_cond_wait.3 Sat Aug 10 08:27:36 2019 (r350832) +++ stable/12/share/man/man3/pthread_cond_wait.3 Sat Aug 10 08:29:23 2019 (r350833) @@ -27,7 +27,7 @@ .\" .\" $FreeBSD$ .\" -.Dd August 17, 2018 +.Dd August 7, 2019 .Dt PTHREAD_COND_WAIT 3 .Os .Sh NAME @@ -78,8 +78,8 @@ was not locked by the calling thread. .It Bq Er EOWNERDEAD The argument .Fa mutex -points to a robust mutex and the previous owning thread terminated -while holding the mutex lock. +points to a robust mutex and the process containing the previous owning +thread terminated while holding the mutex lock. The lock was granted to the caller and it is up to the new owner to make the state consistent. .It Bq Er ENOTRECOVERABLE Modified: stable/12/share/man/man3/pthread_mutex_consistent.3 ============================================================================== --- stable/12/share/man/man3/pthread_mutex_consistent.3 Sat Aug 10 08:27:36 2019 (r350832) +++ stable/12/share/man/man3/pthread_mutex_consistent.3 Sat Aug 10 08:29:23 2019 (r350833) @@ -41,9 +41,9 @@ .Ft int .Fn pthread_mutex_consistent "pthread_mutex_t *mutex" .Sh DESCRIPTION -If the thread owning a robust mutex terminates while holding the -mutex, the mutex becomes inconsistent and the next thread that -acquires the mutex lock is notified of the state by the return value +If the process containing the thread owning a robust mutex terminates +while holding the mutex, the mutex becomes inconsistent and the next thread +that acquires the mutex lock is notified of the state by the return value .Er EOWNERDEAD . In this case, the mutex does not become normally usable again until the state is marked consistent. Modified: stable/12/share/man/man3/pthread_mutex_lock.3 ============================================================================== --- stable/12/share/man/man3/pthread_mutex_lock.3 Sat Aug 10 08:27:36 2019 (r350832) +++ stable/12/share/man/man3/pthread_mutex_lock.3 Sat Aug 10 08:29:23 2019 (r350833) @@ -27,7 +27,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 29, 2016 +.Dd August 7, 2019 .Dt PTHREAD_MUTEX_LOCK 3 .Os .Sh NAME @@ -66,8 +66,8 @@ A deadlock would occur if the thread blocked waiting f .It Bq Er EOWNERDEAD The argument .Fa mutex -points to a robust mutex and the previous owning thread terminated -while holding the mutex lock. +points to a robust mutex and the process containing the previous owning +thread terminated while holding the mutex lock. The lock was granted to the caller and it is up to the new owner to make the state consistent. .It Bq Er ENOTRECOVERABLE Modified: stable/12/share/man/man3/pthread_mutex_timedlock.3 ============================================================================== --- stable/12/share/man/man3/pthread_mutex_timedlock.3 Sat Aug 10 08:27:36 2019 (r350832) +++ stable/12/share/man/man3/pthread_mutex_timedlock.3 Sat Aug 10 08:29:23 2019 (r350833) @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd August 17, 2018 +.Dd August 7, 2019 .Dt PTHREAD_MUTEX_TIMEDLOCK 3 .Os .Sh NAME @@ -92,8 +92,8 @@ The current thread already owns the .It Bq Er EOWNERDEAD The argument .Fa mutex -points to a robust mutex and the previous owning thread terminated -while holding the mutex lock. +points to a robust mutex and the process containing the previous owning +thread terminated while holding the mutex lock. The lock was granted to the caller and it is up to the new owner to make the state consistent. .It Bq Er ENOTRECOVERABLE Modified: stable/12/share/man/man3/pthread_mutex_trylock.3 ============================================================================== --- stable/12/share/man/man3/pthread_mutex_trylock.3 Sat Aug 10 08:27:36 2019 (r350832) +++ stable/12/share/man/man3/pthread_mutex_trylock.3 Sat Aug 10 08:29:23 2019 (r350833) @@ -27,7 +27,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 29, 2016 +.Dd August 7, 2019 .Dt PTHREAD_MUTEX_TRYLOCK 3 .Os .Sh NAME @@ -67,8 +67,8 @@ is already locked. .It Bq Er EOWNERDEAD The argument .Fa mutex -points to a robust mutex and the previous owning thread terminated -while holding the mutex lock. +points to a robust mutex and the process containing the previous owning +thread terminated while holding the mutex lock. The lock was granted to the caller and it is up to the new owner to make the state consistent. .It Bq Er ENOTRECOVERABLE