pthreadlib.html

来自「Vxworks API操作系统和驱动程序设计API。压缩的HTML文件」· HTML 代码 · 共 1,229 行 · 第 1/5 页

<tr valign=top>
<td align=left><b>pthread_condattr_getpshared</b> </td><td align=left> No </td><td align=left> 3</tr>
<tr valign=top>
<td align=left><b>pthread_condattr_init</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_condattr_setpshared</b> </td><td align=left> No </td><td align=left> 3</tr>
<tr valign=top>
<td align=left><b>pthread_cond_broadcast</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_cond_destroy</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_cond_init</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_cond_signal</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_cond_timedwait</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_cond_wait</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_create</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_detach</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_equal</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_exit</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_getschedparam</b> </td><td align=left> Yes </td><td align=left> 4</tr>
<tr valign=top>
<td align=left><b>pthread_getspecific</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_join</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_key_create</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_key_delete</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_kill</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_once</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_self</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_setcancelstate</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_setcanceltype</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_setschedparam</b> </td><td align=left> Yes </td><td align=left> 4</tr>
<tr valign=top>
<td align=left><b>pthread_setspecific</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_sigmask</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_testcancel</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutexattr_destroy</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutexattr_getprioceiling</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutexattr_getprotocol</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutexattr_getpshared</b> </td><td align=left> No </td><td align=left> 3</tr>
<tr valign=top>
<td align=left><b>pthread_mutexattr_init</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutexattr_setprioceiling</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutexattr_setprotocol</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutexattr_setpshared</b> </td><td align=left> No </td><td align=left> 3</tr>
<tr valign=top>
<td align=left><b>pthread_mutex_destroy</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutex_getprioceiling</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutex_init</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutex_lock</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutex_setprioceiling</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutex_trylock</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>pthread_mutex_unlock</b> </td><td align=left> Yes </td><td align=left></tr>
<tr valign=top>
<td align=left><b>getlogin_r</b> </td><td align=left> No </td><td align=left> 6</tr>
<tr valign=top>
<td align=left><b>getgrgid_r</b> </td><td align=left> No </td><td align=left> 6</tr>
<tr valign=top>
<td align=left><b>getpwnam_r</b> </td><td align=left> No </td><td align=left> 6</tr>
<tr valign=top>
<td align=left><b>getpwuid_r</b> </td><td align=left> No </td><td align=left> 6</tr>
<tr valign=top>
<td align=left></tr>
</tr>

</table>

</blockquote><h4>NOTES</h4><blockquote><p>
<table>
</tr>
<tr valign=top><td>
1
<td>The <b>pthread_atfork(&nbsp;)</b> function is not implemented since <b>fork(&nbsp;)</b> is not
implemented in VxWorks.
</tr>
<tr valign=top><td>
2
<td>The contention scope thread scheduling attribute is always
<b>PTHREAD_SCOPE_SYSTEM</b>, since threads (i.e. tasks) contend for resources
with all other threads in the system.
</tr>
<tr valign=top><td>
3
<td>The routines <b>pthread_condattr_getpshared(&nbsp;)</b>, <b>pthread_attr_setpshared(&nbsp;)</b>,
<b>pthread_mutexattr_getpshared(&nbsp;)</b> and <b>pthread_mutexattr_setpshared(&nbsp;)</b> are not
supported, since these interfaces describe how condition variables and
mutexes relate to a process, and VxWorks does not implement a process model.
</tr>
<tr valign=top><td>
4
<td>The default scheduling policy is inherited from the current system setting.
The POSIX model of per-thread scheduling policies is not supported, since a
basic tenet of the design of VxWorks is a system-wide scheduling policy.
</tr>
<tr valign=top><td>
5
<td>Thread cancellation is supported in appropriate <i>pthread</i> routines and
those routines already supported by VxWorks. However, the complete list of
cancellation points specified by POSIX is not supported because routines
such as <b>msync(&nbsp;)</b>, <b>fcntl(&nbsp;)</b>, <b>tcdrain(&nbsp;)</b>, and <b>wait(&nbsp;)</b> are not implemented by
VxWorks.
</tr>
<tr valign=top><td>
6
<td>The routines <b>getlogin_r(&nbsp;)</b>, <b>getgrgid_r(&nbsp;)</b>, <b>getpwnam_r(&nbsp;)</b>, and <b>getpwuid_r(&nbsp;)</b> are
not implemented.
</table>

