Date: Sat, 10 Aug 2019 08:29:24 +0000 (UTC) From: Konstantin Belousov <kib@FreeBSD.org> 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 Message-ID: <201908100829.x7A8TO4P065285@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201908100829.x7A8TO4P065285>