Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/lib/libpthread New sentence, new line.
details: https://anonhg.NetBSD.org/src/rev/ac0cc8779c33
branches: trunk
changeset: 582125:ac0cc8779c33
user: wiz <wiz%NetBSD.org@localhost>
date: Fri Jun 17 18:26:53 2005 +0000
description:
New sentence, new line.
diffstat:
lib/libpthread/pthread_barrier_destroy.3 | 5 ++-
lib/libpthread/pthread_cond_init.3 | 12 ++++++----
lib/libpthread/pthread_key_delete.3 | 5 ++-
lib/libpthread/pthread_mutexattr.3 | 36 +++++++++++++++++--------------
lib/libpthread/pthread_rwlock_destroy.3 | 6 ++--
lib/libpthread/pthread_rwlock_init.3 | 6 ++--
lib/libpthread/pthread_rwlock_rdlock.3 | 15 +++++++------
lib/libpthread/pthread_rwlock_unlock.3 | 6 ++--
lib/libpthread/pthread_rwlock_wrlock.3 | 6 ++--
lib/libpthread/pthread_rwlockattr.3 | 6 ++--
lib/libpthread/pthread_spin_destroy.3 | 6 ++--
lib/libpthread/pthread_spin_init.3 | 9 ++++---
lib/libpthread/pthread_spin_lock.3 | 6 ++--
lib/libpthread/pthread_spin_unlock.3 | 6 ++--
14 files changed, 70 insertions(+), 60 deletions(-)
diffs (truncated from 381 to 300 lines):
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_barrier_destroy.3
--- a/lib/libpthread/pthread_barrier_destroy.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_barrier_destroy.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_barrier_destroy.3,v 1.4 2005/06/17 18:07:06 peter Exp $
+.\" $NetBSD: pthread_barrier_destroy.3,v 1.5 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -42,7 +42,8 @@
.Fn pthread_barrier_destroy
function causes the resources allocated to
.Fa barrier
-to be released. No threads should be blocked on
+to be released.
+No threads should be blocked on
.Fa barrier .
.Sh RETURN VALUES
If successful,
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_cond_init.3
--- a/lib/libpthread/pthread_cond_init.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_cond_init.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_cond_init.3,v 1.6 2005/06/17 18:07:06 peter Exp $
+.\" $NetBSD: pthread_cond_init.3,v 1.7 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -76,10 +76,12 @@
is NULL the default attributes are used.
.Pp
Condition variables are intended to be used to communicate changes in
-the state of data shared between threads. Condition variables are
-always associated with a mutex to provide synchronized access to the
-shared data. A single predicate should always be associated with a
-condition variable. The predicate should identify a state of the
+the state of data shared between threads.
+Condition variables are always associated with a mutex to provide
+synchronized access to the shared data.
+A single predicate should always be associated with a
+condition variable.
+The predicate should identify a state of the
shared data that must be true before the thread proceeds.
.Sh RETURN VALUES
If successful, the
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_key_delete.3
--- a/lib/libpthread/pthread_key_delete.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_key_delete.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_key_delete.3,v 1.4 2003/07/04 08:42:57 wiz Exp $
+.\" $NetBSD: pthread_key_delete.3,v 1.5 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -129,6 +129,7 @@
and
.Fn pthread_key_delete
are flawed and do not permit a clean implementation without
-potential problems. The current implementation of these functions
+potential problems.
+The current implementation of these functions
.Nx
in addresses these problems by not supporting key reuse.
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_mutexattr.3
--- a/lib/libpthread/pthread_mutexattr.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_mutexattr.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_mutexattr.3,v 1.5 2005/06/17 18:07:06 peter Exp $
+.\" $NetBSD: pthread_mutexattr.3,v 1.6 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -106,7 +106,8 @@
.Pp
The
.Fn pthread_mutexattr_settype
-functions set the mutex type value of the attribute. Valid mutex types are:
+functions set the mutex type value of the attribute.
+Valid mutex types are:
.Dv PTHREAD_MUTEX_NORMAL ,
.Dv PTHREAD_MUTEX_ERRORCHECK ,
.Dv PTHREAD_MUTEX_RECURSIVE ,
@@ -121,8 +122,8 @@
mutexes do not check for usage errors.
.Dv PTHREAD_MUTEX_NORMAL
mutexes will deadlock if reentered, and result in undefined behavior if a
-locked mutex is unlocked by another thread. Attempts to unlock an already
-unlocked
+locked mutex is unlocked by another thread.
+Attempts to unlock an already unlocked
.Dv PTHREAD_MUTEX_NORMAL
mutex will result in undefined behavior.
.Pp
@@ -130,11 +131,11 @@
mutexes do check for usage errors.
If an attempt is made to relock a
.Dv PTHREAD_MUTEX_ERRORCHECK
-mutex without first dropping the lock an error will be returned. If a thread
-attempts to unlock a
+mutex without first dropping the lock an error will be returned.
+If a thread attempts to unlock a
.Dv PTHREAD_MUTEX_ERRORCHECK
-mutex that is locked by another thread, an error will be returned. If a
-thread attempts to unlock a
+mutex that is locked by another thread, an error will be returned.
+If a thread attempts to unlock a
.Dv PTHREAD_MUTEX_ERRORCHECK
thread that is unlocked, an error will be
returned.
@@ -143,13 +144,15 @@
mutexes allow recursive locking.
An attempt to relock a
.Dv PTHREAD_MUTEX_RECURSIVE
-mutex that is already locked by the same thread succeeds. An equivalent
-number of
+mutex that is already locked by the same thread succeeds.
+An equivalent number of
.Xr pthread_mutex_unlock 3
-calls are needed before the mutex will wake another thread waiting on this
-lock. If a thread attempts to unlock a
+calls are needed before the mutex will wake another thread waiting
+on this lock.
+If a thread attempts to unlock a
.Dv PTHREAD_MUTEX_RECURSIVE
-mutex that is locked by another thread, an error will be returned. If a thread attempts to unlock a
+mutex that is locked by another thread, an error will be returned.
+If a thread attempts to unlock a
.Dv PTHREAD_MUTEX_RECURSIVE
thread that is unlocked, an error will be returned.
.Pp
@@ -157,13 +160,14 @@
mutexes result in undefined behavior if reentered.
Unlocking a
.Dv PTHREAD_MUTEX_DEFAULT
-mutex locked by another thread will result in undefined behavior. Attempts to unlock an already
-unlocked
+mutex locked by another thread will result in undefined behavior.
+Attempts to unlock an already unlocked
.Dv PTHREAD_MUTEX_DEFAULT
mutex will result in undefined behavior.
.Pp
.Fn pthread_mutexattr_gettype
-functions copy the type value of the attribute to the location pointed to by the second parameter.
+functions copy the type value of the attribute to the location
+pointed to by the second parameter.
.Sh RETURN VALUES
If successful, these functions return 0.
Otherwise, an error number is returned to indicate the error.
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_rwlock_destroy.3
--- a/lib/libpthread/pthread_rwlock_destroy.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_rwlock_destroy.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_rwlock_destroy.3,v 1.4 2003/07/04 08:41:25 wiz Exp $
+.\" $NetBSD: pthread_rwlock_destroy.3,v 1.5 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -71,8 +71,8 @@
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlock_destroy
-function will return zero. Otherwise an error number will be returned
-to indicate the error.
+function will return zero.
+Otherwise an error number will be returned to indicate the error.
.Sh ERRORS
The
.Fn pthread_rwlock_destroy
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_rwlock_init.3
--- a/lib/libpthread/pthread_rwlock_init.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_rwlock_init.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_rwlock_init.3,v 1.6 2005/03/21 17:55:07 kleink Exp $
+.\" $NetBSD: pthread_rwlock_init.3,v 1.7 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -79,8 +79,8 @@
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlock_init
-function will return zero. Otherwise an error number will be returned
-to indicate the error.
+function will return zero.
+Otherwise an error number will be returned to indicate the error.
.Sh ERRORS
The
.Fn pthread_rwlock_init
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_rwlock_rdlock.3
--- a/lib/libpthread/pthread_rwlock_rdlock.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_rwlock_rdlock.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_rwlock_rdlock.3,v 1.8 2005/03/21 17:55:07 kleink Exp $
+.\" $NetBSD: pthread_rwlock_rdlock.3,v 1.9 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -77,9 +77,9 @@
provided that
.Fa lock
is not presently held for writing and no writer threads are
-presently blocked on the lock. If the read lock cannot be
-immediately acquired, the calling thread blocks until it can
-acquire the lock.
+presently blocked on the lock.
+If the read lock cannot be immediately acquired, the calling thread
+blocks until it can acquire the lock.
.Pp
The
.Fn pthread_rwlock_timedrdlock
@@ -94,7 +94,8 @@
but does not block if the lock cannot be immediately obtained (i.e.,
the lock is held for writing or there are waiting writers).
.Pp
-A thread may hold multiple concurrent read locks. If so,
+A thread may hold multiple concurrent read locks.
+If so,
.Fn pthread_rwlock_unlock
must be called once for each lock obtained.
.Pp
@@ -106,8 +107,8 @@
.Fn pthread_rwlock_timedrdlock ,
and
.Fn pthread_rwlock_tryrdlock
-functions will return zero. Otherwise an error number will be returned
-to indicate the error.
+functions will return zero.
+Otherwise an error number will be returned to indicate the error.
.Sh ERRORS
The
.Fn pthread_rwlock_tryrdlock
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_rwlock_unlock.3
--- a/lib/libpthread/pthread_rwlock_unlock.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_rwlock_unlock.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_rwlock_unlock.3,v 1.5 2003/07/04 08:41:25 wiz Exp $
+.\" $NetBSD: pthread_rwlock_unlock.3,v 1.6 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -75,8 +75,8 @@
.Sh RETURN VALUES
If successful, the
.Fn pthread_rwlock_unlock
-function will return zero. Otherwise an error number will be returned
-to indicate the error.
+function will return zero.
+Otherwise an error number will be returned to indicate the error.
.Pp
The results are undefined if
.Fa lock
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_rwlock_wrlock.3
--- a/lib/libpthread/pthread_rwlock_wrlock.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_rwlock_wrlock.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_rwlock_wrlock.3,v 1.6 2005/03/21 17:55:07 kleink Exp $
+.\" $NetBSD: pthread_rwlock_wrlock.3,v 1.7 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -95,8 +95,8 @@
.Fn pthread_rwlock_timedwrlock ,
and
.Fn pthread_rwlock_trywrlock
-functions will return zero. Otherwise an error number will be returned
-to indicate the error.
+functions will return zero.
+Otherwise an error number will be returned to indicate the error.
.Sh ERRORS
The
.Fn pthread_rwlock_trywrlock
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_rwlockattr.3
--- a/lib/libpthread/pthread_rwlockattr.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_rwlockattr.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_rwlockattr.3,v 1.5 2005/06/17 18:07:06 peter Exp $
+.\" $NetBSD: pthread_rwlockattr.3,v 1.6 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -81,8 +81,8 @@
.Fn pthread_rwlockattr_init
and
.Fn pthread_rwlockattr_destroy
-functions return zero. Otherwise an error number will be returned
-to indicate the error.
+functions return zero.
+Otherwise an error number will be returned to indicate the error.
.Sh ERRORS
.Fn pthread_rwlockattr_init
shall fail if:
diff -r 77bf3d1c27aa -r ac0cc8779c33 lib/libpthread/pthread_spin_destroy.3
--- a/lib/libpthread/pthread_spin_destroy.3 Fri Jun 17 18:26:22 2005 +0000
+++ b/lib/libpthread/pthread_spin_destroy.3 Fri Jun 17 18:26:53 2005 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: pthread_spin_destroy.3,v 1.2 2003/06/08 06:44:34 thorpej Exp $
+.\" $NetBSD: pthread_spin_destroy.3,v 1.3 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
Home |
Main Index |
Thread Index |
Old Index