FreeBSD Bugzilla – Attachment 49497 Details for
Bug 75581
typos in man3 manual pages, pthread_attr_setcreatesuspend_np.3, pthread_cancel.3, pthread_once.3, pthread_setspecific.3, pthread_testcancel.3, queue.3,
Home
|
New
|
Browse
|
Search
|
[?]
|
Reports
|
Help
|
New Account
|
Log In
Remember
[x]
|
Forgot Password
Login:
[x]
[patch]
file.diff
file.diff (text/plain), 7.26 KB, created by
n-kogane
on 2004-12-28 17:40:29 UTC
(
hide
)
Description:
file.diff
Filename:
MIME Type:
Creator:
n-kogane
Created:
2004-12-28 17:40:29 UTC
Size:
7.26 KB
patch
obsolete
>diff -u pthread_attr_setcreatesuspend_np.3.orig ./pthread_attr_setcreatesuspend_np.3 >--- pthread_attr_setcreatesuspend_np.3.orig Sat Dec 18 00:08:14 2004 >+++ ./pthread_attr_setcreatesuspend_np.3 Wed Dec 29 02:26:20 2004 >@@ -29,7 +29,7 @@ > .Os > .Sh NAME > .Nm pthread_attr_setcreatesuspend_np >-.Nd prepare attribute for creattion of suspended thread >+.Nd prepare attribute for creation of suspended thread > .Sh LIBRARY > .Lb libc_r > .Sh SYNOPSIS >diff -u pthread_cancel.3.orig ./pthread_cancel.3 >--- pthread_cancel.3.orig Sat Dec 18 00:08:14 2004 >+++ ./pthread_cancel.3 Wed Dec 29 02:27:02 2004 >@@ -17,7 +17,7 @@ > function requests that > .Fa thread > be canceled. >-The target thread's cancelability state and type determines >+The target thread's cancellability state and type determines > when the cancellation takes effect. > When the cancellation is acted on, > the cancellation cleanup handlers for >diff -u pthread_once.3.orig ./pthread_once.3 >--- pthread_once.3.orig Sat Dec 18 00:08:14 2004 >+++ ./pthread_once.3 Wed Dec 29 02:27:52 2004 >@@ -76,7 +76,8 @@ > However, if > .Fn init_routine > is a cancellation point and is cancelled, the effect on >-.Fa once_control is as if >+.Fa once_control >+is as if > .Fn pthread_once > was never called. > .Pp >diff -u pthread_setspecific.3.orig ./pthread_setspecific.3 >--- pthread_setspecific.3.orig Sat Dec 18 00:08:14 2004 >+++ ./pthread_setspecific.3 Wed Dec 29 02:28:34 2004 >@@ -49,7 +49,7 @@ > .Fa key > obtained via a previous call to > .Fn pthread_key_create . >-Different threads man bind different values to the same key. >+Different threads can bind different values to the same key. > These values are > typically pointers to blocks of dynamically allocated memory that have been > reserved for use by the calling thread. >diff -u pthread_testcancel.3.orig ./pthread_testcancel.3 >--- pthread_testcancel.3.orig Sat Dec 18 00:08:14 2004 >+++ ./pthread_testcancel.3 Wed Dec 29 02:32:49 2004 >@@ -6,7 +6,7 @@ > .Nm pthread_setcancelstate , > .Nm pthread_setcanceltype , > .Nm pthread_testcancel >-.Nd set cancelability state >+.Nd set cancellability state > .Sh LIBRARY > .Lb libc_r > .Sh SYNOPSIS >@@ -20,14 +20,14 @@ > .Sh DESCRIPTION > The > .Fn pthread_setcancelstate >-function atomically both sets the calling thread's cancelability state >+function atomically both sets the calling thread's cancellability state > to the indicated > .Fa state > and, if > .Fa oldstate > is not > .Dv NULL , >-returns the previous cancelability state at the location referenced by >+returns the previous cancellability state at the location referenced by > .Fa oldstate . > Legal values for > .Fa state >@@ -38,14 +38,14 @@ > .Pp > The > .Fn pthread_setcanceltype >-function atomically both sets the calling thread's cancelability type >+function atomically both sets the calling thread's cancellability type > to the indicated > .Fa type > and, if > .Fa oldtype > is not > .Dv NULL , >-returns the previous cancelability type at the location referenced by >+returns the previous cancellability type at the location referenced by > .Fa oldtype . > Legal values for > .Fa type >@@ -54,7 +54,7 @@ > and > .Dv PTHREAD_CANCEL_ASYNCHRONOUS . > .Pp >-The cancelability state and type of any newly created threads, including the >+The cancellability state and type of any newly created threads, including the > thread in which > .Fn main > was first invoked, are >@@ -68,33 +68,35 @@ > function creates a cancellation point in the calling thread. > The > .Fn pthread_testcancel >-function has no effect if cancelability is disabled. >+function has no effect if cancellability is disabled. > .Pp > .Ss Cancelability States >-The cancelability state of a thread determines the action taken upon >+The cancellability state of a thread determines the action taken upon > receipt of a cancellation request. > The thread may control cancellation in > a number of ways. > .Pp > Each thread maintains its own >-.Dq cancelability state >+.Dq cancellability state > which may be encoded in two bits: > .Bl -hang > .It Em Cancelability Enable >-When cancelability is >+.br >+When cancellability is > .Dv PTHREAD_CANCEL_DISABLE , > cancellation requests against the target thread are held pending. > .It Em Cancelability Type >-When cancelability is enabled and the cancelability type is >+.br >+When cancellability is enabled and the cancellability type is > .Dv PTHREAD_CANCEL_ASYNCHRONOUS , > new or pending cancellation requests may be acted upon at any time. >-When cancelability is enabled and the cancelability type is >+When cancellability is enabled and the cancellability type is > .Dv PTHREAD_CANCEL_DEFERRED , > cancellation requests are held pending until a cancellation point (see > below) is reached. >-If cancelability is disabled, the setting of the >-cancelability type has no immediate effect as all cancellation requests >-are held pending; however, once cancelability is enabled again the new >+If cancellability is disabled, the setting of the >+cancellability type has no immediate effect as all cancellation requests >+are held pending; however, once cancellability is enabled again the new > type will be in effect. > .El > .Ss Cancellation Points >@@ -147,27 +149,27 @@ > Objects may depend > on other objects. > .Pp >-First, cancelability should only be disabled on entry to an object, never >+First, cancellability should only be disabled on entry to an object, never > explicitly enabled. >-On exit from an object, the cancelability state should >+On exit from an object, the cancellability state should > always be restored to its value on entry to the object. > .Pp > This follows from a modularity argument: if the client of an object (or the >-client of an object that uses that object) has disabled cancelability, it is >+client of an object that uses that object) has disabled cancellability, it is > because the client doesn't want to have to worry about how to clean up if the > thread is canceled while executing some sequence of actions. > If an object >-is called in such a state and it enables cancelability and a cancellation >+is called in such a state and it enables cancellability and a cancellation > request is pending for that thread, then the thread will be canceled, > contrary to the wish of the client that disabled. > .Pp >-Second, the cancelability type may be explicitly set to either >+Second, the cancellability type may be explicitly set to either > .Em deferred > or > .Em asynchronous > upon entry to an object. >-But as with the cancelability state, on exit from >-an object that cancelability type should always be restored to its value on >+But as with the cancellability state, on exit from >+an object that cancellability type should always be restored to its value on > entry to the object. > .Pp > Finally, only functions that are cancel-safe may be called from a thread that >diff -u queue.3.orig ./queue.3 >--- queue.3.orig Sat Dec 18 00:08:47 2004 >+++ ./queue.3 Wed Dec 29 02:36:26 2004 >@@ -638,7 +638,7 @@ > .Pp > The macro > .Nm LIST_EMPTY >-evaluates to true if their are no elements in the list. >+evaluates to true if there are no elements in the list. > .Pp > The macro > .Nm LIST_ENTRY >diff -u rand48.3.orig ./rand48.3 >--- rand48.3.orig Sat Dec 18 00:08:11 2004 >+++ ./rand48.3 Wed Dec 29 02:37:11 2004 >@@ -73,7 +73,7 @@ > return values of type double. > The full 48 bits of r(n+1) are > loaded into the mantissa of the returned value, with the exponent set >-such that the values produced lie in the interval [0.0, 1.0). >+such that the values produced lie in the interval [0.0, 1.0]. > .Pp > The > .Fn lrand48
You cannot view the attachment while viewing its details because your browser does not support IFRAMEs.
View the attachment on a separate page
.
View Attachment As Diff
View Attachment As Raw
Actions:
View
|
Diff
Attachments on
bug 75581
: 49497