Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

New sentence, new line.

Browse Source
This commit is contained in:
wiz 2005-06-17 18:26:53 +00:00
parent e17db753e7
commit 52e496a68e
14 changed files with 70 additions and 60 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
lib/libpthread/pthread_barrier_destroy.3
View File

@ -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 @@ The
.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,

12
lib/libpthread/pthread_cond_init.3
View File

@ -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 @@ If
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

5
lib/libpthread/pthread_key_delete.3
View File

@ -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 @@ The current specifications of
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.

36
lib/libpthread/pthread_mutexattr.3
View File

@ -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 @@ function destroys
.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 @@ is
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 @@ mutex will result in undefined behavior.
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 @@ returned.
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 @@ thread that is unlocked, an error will be returned.
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.

6
lib/libpthread/pthread_rwlock_destroy.3
View File

@ -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 @@ function is used to destroy a read/write lock previously created with
.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

6
lib/libpthread/pthread_rwlock_init.3
View File

@ -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 @@ with an already initialized lock are undefined.
.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

15
lib/libpthread/pthread_rwlock_rdlock.3
View File

@ -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 @@ function acquires a read lock on
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 @@ function performs the same action as
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 @@ If successful, the
.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

6
lib/libpthread/pthread_rwlock_unlock.3
View File

@ -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 @@ or
.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

6
lib/libpthread/pthread_rwlock_wrlock.3
View File

@ -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 @@ If successful, the
.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

6
lib/libpthread/pthread_rwlockattr.3
View File

@ -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 @@ If successful, the
.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:

6
lib/libpthread/pthread_spin_destroy.3
View File

@ -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.
@ -45,8 +45,8 @@ function is used to destroy a spin lock previously created with
.Sh RETURN VALUES
If successful, the
.Fn pthread_spin_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_spin_destroy

9
lib/libpthread/pthread_spin_init.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pthread_spin_init.3,v 1.4 2005/06/17 18:07:06 peter Exp $
.\" $NetBSD: pthread_spin_init.3,v 1.5 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -40,7 +40,8 @@
.Sh DESCRIPTION
The
.Fn pthread_spin_init
function is used to initialize a spinlock. The
function is used to initialize a spinlock.
The
.Fa pshared
parameter is currently unused and all spinlocks exhibit the
.Dv PTHREAD_PROCESS_SHARED
@ -52,8 +53,8 @@ with an already initialized lock are undefined.
.Sh RETURN VALUES
If successful, the
.Fn pthread_spin_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_spin_init

6
lib/libpthread/pthread_spin_lock.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pthread_spin_lock.3,v 1.4 2003/07/04 10:19:42 wiz Exp $
.\" $NetBSD: pthread_spin_lock.3,v 1.5 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -61,8 +61,8 @@ If successful, the
.Fn pthread_spin_lock
and
.Fn pthread_spin_trylock
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_spin_trylock

6
lib/libpthread/pthread_spin_unlock.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pthread_spin_unlock.3,v 1.4 2003/07/04 08:41:26 wiz Exp $
.\" $NetBSD: pthread_spin_unlock.3,v 1.5 2005/06/17 18:26:53 wiz Exp $
.\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -47,8 +47,8 @@ or
.Sh RETURN VALUES
If successful, the
.Fn pthread_spin_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