<p>
</blockquote><h4>INCLUDE FILES</h4><blockquote><p>
<b>pthread.h</b>
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./taskLib.html#top">taskLib</a></b>, <b><a href="./semMLib.html#top">semMLib</a></b>, <b><a href="./semPxLib.html#top">semPxLib</a></b>,
<i>VxWorks Programmer's Guide: Multitasking</i>

<hr>
<a name="pthreadLibInit"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>pthreadLibInit(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>pthreadLibInit(&nbsp;)</strong> - initialize POSIX threads support</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>void pthreadLibInit (void)</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine initializes the POSIX threads (<i>pthreads</i>) support for
VxWorks. It should be called before any POSIX threads functions are used;
normally it will be called as part of the kernel's initialization sequence.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./pthreadLib.html#top">pthreadLib</a></b>

<hr>
<a name="pthread_sigmask"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>pthread_sigmask(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>pthread_sigmask(&nbsp;)</strong> - change and/or examine calling thread's signal mask (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int pthread_sigmask
    (
    int              how,     /* method for changing set */
    const sigset_t * set,     /* new set of signals */
    sigset_t *       oset     /* old set of signals */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine changes the signal mask for the calling thread as described
by the <i>how</i> and <i>set</i> arguments. If <i>oset</i> is not NULL, the previous
signal mask is stored in the location pointed to by it.
<p>
The value of <i>how</i> indicates the manner in which the set is changed and
consists of one of the following defined in <b>signal.h</b>:
<dl>
<dt>
<b>SIG_BLOCK</b>
<dd>
The resulting set is the union of the current set and the signal set
pointed to by <i>set</i>.
<dt>
<b>SIG_UNBLOCK</b>
<dd>
The resulting set is the intersection of the current set and the complement
of the signal set pointed to by <i>set</i>.
<dt>
<b>SIG_SETMASK</b>
<dd>
The resulting set is the signal set pointed to by <i>oset</i>.
</dl>

<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
On success zero; on failure a non-zero error code is returned.
<p>
</blockquote><h4>ERRNOS</h4><blockquote><p>
<b>EINVAL</b>
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./pthreadLib.html#top">pthreadLib</a></b>, <b><a href="./sigLib.html#kill">kill</a>(&nbsp;)</b>, <b><a href="./pthreadLib.html#pthread_kill">pthread_kill</a>(&nbsp;)</b>, <b><a href="./sigLib.html#sigprocmask">sigprocmask</a>(&nbsp;)</b>, <b><a href="./sigLib.html#sigaction">sigaction</a>(&nbsp;)</b>,  
<b><a href="./sigLib.html#sigsuspend">sigsuspend</a>(&nbsp;)</b>, <b><a href="./sigLib.html#sigwait">sigwait</a>(&nbsp;)</b>

<hr>
<a name="pthread_kill"></a>
<p align=right>
<a href="rtnIndex.htm"><i>OS Libraries :  Routines</i></a></p>

</blockquote><h1>pthread_kill(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>pthread_kill(&nbsp;)</strong> - send a signal to a thread (POSIX)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int pthread_kill
    (
    pthread_t thread,         /* thread to signal */
    int       sig             /* signal to send */
    )
</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine sends signal number <i>sig</i> to the thread specified by <i>thread</i>.
The signal is delivered and handled as described for the <b><a href="./sigLib.html#kill">kill</a>(&nbsp;)</b> function.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
On success zero; on failure a non-zero error code.
<p>
</blockquote><h4>ERRNOS</h4><blockquote><p>
<b>ESRCH</b>, <b>EINVAL</b>
<p>