diff options
author | marha <marha@users.sourceforge.net> | 2011-01-17 18:45:14 +0000 |
---|---|---|
committer | marha <marha@users.sourceforge.net> | 2011-01-17 18:45:14 +0000 |
commit | 132e30bb74d8fd11d7d501927ffcc02676dff2a5 (patch) | |
tree | 88613375e3302942f764fa3a4a575dc5837b0ea4 /pthreads/manual | |
parent | 508dc9ebf90c336c43608a7b8e94d0d2bdf6c1aa (diff) | |
parent | 0cebe8443b7c3ebf838d1a58a83851d79a6fba1e (diff) | |
download | vcxsrv-132e30bb74d8fd11d7d501927ffcc02676dff2a5.tar.gz vcxsrv-132e30bb74d8fd11d7d501927ffcc02676dff2a5.tar.bz2 vcxsrv-132e30bb74d8fd11d7d501927ffcc02676dff2a5.zip |
svn merge ^/branches/released .
Diffstat (limited to 'pthreads/manual')
-rw-r--r-- | pthreads/manual/ChangeLog | 128 | ||||
-rw-r--r-- | pthreads/manual/pthread_barrier_init.html | 395 | ||||
-rw-r--r-- | pthreads/manual/pthread_barrier_wait.html | 326 | ||||
-rw-r--r-- | pthreads/manual/pthread_setschedparam.html | 225 | ||||
-rw-r--r-- | pthreads/manual/pthread_win32_attach_detach_np.html | 148 |
5 files changed, 609 insertions, 613 deletions
diff --git a/pthreads/manual/ChangeLog b/pthreads/manual/ChangeLog index c07cdd702..3b7ab307b 100644 --- a/pthreads/manual/ChangeLog +++ b/pthreads/manual/ChangeLog @@ -1,62 +1,66 @@ -2005-05-06 Ross Johnson <ross at callisto.canberra.edu.au> - - * PortabilityIssues.html: Was nonPortableIssues.html. - * index.html: Updated; add table of contents at top. - * *.html: Add Pthreads-win32 header info; add link back to the - index page 'index.html'. - -2005-05-06 Ross Johnson <ross at callisto.canberra.edu.au> - - * index.html: New. - * nonPortableIssues.html: New. - * pthread_attr_init.html: New. - * pthread_attr_setstackaddr.html: New. - * pthread_attr_setstacksize.html: New. - * pthread_barrierattr_init.html: New. - * pthread_barrierattr_setpshared.html: New. - * pthread_barrier_init.html: New. - * pthread_barrier_wait.html: New. - * pthreadCancelableWait.html: New. - * pthread_cancel.html: New. - * pthread_cleanup_push.html: New. - * pthread_condattr_init.html: New. - * pthread_condattr_setpshared.html: New. - * pthread_cond_init.html: New. - * pthread_create.html: New. - * pthread_delay_np.html: New. - * pthread_detach.html: New. - * pthread_equal.html: New. - * pthread_exit.html: New. - * pthread_getw32threadhandle_np.html: New. - * pthread_join.html: New. - * pthread_key_create.html: New. - * pthread_kill.html: New. - * pthread_mutexattr_init.html: New. - * pthread_mutexattr_setpshared.html: New. - * pthread_mutex_init.html: New. - * pthread_num_processors_np.html: New. - * pthread_once.html: New. - * pthread_rwlockattr_init.html: New. - * pthread_rwlockattr_setpshared.html: New. - * pthread_rwlock_init.html: New. - * pthread_rwlock_rdlock.html: New. - * pthread_rwlock_timedrdlock.html: New. - * pthread_rwlock_timedwrlock.html: New. - * pthread_rwlock_unlock.html: New. - * pthread_rwlock_wrlock.html: New. - * pthread_self.html: New. - * pthread_setcancelstate.html: New. - * pthread_setcanceltype.html: New. - * pthread_setconcurrency.html: New. - * pthread_setschedparam.html: New. - * pthread_spin_init.html: New. - * pthread_spin_lock.html: New. - * pthread_spin_unlock.html: New. - * pthread_timechange_handler_np.html: New. - * pthread_win32_attach_detach_np.html: New. - * pthread_win32_test_features_np.html: New. - * sched_get_priority_max.html: New. - * sched_getscheduler.html: New. - * sched_setscheduler.html: New. - * sched_yield.html: New. - * sem_init.html: New. +2008-06-30 Ross Johnson <ross at callisto.canberra.edu.au>
+
+ pthread_setschedparam.html: Fix "see also" links.
+
+2005-05-06 Ross Johnson <ross at callisto.canberra.edu.au>
+
+ * PortabilityIssues.html: Was nonPortableIssues.html.
+ * index.html: Updated; add table of contents at top.
+ * *.html: Add Pthreads-win32 header info; add link back to the
+ index page 'index.html'.
+
+2005-05-06 Ross Johnson <ross at callisto.canberra.edu.au>
+
+ * index.html: New.
+ * nonPortableIssues.html: New.
+ * pthread_attr_init.html: New.
+ * pthread_attr_setstackaddr.html: New.
+ * pthread_attr_setstacksize.html: New.
+ * pthread_barrierattr_init.html: New.
+ * pthread_barrierattr_setpshared.html: New.
+ * pthread_barrier_init.html: New.
+ * pthread_barrier_wait.html: New.
+ * pthreadCancelableWait.html: New.
+ * pthread_cancel.html: New.
+ * pthread_cleanup_push.html: New.
+ * pthread_condattr_init.html: New.
+ * pthread_condattr_setpshared.html: New.
+ * pthread_cond_init.html: New.
+ * pthread_create.html: New.
+ * pthread_delay_np.html: New.
+ * pthread_detach.html: New.
+ * pthread_equal.html: New.
+ * pthread_exit.html: New.
+ * pthread_getw32threadhandle_np.html: New.
+ * pthread_join.html: New.
+ * pthread_key_create.html: New.
+ * pthread_kill.html: New.
+ * pthread_mutexattr_init.html: New.
+ * pthread_mutexattr_setpshared.html: New.
+ * pthread_mutex_init.html: New.
+ * pthread_num_processors_np.html: New.
+ * pthread_once.html: New.
+ * pthread_rwlockattr_init.html: New.
+ * pthread_rwlockattr_setpshared.html: New.
+ * pthread_rwlock_init.html: New.
+ * pthread_rwlock_rdlock.html: New.
+ * pthread_rwlock_timedrdlock.html: New.
+ * pthread_rwlock_timedwrlock.html: New.
+ * pthread_rwlock_unlock.html: New.
+ * pthread_rwlock_wrlock.html: New.
+ * pthread_self.html: New.
+ * pthread_setcancelstate.html: New.
+ * pthread_setcanceltype.html: New.
+ * pthread_setconcurrency.html: New.
+ * pthread_setschedparam.html: New.
+ * pthread_spin_init.html: New.
+ * pthread_spin_lock.html: New.
+ * pthread_spin_unlock.html: New.
+ * pthread_timechange_handler_np.html: New.
+ * pthread_win32_attach_detach_np.html: New.
+ * pthread_win32_test_features_np.html: New.
+ * sched_get_priority_max.html: New.
+ * sched_getscheduler.html: New.
+ * sched_setscheduler.html: New.
+ * sched_yield.html: New.
+ * sem_init.html: New.
diff --git a/pthreads/manual/pthread_barrier_init.html b/pthreads/manual/pthread_barrier_init.html index 065c1296f..637630ea5 100644 --- a/pthreads/manual/pthread_barrier_init.html +++ b/pthreads/manual/pthread_barrier_init.html @@ -1,200 +1,197 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> -<HTML> -<HEAD> - <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8"> - <TITLE>"PTHREAD_BARRIER_DESTROY"(P) manual page</TITLE> - <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0 (Linux)"> - <META NAME="CREATED" CONTENT="20050504;11372800"> - <META NAME="CHANGEDBY" CONTENT="Ross Johnson"> - <META NAME="CHANGED" CONTENT="20060408;9450100"> - <!-- manual page source format generated by PolyglotMan v3.2, --> - <!-- available at http://polyglotman.sourceforge.net/ --> -</HEAD> -<BODY LANG="en-GB" BGCOLOR="#ffffff" DIR="LTR"> -<H4>POSIX Threads for Windows – REFERENCE - <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A></H4> -<P><A HREF="index.html">Reference Index</A></P> -<P><A HREF="#toc">Table of Contents</A></P> -<H2><A HREF="#toc0" NAME="sect0">Name</A></H2> -<P>pthread_barrier_destroy, pthread_barrier_init - destroy and -initialize a barrier object (<B>ADVANCED REALTIME THREADS</B>) -</P> -<H2><A HREF="#toc1" NAME="sect1">Synopsis</A></H2> -<P><B>#include <pthread.h> </B> -</P> -<P><B>int pthread_barrier_destroy(pthread_barrier_t *</B><I>barrier</I><B>); -<BR>int pthread_barrier_init(pthread_barrier_t *restrict</B> <I>barrier</I><B>, -const pthread_barrierattr_t *restrict</B> <I>attr</I><B>, unsigned</B> -<I>count</I><B>); </B> -</P> -<H2><A HREF="#toc2" NAME="sect2">Description</A></H2> -<P>The <B>pthread_barrier_destroy</B> function shall destroy the -barrier referenced by <I>barrier</I> and release any resources used -by the barrier. The effect of subsequent use of the barrier is -undefined until the barrier is reinitialized by another call to -<B>pthread_barrier_init</B> . An implementation may use this function -to set <I>barrier</I> to an invalid value. The results are undefined -if <B>pthread_barrier_destroy</B> is called when any thread is -blocked on the barrier, or if this function is called with an -uninitialized barrier. -</P> -<P>The <B>pthread_barrier_init</B> function shall allocate any -resources required to use the barrier referenced by <I>barrier</I> -and shall initialize the barrier with attributes referenced by <I>attr</I>. -If <I>attr</I> is NULL, the default barrier attributes shall be used; -the effect is the same as passing the address of a default barrier -attributes object. The results are undefined if <B>pthread_barrier_init</B> -is called when any thread is blocked on the barrier (that is, has not -returned from the <A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A> -call). The results are undefined if a barrier is used without first -being initialized. The results are undefined if <B>pthread_barrier_init</B> -is called specifying an already initialized barrier. -</P> -<P>The <I>count</I> argument specifies the number of threads that -must call <A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A> -before any of them successfully return from the call. The value -specified by <I>count</I> must be greater than zero. -</P> -<P>If the <B>pthread_barrier_init</B> function fails, the barrier -shall not be initialized and the contents of <I>barrier</I> are -undefined. -</P> -<P>Only the object referenced by <I>barrier</I> may be used for -performing synchronization. The result of referring to copies of that -object in calls to <B>pthread_barrier_destroy</B> <B>or</B> -<A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A> -is undefined.</P> -<H2><A HREF="#toc3" NAME="sect3">Return Value</A></H2> -<P>Upon successful completion, these functions shall return zero; -otherwise, an error number shall be returned to indicate the error. -</P> -<H2><A HREF="#toc4" NAME="sect4">Errors</A></H2> -<P>The <B>pthread_barrier_destroy</B> function may fail if: -</P> -<DL> - <DT><B>EBUSY</B> - </DT><DD> - The implementation has detected an attempt to destroy a barrier - while it is in use (for example, while being used in a - <A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A> - call) by another thread. - </DD><DT> - <B>EINVAL</B> - </DT><DD STYLE="margin-bottom: 0.5cm"> - The value specified by <I>barrier</I> is invalid. - </DD></DL> -<P> -The <B>pthread_barrier_init</B> function shall fail if: -</P> -<DL> - <DT><B>EAGAIN</B> - </DT><DD> - The system lacks the necessary resources to initialize another - barrier. - </DD><DT> - <B>EINVAL</B> - </DT><DD> - The value specified by <I>count</I> is equal to zero. - </DD><DT> - <B>ENOMEM</B> - </DT><DD STYLE="margin-bottom: 0.5cm"> - Insufficient memory exists to initialize the barrier. - </DD></DL> -<P> -The <B>pthread_barrier_init</B> function may fail if: -</P> -<DL> - <DT><B>EBUSY</B> - </DT><DD> - The implementation has detected an attempt to reinitialize a barrier - while it is in use (for example, while being used in a - <A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A> - call) by another thread. - </DD><DT> - <B>EINVAL</B> - </DT><DD STYLE="margin-bottom: 0.5cm"> - The value specified by <I>attr</I> is invalid. - </DD></DL> -<P> -These functions shall not return an error code of [EINTR]. -</P> -<P><I>The following sections are informative.</I> -</P> -<H2><A HREF="#toc5" NAME="sect5">Examples</A></H2> -<P>None. -</P> -<H2><A HREF="#toc6" NAME="sect6">Application Usage</A></H2> -<P>The <B>pthread_barrier_destroy</B> and <B>pthread_barrier_init</B> -functions are part of the Barriers option and need not be provided on -all implementations. -</P> -<P><B>Pthreads-w32</B> defines <B>_POSIX_BARRIERS</B> to indicate -that these routines are implemented and may be used.</P> -<H2><A HREF="#toc7" NAME="sect7">Rationale</A></H2> -<P>None. -</P> -<H2><A HREF="#toc8" NAME="sect8">Future Directions</A></H2> -<P>None. -</P> -<H2><A HREF="#toc11" NAME="sect11">Known Bugs</A></H2> -<DL> - <DD STYLE="margin-left: 0cm; margin-bottom: 0.5cm">In - <B><SPAN LANG="en-GB"><SPAN LANG="en-GB">pthreads-win32</SPAN></SPAN></B>, - <A HREF="pthread_barrier_wait.html"></A><A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A><A HREF="pthread_barrier_wait.html"></A> - may deadlock if the number of running threads able to wait on the - barrier object exceeds the value given as the <I><SPAN LANG="en-GB"><SPAN LANG="en-GB">count</SPAN></SPAN></I> - parameter in <B>pthread_barrier_init</B>. - </DD></DL> -<H2> -<A HREF="#toc9" NAME="sect9">See Also</A></H2> -<P><A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A> -<B>,</B> the Base Definitions volume of IEEE Std 1003.1-2001, -<I><pthread.h></I> -</P> -<H2><A HREF="#toc10" NAME="sect10">Copyright</A></H2> -<P>Portions of this text are reprinted and reproduced in electronic -form from IEEE Std 1003.1, 2003 Edition, Standard for Information -Technology -- Portable Operating System Interface (POSIX), The Open -Group Base Specifications Issue 6, Copyright (C) 2001-2003 by the -Institute of Electrical and Electronics Engineers, Inc and The Open -Group. In the event of any discrepancy between this version and the -original IEEE and The Open Group Standard, the original IEEE and The -Open Group Standard is the referee document. The original Standard -can be obtained online at <A HREF="http://www.opengroup.org/unix/online.html">http://www.opengroup.org/unix/online.html</A> -. -</P> -<P>Modified by Ross Johnson for use with <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A>.</P> -<HR> -<P><A NAME="toc"></A><B>Table of Contents</B></P> -<UL> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect0" NAME="toc0">Name</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect1" NAME="toc1">Synopsis</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect2" NAME="toc2">Description</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect3" NAME="toc3">Return - Value</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect4" NAME="toc4">Errors</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect5" NAME="toc5">Examples</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect6" NAME="toc6">Application - Usage</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect7" NAME="toc7">Rationale</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect8" NAME="toc8">Future - Directions</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect11" NAME="toc11">Known - Bugs</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect9" NAME="toc9">See - Also</A> - </P> - <LI><P><A HREF="#sect10" NAME="toc10">Copyright</A> - </P> -</UL> -</BODY> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
+ <TITLE>"PTHREAD_BARRIER_DESTROY"(P) manual page</TITLE>
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0 (Linux)">
+ <META NAME="CREATED" CONTENT="20050504;11372800">
+ <META NAME="CHANGEDBY" CONTENT="Ross Johnson">
+ <META NAME="CHANGED" CONTENT="20060408;9450100">
+ <!-- manual page source format generated by PolyglotMan v3.2, -->
+ <!-- available at http://polyglotman.sourceforge.net/ -->
+</HEAD>
+<BODY LANG="en-GB" BGCOLOR="#ffffff" DIR="LTR">
+<H4>POSIX Threads for Windows – REFERENCE - <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A></H4>
+<P><A HREF="index.html">Reference Index</A></P>
+<P><A HREF="#toc">Table of Contents</A></P>
+<H2><A HREF="#toc0" NAME="sect0">Name</A></H2>
+<P>pthread_barrier_destroy, pthread_barrier_init - destroy and
+initialize a barrier object (<B>ADVANCED REALTIME THREADS</B>)
+</P>
+<H2><A HREF="#toc1" NAME="sect1">Synopsis</A></H2>
+<P><B>#include <pthread.h> </B>
+</P>
+<P><B>int pthread_barrier_destroy(pthread_barrier_t *</B><I>barrier</I><B>);
+<BR>int pthread_barrier_init(pthread_barrier_t *restrict</B> <I>barrier</I><B>,
+const pthread_barrierattr_t *restrict</B> <I>attr</I><B>, unsigned</B>
+<I>count</I><B>); </B>
+</P>
+<H2><A HREF="#toc2" NAME="sect2">Description</A></H2>
+<P>The <B>pthread_barrier_destroy</B> function shall destroy the
+barrier referenced by <I>barrier</I> and release any resources used
+by the barrier. The effect of subsequent use of the barrier is
+undefined until the barrier is reinitialized by another call to
+<B>pthread_barrier_init</B> . An implementation may use this function
+to set <I>barrier</I> to an invalid value. An error code is returned if <B>pthread_barrier_destroy</B> is called when any thread is
+blocked on the barrier, or if this function is called with an
+uninitialized barrier.
+</P>
+<P>The <B>pthread_barrier_init</B> function shall allocate any
+resources required to use the barrier referenced by <I>barrier</I>
+and shall initialize the barrier with attributes referenced by <I>attr</I>.
+If <I>attr</I> is NULL, the default barrier attributes shall be used;
+the effect is the same as passing the address of a default barrier
+attributes object. The results are undefined if <B>pthread_barrier_init</B>
+is called when any thread is blocked on the barrier (that is, has not
+returned from the <A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A>
+call). The results are undefined if a barrier is used without first
+being initialized. The results are undefined if <B>pthread_barrier_init</B>
+is called specifying an already initialized barrier.
+</P>
+<P>The <I>count</I> argument specifies the number of threads that
+must call <A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A>
+before any of them successfully return from the call. The value
+specified by <I>count</I> must be greater than zero.
+</P>
+<P>If the <B>pthread_barrier_init</B> function fails, the barrier
+shall not be initialized and the contents of <I>barrier</I> are
+undefined.
+</P>
+<P>Only the object referenced by <I>barrier</I> may be used for
+performing synchronization. The result of referring to copies of that
+object in calls to <B>pthread_barrier_destroy</B> <B>or</B>
+<A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A>
+is undefined.</P>
+<H2><A HREF="#toc3" NAME="sect3">Return Value</A></H2>
+<P>Upon successful completion, these functions shall return zero;
+otherwise, an error number shall be returned to indicate the error.
+</P>
+<H2><A HREF="#toc4" NAME="sect4">Errors</A></H2>
+<P>The <B>pthread_barrier_destroy</B> function may fail if:
+</P>
+<DL>
+ <DT><B>EBUSY</B>
+ </DT><DD>
+ The implementation has detected an attempt to destroy a barrier
+ while it is in use (for example, while being used in a
+ <A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A>
+ call) by another thread.
+ </DD><DT>
+ <B>EINVAL</B>
+ </DT><DD STYLE="margin-bottom: 0.5cm">
+ The value specified by <I>barrier</I> is invalid.
+ </DD></DL>
+<P>
+The <B>pthread_barrier_init</B> function shall fail if:
+</P>
+<DL>
+ <DT><B>EAGAIN</B>
+ </DT><DD>
+ The system lacks the necessary resources to initialize another
+ barrier.
+ </DD><DT>
+ <B>EINVAL</B>
+ </DT><DD>
+ The value specified by <I>count</I> is equal to zero.
+ </DD><DT>
+ <B>ENOMEM</B>
+ </DT><DD STYLE="margin-bottom: 0.5cm">
+ Insufficient memory exists to initialize the barrier.
+ </DD></DL>
+<P>
+The <B>pthread_barrier_init</B> function may fail if:
+</P>
+<DL>
+ <DT><B>EBUSY</B>
+ </DT><DD>
+ The implementation has detected an attempt to reinitialize a barrier
+ while it is in use (for example, while being used in a
+ <A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A>
+ call) by another thread.
+ </DD><DT>
+ <B>EINVAL</B>
+ </DT><DD STYLE="margin-bottom: 0.5cm">
+ The value specified by <I>attr</I> is invalid.
+ </DD></DL>
+<P>
+These functions shall not return an error code of [EINTR].
+</P>
+<P><I>The following sections are informative.</I>
+</P>
+<H2><A HREF="#toc5" NAME="sect5">Examples</A></H2>
+<P>None.
+</P>
+<H2><A HREF="#toc6" NAME="sect6">Application Usage</A></H2>
+<P>The <B>pthread_barrier_destroy</B> and <B>pthread_barrier_init</B>
+functions are part of the Barriers option and need not be provided on
+all implementations.
+</P>
+<P><B>Pthreads-w32</B> defines <B>_POSIX_BARRIERS</B> to indicate
+that these routines are implemented and may be used.</P>
+<H2><A HREF="#toc7" NAME="sect7">Rationale</A></H2>
+<P>None.
+</P>
+<H2><A HREF="#toc8" NAME="sect8">Future Directions</A></H2>
+<P>None.
+</P>
+<H2><A HREF="#toc11" NAME="sect11">Known Bugs</A></H2>
+<DL>
+ <DD STYLE="margin-left: 0cm; margin-bottom: 0.5cm">In
+ <B><SPAN LANG="en-GB"><SPAN LANG="en-GB">pthreads-win32</SPAN></SPAN></B>,
+ the behaviour of threads which enter <A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A>
+ while the barrier is being destroyed is undefined.
+ </DD></DL>
+<H2>
+<A HREF="#toc9" NAME="sect9">See Also</A></H2>
+<P><A HREF="pthread_barrier_wait.html"><B>pthread_barrier_wait</B>(3)</A>
+<B>,</B> the Base Definitions volume of IEEE Std 1003.1-2001,
+<I><pthread.h></I>
+</P>
+<H2><A HREF="#toc10" NAME="sect10">Copyright</A></H2>
+<P>Portions of this text are reprinted and reproduced in electronic
+form from IEEE Std 1003.1, 2003 Edition, Standard for Information
+Technology -- Portable Operating System Interface (POSIX), The Open
+Group Base Specifications Issue 6, Copyright (C) 2001-2003 by the
+Institute of Electrical and Electronics Engineers, Inc and The Open
+Group. In the event of any discrepancy between this version and the
+original IEEE and The Open Group Standard, the original IEEE and The
+Open Group Standard is the referee document. The original Standard
+can be obtained online at <A HREF="http://www.opengroup.org/unix/online.html">http://www.opengroup.org/unix/online.html</A>
+.
+</P>
+<P>Modified by Ross Johnson for use with <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A>.</P>
+<HR>
+<P><A NAME="toc"></A><B>Table of Contents</B></P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect0" NAME="toc0">Name</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect1" NAME="toc1">Synopsis</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect2" NAME="toc2">Description</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect3" NAME="toc3">Return
+ Value</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect4" NAME="toc4">Errors</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect5" NAME="toc5">Examples</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect6" NAME="toc6">Application
+ Usage</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect7" NAME="toc7">Rationale</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect8" NAME="toc8">Future
+ Directions</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect11" NAME="toc11">Known
+ Bugs</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect9" NAME="toc9">See
+ Also</A>
+ </P>
+ <LI><P><A HREF="#sect10" NAME="toc10">Copyright</A>
+ </P>
+</UL>
+</BODY>
</HTML>
\ No newline at end of file diff --git a/pthreads/manual/pthread_barrier_wait.html b/pthreads/manual/pthread_barrier_wait.html index 693d8bd15..e8eb2d16c 100644 --- a/pthreads/manual/pthread_barrier_wait.html +++ b/pthreads/manual/pthread_barrier_wait.html @@ -1,167 +1,161 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> -<HTML> -<HEAD> - <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8"> - <TITLE>"PTHREAD_BARRIER_WAIT"(P) manual page</TITLE> - <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0 (Linux)"> - <META NAME="CREATED" CONTENT="20050504;11484200"> - <META NAME="CHANGEDBY" CONTENT="Ross Johnson"> - <META NAME="CHANGED" CONTENT="20060408;9504600"> - <!-- manual page source format generated by PolyglotMan v3.2, --> - <!-- available at http://polyglotman.sourceforge.net/ --> -</HEAD> -<BODY LANG="en-GB" BGCOLOR="#ffffff" DIR="LTR"> -<H4>POSIX Threads for Windows – REFERENCE - <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A></H4> -<P><A HREF="index.html">Reference Index</A></P> -<P><A HREF="#toc">Table of Contents</A></P> -<H2><A HREF="#toc0" NAME="sect0">Name</A></H2> -<P>pthread_barrier_wait - synchronize at a barrier (<B>ADVANCED -REALTIME THREADS</B>) -</P> -<H2><A HREF="#toc1" NAME="sect1">Synopsis</A></H2> -<P><B>#include <pthread.h> </B> -</P> -<P><B>int pthread_barrier_wait(pthread_barrier_t *</B><I>barrier</I><B>); -</B> -</P> -<H2><A HREF="#toc2" NAME="sect2">Description</A></H2> -<P>The <B>pthread_barrier_wait</B> function shall synchronize -participating threads at the barrier referenced by <I>barrier</I>. -The calling thread shall block until the required number of threads -have called <B>pthread_barrier_wait</B> specifying the barrier. -</P> -<P>When the required number of threads have called -<B>pthread_barrier_wait</B> specifying the barrier, the constant -<B>PTHREAD_BARRIER_SERIAL_THREAD</B> shall be returned to one -unspecified thread and zero shall be returned to each of the -remaining threads. At this point, the barrier shall be reset to the -state it had as a result of the most recent <A HREF="pthread_barrier_init.html"><B>pthread_barrier_init</B>(3)</A> -function that referenced it. -</P> -<P>The constant <B>PTHREAD_BARRIER_SERIAL_THREAD</B> is defined in -<I><pthread.h></I> and its value shall be distinct from any -other value returned by <B>pthread_barrier_wait</B> . -</P> -<P>The results are undefined if this function is called with an -uninitialized barrier. -</P> -<P>If a signal is delivered to a thread blocked on a barrier, upon -return from the signal handler the thread shall resume waiting at the -barrier if the barrier wait has not completed (that is, if the -required number of threads have not arrived at the barrier during the -execution of the signal handler); otherwise, the thread shall -continue as normal from the completed barrier wait. Until the thread -in the signal handler returns from it, it is unspecified whether -other threads may proceed past the barrier once they have all reached -it. -</P> -<P>A thread that has blocked on a barrier shall not prevent any -unblocked thread that is eligible to use the same processing -resources from eventually making forward progress in its execution. -Eligibility for processing resources shall be determined by the -scheduling policy. -</P> -<H2><A HREF="#toc3" NAME="sect3">Return Value</A></H2> -<P>Upon successful completion, the <B>pthread_barrier_wait</B> -function shall return <B>PTHREAD_BARRIER_SERIAL_THREAD</B> for a -single (arbitrary) thread synchronized at the barrier and zero for -each of the other threads. Otherwise, an error number shall be -returned to indicate the error. -</P> -<H2><A HREF="#toc4" NAME="sect4">Errors</A></H2> -<P>The <B>pthread_barrier_wait</B> function may fail if: -</P> -<DL> - <DT><B>EINVAL</B> - </DT><DD STYLE="margin-bottom: 0.5cm"> - The value specified by <I>barrier</I> does not refer to an - initialized barrier object. - </DD></DL> -<P> -This function shall not return an error code of [EINTR]. -</P> -<P><I>The following sections are informative.</I> -</P> -<H2><A HREF="#toc5" NAME="sect5">Examples</A></H2> -<P>None. -</P> -<H2><A HREF="#toc6" NAME="sect6">Application Usage</A></H2> -<P>Applications using this function may be subject to priority -inversion, as discussed in the Base Definitions volume of -IEEE Std 1003.1-2001, Section 3.285, Priority Inversion. -</P> -<P>The <B>pthread_barrier_wait</B> function is part of the Barriers -option and need not be provided on all implementations. -</P> -<P><B>Pthreads-w32</B> defines <B>_POSIX_BARRIERS</B> to indicate -that this routine is implemented and may be used.</P> -<H2><A HREF="#toc7" NAME="sect7">Rationale</A></H2> -<P>None. -</P> -<H2><A HREF="#toc8" NAME="sect8">Future Directions</A></H2> -<P>None. -</P> -<H2><A HREF="#toc11" NAME="sect11">Known Bugs</A></H2> -<DL> - <DD STYLE="margin-left: 0cm; margin-bottom: 0.5cm">In - <B><SPAN LANG="en-GB">pthreads-win32</SPAN></B>, - <B>pthread_barrier_wait</B> may deadlock if the number of running - threads able to wait on the barrier object exceeds the value given - as the <I><SPAN LANG="en-GB">count</SPAN></I> parameter in - <A HREF="pthread_barrier_init.html"><B>pthread_barrier_init(3)</B></A>. - </DD></DL> -<H2> -<A HREF="#toc9" NAME="sect9">See Also</A></H2> -<P><A HREF="pthread_barrier_init.html"><B>pthread_barrier_destroy</B>(3)</A>, -<A HREF="pthread_barrier_init.html"><B>pthread_barrier_init(3)</B></A>, -the Base Definitions volume of IEEE Std 1003.1-2001, -<I><pthread.h></I> -</P> -<H2><A HREF="#toc10" NAME="sect10">Copyright</A></H2> -<P>Portions of this text are reprinted and reproduced in electronic -form from IEEE Std 1003.1, 2003 Edition, Standard for Information -Technology -- Portable Operating System Interface (POSIX), The Open -Group Base Specifications Issue 6, Copyright (C) 2001-2003 by the -Institute of Electrical and Electronics Engineers, Inc and The Open -Group. In the event of any discrepancy between this version and the -original IEEE and The Open Group Standard, the original IEEE and The -Open Group Standard is the referee document. The original Standard -can be obtained online at <A HREF="http://www.opengroup.org/unix/online.html">http://www.opengroup.org/unix/online.html</A> -. -</P> -<P>Modified by Ross Johnson for use with <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A>.</P> -<HR> -<P><A NAME="toc"></A><B>Table of Contents</B></P> -<UL> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect0" NAME="toc0">Name</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect1" NAME="toc1">Synopsis</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect2" NAME="toc2">Description</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect3" NAME="toc3">Return - Value</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect4" NAME="toc4">Errors</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect5" NAME="toc5">Examples</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect6" NAME="toc6">Application - Usage</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect7" NAME="toc7">Rationale</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect8" NAME="toc8">Future - Directions</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect11" NAME="toc11">Known - Bugs</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect9" NAME="toc9">See - Also</A> - </P> - <LI><P><A HREF="#sect10" NAME="toc10">Copyright</A> - </P> -</UL> -</BODY> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
+ <TITLE>"PTHREAD_BARRIER_WAIT"(P) manual page</TITLE>
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0 (Linux)">
+ <META NAME="CREATED" CONTENT="20050504;11484200">
+ <META NAME="CHANGEDBY" CONTENT="Ross Johnson">
+ <META NAME="CHANGED" CONTENT="20060408;9504600">
+ <!-- manual page source format generated by PolyglotMan v3.2, -->
+ <!-- available at http://polyglotman.sourceforge.net/ -->
+</HEAD>
+<BODY LANG="en-GB" BGCOLOR="#ffffff" DIR="LTR">
+<H4>POSIX Threads for Windows – REFERENCE - <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A></H4>
+<P><A HREF="index.html">Reference Index</A></P>
+<P><A HREF="#toc">Table of Contents</A></P>
+<H2><A HREF="#toc0" NAME="sect0">Name</A></H2>
+<P>pthread_barrier_wait - synchronize at a barrier (<B>ADVANCED
+REALTIME THREADS</B>)
+</P>
+<H2><A HREF="#toc1" NAME="sect1">Synopsis</A></H2>
+<P><B>#include <pthread.h> </B>
+</P>
+<P><B>int pthread_barrier_wait(pthread_barrier_t *</B><I>barrier</I><B>);
+</B>
+</P>
+<H2><A HREF="#toc2" NAME="sect2">Description</A></H2>
+<P>The <B>pthread_barrier_wait</B> function shall synchronize
+participating threads at the barrier referenced by <I>barrier</I>.
+The calling thread shall block until the required number of threads
+have called <B>pthread_barrier_wait</B> specifying the barrier.
+</P>
+<P>When the required number of threads have called
+<B>pthread_barrier_wait</B> specifying the barrier, the constant
+<B>PTHREAD_BARRIER_SERIAL_THREAD</B> shall be returned to one
+unspecified thread and zero shall be returned to each of the
+remaining threads. At this point, the barrier shall be reset to the
+state it had as a result of the most recent <A HREF="pthread_barrier_init.html"><B>pthread_barrier_init</B>(3)</A>
+function that referenced it.
+</P>
+<P>The constant <B>PTHREAD_BARRIER_SERIAL_THREAD</B> is defined in
+<I><pthread.h></I> and its value shall be distinct from any
+other value returned by <B>pthread_barrier_wait</B> .
+</P>
+<P>The results are undefined if this function is called with an
+uninitialized barrier.
+</P>
+<P>If a signal is delivered to a thread blocked on a barrier, upon
+return from the signal handler the thread shall resume waiting at the
+barrier if the barrier wait has not completed (that is, if the
+required number of threads have not arrived at the barrier during the
+execution of the signal handler); otherwise, the thread shall
+continue as normal from the completed barrier wait. Until the thread
+in the signal handler returns from it, it is unspecified whether
+other threads may proceed past the barrier once they have all reached
+it.
+</P>
+<P>A thread that has blocked on a barrier shall not prevent any
+unblocked thread that is eligible to use the same processing
+resources from eventually making forward progress in its execution.
+Eligibility for processing resources shall be determined by the
+scheduling policy.
+</P>
+<H2><A HREF="#toc3" NAME="sect3">Return Value</A></H2>
+<P>Upon successful completion, the <B>pthread_barrier_wait</B>
+function shall return <B>PTHREAD_BARRIER_SERIAL_THREAD</B> for a
+single (arbitrary) thread synchronized at the barrier and zero for
+each of the other threads. Otherwise, an error number shall be
+returned to indicate the error.
+</P>
+<H2><A HREF="#toc4" NAME="sect4">Errors</A></H2>
+<P>The <B>pthread_barrier_wait</B> function may fail if:
+</P>
+<DL>
+ <DT><B>EINVAL</B>
+ </DT><DD STYLE="margin-bottom: 0.5cm">
+ The value specified by <I>barrier</I> does not refer to an
+ initialized barrier object.
+ </DD></DL>
+<P>
+This function shall not return an error code of [EINTR].
+</P>
+<P><I>The following sections are informative.</I>
+</P>
+<H2><A HREF="#toc5" NAME="sect5">Examples</A></H2>
+<P>None.
+</P>
+<H2><A HREF="#toc6" NAME="sect6">Application Usage</A></H2>
+<P>Applications using this function may be subject to priority
+inversion, as discussed in the Base Definitions volume of
+IEEE Std 1003.1-2001, Section 3.285, Priority Inversion.
+</P>
+<P>The <B>pthread_barrier_wait</B> function is part of the Barriers
+option and need not be provided on all implementations.
+</P>
+<P><B>Pthreads-w32</B> defines <B>_POSIX_BARRIERS</B> to indicate
+that this routine is implemented and may be used.</P>
+<H2><A HREF="#toc7" NAME="sect7">Rationale</A></H2>
+<P>None.
+</P>
+<H2><A HREF="#toc8" NAME="sect8">Future Directions</A></H2>
+<P>None.
+</P>
+<H2><A HREF="#toc11" NAME="sect11">Known Bugs</A></H2>
+<DL>
+ None.</DL>
+<H2>
+<A HREF="#toc9" NAME="sect9">See Also</A></H2>
+<P><A HREF="pthread_barrier_init.html"><B>pthread_barrier_destroy</B>(3)</A>,
+<A HREF="pthread_barrier_init.html"><B>pthread_barrier_init(3)</B></A>,
+the Base Definitions volume of IEEE Std 1003.1-2001,
+<I><pthread.h></I>
+</P>
+<H2><A HREF="#toc10" NAME="sect10">Copyright</A></H2>
+<P>Portions of this text are reprinted and reproduced in electronic
+form from IEEE Std 1003.1, 2003 Edition, Standard for Information
+Technology -- Portable Operating System Interface (POSIX), The Open
+Group Base Specifications Issue 6, Copyright (C) 2001-2003 by the
+Institute of Electrical and Electronics Engineers, Inc and The Open
+Group. In the event of any discrepancy between this version and the
+original IEEE and The Open Group Standard, the original IEEE and The
+Open Group Standard is the referee document. The original Standard
+can be obtained online at <A HREF="http://www.opengroup.org/unix/online.html">http://www.opengroup.org/unix/online.html</A>
+.
+</P>
+<P>Modified by Ross Johnson for use with <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A>.</P>
+<HR>
+<P><A NAME="toc"></A><B>Table of Contents</B></P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect0" NAME="toc0">Name</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect1" NAME="toc1">Synopsis</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect2" NAME="toc2">Description</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect3" NAME="toc3">Return
+ Value</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect4" NAME="toc4">Errors</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect5" NAME="toc5">Examples</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect6" NAME="toc6">Application
+ Usage</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect7" NAME="toc7">Rationale</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect8" NAME="toc8">Future
+ Directions</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect11" NAME="toc11">Known
+ Bugs</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect9" NAME="toc9">See
+ Also</A>
+ </P>
+ <LI><P><A HREF="#sect10" NAME="toc10">Copyright</A>
+ </P>
+</UL>
+</BODY>
</HTML>
\ No newline at end of file diff --git a/pthreads/manual/pthread_setschedparam.html b/pthreads/manual/pthread_setschedparam.html index 920c20bab..35fd7a268 100644 --- a/pthreads/manual/pthread_setschedparam.html +++ b/pthreads/manual/pthread_setschedparam.html @@ -1,113 +1,114 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> -<HTML> -<HEAD> - <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8"> - <TITLE>PTHREAD_SETSCHEDPARAM(3) manual page</TITLE> - <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.3 (Linux)"> - <META NAME="CREATED" CONTENT="20050504;18110100"> - <META NAME="CHANGED" CONTENT="20050614;14012300"> - <!-- manual page source format generated by PolyglotMan v3.2, --> - <!-- available at http://polyglotman.sourceforge.net/ --> -</HEAD> -<BODY LANG="en-GB" BGCOLOR="#ffffff" DIR="LTR"> -<H4>POSIX Threads for Windows – REFERENCE - <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A></H4> -<P><A HREF="index.html">Reference Index</A></P> -<P><A HREF="#toc">Table of Contents</A></P> -<H2><A HREF="#toc0" NAME="sect0">Name</A></H2> -<P>pthread_setschedparam, pthread_getschedparam - control thread -scheduling -</P> -<P>parameters -</P> -<H2><A HREF="#toc1" NAME="sect1">Synopsis</A></H2> -<P><B>#include <pthread.h></B> -</P> -<P><B>int pthread_setschedparam(pthread_t </B><I>target_thread</I><B>, -int </B><I>policy</I><B>, const struct sched_param *</B><I>param</I><B>);</B> -</P> -<P><B>int pthread_getschedparam(pthread_t </B><I>target_thread</I><B>, -int *</B><I>policy</I><B>, struct sched_param *</B><I>param</I><B>);</B> -</P> -<H2><A HREF="#toc2" NAME="sect2">Description</A></H2> -<P><B>pthread_setschedparam</B> sets the scheduling parameters for -the thread <I>target_thread</I> as indicated by <I>policy</I> and -<I>param</I>. <I>policy</I> can be either <B>SCHED_OTHER</B> -(regular, non-real-time scheduling), <B>SCHED_RR</B> (real-time, -round-robin) or <B>SCHED_FIFO</B> (real-time, first-in first-out). -<I>param</I> specifies the scheduling priority for the two real-time -policies.</P> -<P><B>Pthreads-w32</B> only supports SCHED_OTHER and does not support -the real-time scheduling policies <B>SCHED_RR</B> and <B>SCHED_FIFO.</B> -</P> -<P><B>pthread_getschedparam</B> retrieves the scheduling policy and -scheduling parameters for the thread <I>target_thread</I> and stores -them in the locations pointed to by <I>policy</I> and <I>param</I>, -respectively. -</P> -<H2><A HREF="#toc3" NAME="sect3">Return Value</A></H2> -<P><B>pthread_setschedparam</B> and <B>pthread_getschedparam</B> -return 0 on success and a non-zero error code on error. -</P> -<H2><A HREF="#toc4" NAME="sect4">Errors</A></H2> -<P>On error, <B>pthread_setschedparam</B> returns the following error -codes: -</P> -<DL> - <DL> - <DT STYLE="margin-right: 1cm; margin-bottom: 0.5cm"><B>ENOTSUP</B> - </DT><DD STYLE="margin-right: 1cm; margin-bottom: 0.5cm"> - <I>policy</I> is not <B>SCHED_OTHER.</B></DD><DT STYLE="margin-right: 1cm; margin-bottom: 0.5cm"> - <B>EINVAL</B> - </DT><DD STYLE="margin-right: 1cm; margin-bottom: 0.5cm"> - One of the arguments is invalid, or the priority value specified by - <I>param</I> is not valid for the specified policy.</DD><DT STYLE="margin-right: 1cm; margin-bottom: 0.5cm"> - <B>ESRCH</B> - </DT><DD STYLE="margin-right: 1cm; margin-bottom: 0.5cm"> - The <I>target_thread</I> is invalid or has already terminated - </DD></DL> -</DL> -<P> -On error, <B>pthread_getschedparam</B> returns the following error -codes: -</P> -<DL> - <DL> - <DT STYLE="margin-right: 1cm; margin-bottom: 0.5cm"><B>ESRCH</B> - </DT><DD STYLE="margin-right: 1cm; margin-bottom: 0.5cm"> - the <I>target_thread</I> is invalid or has already terminated - </DD></DL> -</DL> -<H2> -<A HREF="#toc5" NAME="sect5">Author</A></H2> -<P>Xavier Leroy <Xavier.Leroy@inria.fr> -</P> -<P>Modified by Ross Johnson for use with <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A>.</P> -<H2><A HREF="#toc6" NAME="sect6">See Also</A></H2> -<P><A HREF="sched_setscheduler.html"><B>sched_setscheduler</B>(2)</A> -, <A HREF="sched_getscheduler.html"><B>sched_getscheduler</B>(2)</A> -, <A HREF="sched_getparam.html"><B>sched_getparam</B>(2)</A> , -<A HREF="pthread_attr_setschedpolicy.html"><B>pthread_attr_setschedpolicy</B>(3)</A> -, <A HREF="pthread_attr_setschedparam.html"><B>pthread_attr_setschedparam</B>(3)</A> -. -</P> -<HR> -<P><A NAME="toc"></A><B>Table of Contents</B></P> -<UL> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect0" NAME="toc0">Name</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect1" NAME="toc1">Synopsis</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect2" NAME="toc2">Description</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect3" NAME="toc3">Return - Value</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect4" NAME="toc4">Errors</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect5" NAME="toc5">Author</A> - </P> - <LI><P><A HREF="#sect6" NAME="toc6">See Also</A> - </P> -</UL> -</BODY> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
+ <TITLE>PTHREAD_SETSCHEDPARAM(3) manual page</TITLE>
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.4 (Linux)">
+ <META NAME="CREATED" CONTENT="20050504;18110100">
+ <META NAME="CHANGEDBY" CONTENT="Ross Johnson">
+ <META NAME="CHANGED" CONTENT="20080630;22330400">
+ <!-- manual page source format generated by PolyglotMan v3.2, -->
+ <!-- available at http://polyglotman.sourceforge.net/ -->
+</HEAD>
+<BODY LANG="en-GB" BGCOLOR="#ffffff" DIR="LTR">
+<H4>POSIX Threads for Windows – REFERENCE - <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A></H4>
+<P><A HREF="index.html">Reference Index</A></P>
+<P><A HREF="#toc">Table of Contents</A></P>
+<H2><A HREF="#toc0" NAME="sect0">Name</A></H2>
+<P>pthread_setschedparam, pthread_getschedparam - control thread
+scheduling
+</P>
+<P>parameters
+</P>
+<H2><A HREF="#toc1" NAME="sect1">Synopsis</A></H2>
+<P><B>#include <pthread.h></B>
+</P>
+<P><B>int pthread_setschedparam(pthread_t </B><I>target_thread</I><B>,
+int </B><I>policy</I><B>, const struct sched_param *</B><I>param</I><B>);</B>
+</P>
+<P><B>int pthread_getschedparam(pthread_t </B><I>target_thread</I><B>,
+int *</B><I>policy</I><B>, struct sched_param *</B><I>param</I><B>);</B>
+</P>
+<H2><A HREF="#toc2" NAME="sect2">Description</A></H2>
+<P><B>pthread_setschedparam</B> sets the scheduling parameters for
+the thread <I>target_thread</I> as indicated by <I>policy</I> and
+<I>param</I>. <I>policy</I> can be either <B>SCHED_OTHER</B>
+(regular, non-real-time scheduling), <B>SCHED_RR</B> (real-time,
+round-robin) or <B>SCHED_FIFO</B> (real-time, first-in first-out).
+<I>param</I> specifies the scheduling priority for the two real-time
+policies.</P>
+<P><B>Pthreads-w32</B> only supports SCHED_OTHER and does not support
+the real-time scheduling policies <B>SCHED_RR</B> and <B>SCHED_FIFO.</B>
+</P>
+<P><B>pthread_getschedparam</B> retrieves the scheduling policy and
+scheduling parameters for the thread <I>target_thread</I> and stores
+them in the locations pointed to by <I>policy</I> and <I>param</I>,
+respectively.
+</P>
+<H2><A HREF="#toc3" NAME="sect3">Return Value</A></H2>
+<P><B>pthread_setschedparam</B> and <B>pthread_getschedparam</B>
+return 0 on success and a non-zero error code on error.
+</P>
+<H2><A HREF="#toc4" NAME="sect4">Errors</A></H2>
+<P>On error, <B>pthread_setschedparam</B> returns the following error
+codes:
+</P>
+<DL>
+ <DL>
+ <DT STYLE="margin-right: 1cm; margin-bottom: 0.5cm"><B>ENOTSUP</B>
+ </DT><DD STYLE="margin-right: 1cm; margin-bottom: 0.5cm">
+ <I>policy</I> is not <B>SCHED_OTHER.</B></DD><DT STYLE="margin-right: 1cm; margin-bottom: 0.5cm">
+ <B>EINVAL</B>
+ </DT><DD STYLE="margin-right: 1cm; margin-bottom: 0.5cm">
+ One of the arguments is invalid, or the priority value specified by
+ <I>param</I> is not valid for the specified policy.</DD><DT STYLE="margin-right: 1cm; margin-bottom: 0.5cm">
+ <B>ESRCH</B>
+ </DT><DD STYLE="margin-right: 1cm; margin-bottom: 0.5cm">
+ The <I>target_thread</I> is invalid or has already terminated
+ </DD></DL>
+</DL>
+<P>
+On error, <B>pthread_getschedparam</B> returns the following error
+codes:
+</P>
+<DL>
+ <DL>
+ <DT STYLE="margin-right: 1cm; margin-bottom: 0.5cm"><B>ESRCH</B>
+ </DT><DD STYLE="margin-right: 1cm; margin-bottom: 0.5cm">
+ the <I>target_thread</I> is invalid or has already terminated
+ </DD></DL>
+</DL>
+<H2>
+<A HREF="#toc5" NAME="sect5">Author</A></H2>
+<P>Xavier Leroy <Xavier.Leroy@inria.fr>
+</P>
+<P>Modified by Ross Johnson for use with <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A>.</P>
+<H2><A HREF="#toc6" NAME="sect6">See Also</A></H2>
+<P><A HREF="sched_setscheduler.html"><B>sched_setscheduler</B>(2)</A>
+, <A HREF="sched_getscheduler.html"><B>sched_getscheduler</B>(2)</A>
+, <A HREF="sched_getparam.html"><B>sched_getparam</B>(2)</A> ,
+<A HREF="pthread_attr_init.html"><B>pthread_attr_setschedpolicy</B>(3)</A>
+, <A HREF="pthread_attr_init.html"><B>pthread_attr_setschedparam</B>(3)</A>
+.
+</P>
+<HR>
+<P><A NAME="toc"></A><B>Table of Contents</B></P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect0" NAME="toc0">Name</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect1" NAME="toc1">Synopsis</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect2" NAME="toc2">Description</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect3" NAME="toc3">Return
+ Value</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect4" NAME="toc4">Errors</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect5" NAME="toc5">Author</A>
+ </P>
+ <LI><P><A HREF="#sect6" NAME="toc6">See Also</A>
+ </P>
+</UL>
+</BODY>
</HTML>
\ No newline at end of file diff --git a/pthreads/manual/pthread_win32_attach_detach_np.html b/pthreads/manual/pthread_win32_attach_detach_np.html index 57f0339a6..583468e2a 100644 --- a/pthreads/manual/pthread_win32_attach_detach_np.html +++ b/pthreads/manual/pthread_win32_attach_detach_np.html @@ -1,74 +1,74 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> -<HTML> -<HEAD> - <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8"> - <TITLE>PTHREAD_WIN32_ATTACH_DETACH_NP manual page</TITLE> - <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.3 (Linux)"> - <META NAME="CREATED" CONTENT="20050505;322600"> - <META NAME="CHANGED" CONTENT="20050505;22415600"> - <!-- manual page source format generated by PolyglotMan v3.2, --> - <!-- available at http://polyglotman.sourceforge.net/ --> -</HEAD> -<BODY LANG="en-GB" BGCOLOR="#ffffff" DIR="LTR"> -<H4>POSIX Threads for Windows – REFERENCE - <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A></H4> -<P><A HREF="index.html">Reference Index</A></P> -<P><A HREF="#toc">Table of Contents</A></P> -<H2><A HREF="#toc0" NAME="sect0">Name</A></H2> -<P STYLE="font-weight: medium">pthread_win32_process_attach_np, -pthread_win32_process_detach_np, pthread_win32_thread_attach_np, -pthread_win32_thread_detach_np – exposed versions of the -pthreads-w32 DLL dllMain() switch functionality for use when -statically linking the library.</P> -<H2><A HREF="#toc1" NAME="sect1">Synopsis</A></H2> -<P><B>#include <pthread.h></B> -</P> -<P><B>BOOL pthread_win32_process_attach_np (void);</B></P> -<P><B>BOOL pthread_win32_process_detach_np (void);</B></P> -<P><B>BOOL pthread_win32_thread_attach_np (void);</B></P> -<P><B>BOOL pthread_win32_thread_detach_np (void);</B></P> -<H2><A HREF="#toc2" NAME="sect2">Description</A></H2> -<P>These functions contain the code normally run via <B>dllMain</B> -when the library is used as a dll but which need to be called -explicitly by an application when the library is statically linked.</P> -<P>You will need to call <B>pthread_win32_process_attach_np</B> -before you can call any pthread routines when statically linking. You -should call <B>pthread_win32_process_detach_np</B> before exiting -your application to clean up.</P> -<P><B>pthread_win32_thread_attach_np</B> is currently a no-op, but -<B>pthread_win32_thread_detach_np</B> is needed to clean up the -implicit pthread handle that is allocated to a Win32 thread if it -calls certain pthreads routines. Call this routine when the Win32 -thread exits.</P> -<P>These functions invariably return TRUE except for -<B>pthread_win32_process_attach_np</B> which will return FALSE if -pthreads-w32 initialisation fails.</P> -<H2><A HREF="#toc3" NAME="sect3">Cancellation</A></H2> -<P>None.</P> -<H2><A HREF="#toc4" NAME="sect4"><FONT COLOR="#000080">Return Value</FONT></A></H2> -<P>These routines return TRUE (non-zero) on success, or FALSE (0) if -they fail.</P> -<H2><A HREF="#toc5" NAME="sect5">Errors</A></H2> -<P>None.</P> -<H2><A HREF="#toc6" NAME="sect6">Author</A></H2> -<P>Ross Johnson for use with <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A>.</P> -<HR> -<P><A NAME="toc"></A><B>Table of Contents</B></P> -<UL> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect0" NAME="toc0">Name</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect1" NAME="toc1">Synopsis</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect2" NAME="toc2">Description</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect3" NAME="toc3">Cancellation</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect4" NAME="toc4">Return - Value</A> - </P> - <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect5" NAME="toc5">Errors</A> - </P> - <LI><P><A HREF="#sect6" NAME="toc6">Author</A> - </P> -</UL> -</BODY> -</HTML> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
+ <TITLE>PTHREAD_WIN32_ATTACH_DETACH_NP manual page</TITLE>
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.3 (Linux)">
+ <META NAME="CREATED" CONTENT="20050505;322600">
+ <META NAME="CHANGED" CONTENT="20050505;22415600">
+ <!-- manual page source format generated by PolyglotMan v3.2, -->
+ <!-- available at http://polyglotman.sourceforge.net/ -->
+</HEAD>
+<BODY LANG="en-GB" BGCOLOR="#ffffff" DIR="LTR">
+<H4>POSIX Threads for Windows – REFERENCE - <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A></H4>
+<P><A HREF="index.html">Reference Index</A></P>
+<P><A HREF="#toc">Table of Contents</A></P>
+<H2><A HREF="#toc0" NAME="sect0">Name</A></H2>
+<P STYLE="font-weight: medium">pthread_win32_process_attach_np,
+pthread_win32_process_detach_np, pthread_win32_thread_attach_np,
+pthread_win32_thread_detach_np – exposed versions of the
+pthreads-w32 DLL dllMain() switch functionality for use when
+statically linking the library.</P>
+<H2><A HREF="#toc1" NAME="sect1">Synopsis</A></H2>
+<P><B>#include <pthread.h></B>
+</P>
+<P><B>BOOL pthread_win32_process_attach_np (void);</B></P>
+<P><B>BOOL pthread_win32_process_detach_np (void);</B></P>
+<P><B>BOOL pthread_win32_thread_attach_np (void);</B></P>
+<P><B>BOOL pthread_win32_thread_detach_np (void);</B></P>
+<H2><A HREF="#toc2" NAME="sect2">Description</A></H2>
+<P>These functions contain the code normally run via <b>dllMain</b>
+when the library is used as a dll but which need to be called
+explicitly by an application when the library is statically linked. As of version 2.9.0, the static library built using either MSC or GCC includes RT hooks which will call the pthread_win32_process_*_np routines automatically on start/exit of the application.</P>
+<P>You will need to call <B>pthread_win32_process_attach_np</B>
+before you can call any pthread routines when statically linking. You
+should call <B>pthread_win32_process_detach_np</B> before exiting
+your application to clean up.</P>
+<P><B>pthread_win32_thread_attach_np</B> is currently a no-op, but
+<B>pthread_win32_thread_detach_np</B> is needed to clean up the
+implicit pthread handle that is allocated to a Win32 thread if it
+calls certain pthreads routines. Call this routine when the Win32
+thread exits.</P>
+<P>These functions invariably return TRUE except for
+<B>pthread_win32_process_attach_np</B> which will return FALSE if
+pthreads-w32 initialisation fails.</P>
+<H2><A HREF="#toc3" NAME="sect3">Cancellation</A></H2>
+<P>None.</P>
+<H2><A HREF="#toc4" NAME="sect4"><FONT COLOR="#000080">Return Value</FONT></A></H2>
+<P>These routines return TRUE (non-zero) on success, or FALSE (0) if
+they fail.</P>
+<H2><A HREF="#toc5" NAME="sect5">Errors</A></H2>
+<P>None.</P>
+<H2><A HREF="#toc6" NAME="sect6">Author</A></H2>
+<P>Ross Johnson for use with <A HREF="http://sources.redhat.com/pthreads-win32">Pthreads-w32</A>.</P>
+<HR>
+<P><A NAME="toc"></A><B>Table of Contents</B></P>
+<UL>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect0" NAME="toc0">Name</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect1" NAME="toc1">Synopsis</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect2" NAME="toc2">Description</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect3" NAME="toc3">Cancellation</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect4" NAME="toc4">Return
+ Value</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#sect5" NAME="toc5">Errors</A>
+ </P>
+ <LI><P><A HREF="#sect6" NAME="toc6">Author</A>
+ </P>
+</UL>
+</BODY>
+</HTML>
|