vxwtask.html

vxworks相关论文

 do not allow breakpoint debugging. 
</dl>

<p>
For definitions, see <b>taskLib.h</b>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::priority"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::priority</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::priority</i>(&nbsp;)</strong> - examine the priority of task</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS priority
    (
    int * pPriority
    ) const</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine reports the current priority of its task.
The current priority is copied to the integer pointed to by <i>pPriority</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::priority_1"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::priority</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::priority</i>(&nbsp;)</strong> - change the priority of a task</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS priority
    (
    int newPriority
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine changes its task's priority to a specified priority.
Priorities range from 0, the highest priority, to 255, the lowest priority.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::registers"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::registers</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::registers</i>(&nbsp;)</strong> - set a task's registers</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS registers
    (
    const REG_SET * pRegs
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine loads a specified register set <i>pRegs</i> into the
task's TCB.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
This routine only works well if the task is known not to be in the ready
state.  Suspending the task before changing the register set is
recommended.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><i><a href="./VXWTask.html#VXWTask::suspend">VXWTask::suspend</a></i>(&nbsp;)</b>

<hr>
<a name="VXWTask::registers_1"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::registers</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::registers</i>(&nbsp;)</strong> - get task registers from the TCB</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS registers
    (
    REG_SET * pRegs
    ) const</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine gathers task information kept in the TCB.  It copies the
contents of the task's registers to the register structure <i>pRegs</i>.
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
This routine only works well if the task is known to be in a stable,
non-executing state.  Self-examination, for instance, is not advisable,
as results are unpredictable.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK.
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><i><a href="./VXWTask.html#VXWTask::suspend">VXWTask::suspend</a></i>(&nbsp;)</b>

<hr>
<a name="VXWTask::restart"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::restart</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::restart</i>(&nbsp;)</strong> - restart task</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    STATUS restart ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine "restarts" its task.  The task is first terminated, and then
reinitialized with the same ID, priority, options, original entry point,
stack size, and parameters it had when it was terminated.  Self-restarting
of a calling task is performed by the exception task.  
<p>
</blockquote><h4>NOTE</h4><blockquote><p>
If the task has modified any of its start-up parameters, the restarted
task will start with the changed values.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the task could not be restarted.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::resume"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::resume</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::resume</i>(&nbsp;)</strong> - resume task</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>    STATUS resume ()</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine resumes its task.  Suspension is cleared, and
the task operates in the remaining state.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK, or ERROR if the task cannot be resumed.
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::show"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::show</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::show</i>(&nbsp;)</strong> - display the contents of task registers</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays the register contents of its task
on standard output.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
The following shell command line displays the register of a task
<b>vxwT28</b>:
<pre>-&gt; vxwT28.show ()
</pre>

The example prints on standard output a display like the following
(68000 family):
<pre>d0     =        0   d1     =        0    d2    =    578fe    d3     =        1
d4     =   3e84e1   d5     =   3e8568    d6    =        0    d7     = ffffffff
a0     =        0   a1     =        0    a2    =    4f06c    a3     =    578d0
a4     =   3fffc4   a5     =        0    fp    =   3e844c    sp     =   3e842c
sr     =     3000   pc     =    4f0f2
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::show_1"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::show</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::show</i>(&nbsp;)</strong> - display task information from TCBs</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS show
    (
    int level
    ) const</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays the contents of its task's task control block (TCB).
If <i>level</i> is 1, it also displays task options
and registers.  If <i>level</i> is 2, it displays all tasks.
<p>
The TCB display contains the following fields:
<p>
<table>
<tr valign=top>
<th align=left>Field  </th><th align=left> Meaning</tr>
<tr><td colspan="2"><hr></tr>
<tr valign=top>
<td align=left>NAME   </td><td align=left> Task name</tr>
<tr valign=top>
<td align=left>ENTRY  </td><td align=left> Symbol name or address where task began execution</tr>
<tr valign=top>
<td align=left>TID    </td><td align=left> Task ID</tr>
<tr valign=top>
<td align=left>PRI    </td><td align=left> Priority</tr>
<tr valign=top>
<td align=left>STATUS </td><td align=left> Task status, as formatted by <b><i><a href="./taskShow.html#taskStatusString">taskStatusString</a></i>(&nbsp;)</b></tr>
<tr valign=top>
<td align=left>PC     </td><td align=left> Program counter</tr>
<tr valign=top>
<td align=left>SP     </td><td align=left> Stack pointer</tr>
<tr valign=top>
<td align=left>ERRNO  </td><td align=left> Most recent error code for this task</tr>
<tr valign=top>
<td align=left>DELAY  </td><td align=left> If task is delayed, number of clock ticks remaining in delay (0 otherwise)</tr>
<tr valign=top>
<td align=left></tr>
</tr>

</table>

</blockquote><h4>EXAMPLE</h4><blockquote><p>
<p>
The following example shows the TCB contents for a task named <b>t28</b>:
<pre>
    NAME        ENTRY    TID    PRI  STATUS      PC       SP    ERRNO  DELAY
  ---------- --------- -------- --- --------- -------- -------- ------ -----
  t28        _appStart 20efcac   1 READY      201dc90  20ef980      0     0

  stack: base 0x20efcac  end 0x20ed59c  size 9532   high 1452   margin 8080

  options: 0x1e
  VX_UNBREAKABLE      VX_DEALLOC_STACK    VX_FP_TASK         VX_STDIO


  D0 =       0   D4 =       0   A0 =       0   A4 =        0
  D1 =       0   D5 =       0   A1 =       0   A5 =  203a084   SR =     3000
  D2 =       0   D6 =       0   A2 =       0   A6 =  20ef9a0   PC =  2038614
  D3 =       0   D7 =       0   A3 =       0   A7 =  20ef980
</pre>

</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><i>VXWTaskstatusString</i>(&nbsp;)</b>,  
<i>Tornado User's Guide: The Tornado Shell</i>

<hr>
<a name="VXWTask::sigqueue"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::sigqueue</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::sigqueue</i>(&nbsp;)</strong> - send a queued signal to task</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>int sigqueue
    (
    int                signo,
    const union sigval value
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
The routine <b><i><a href="./sigLib.html#sigqueue">sigqueue</a></i>(&nbsp;)</b> sends to its task the signal specified by <i>signo</i> with
the signal-parameter value specified by <i>value</i>.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
OK (0), or ERROR (-1) if the signal number is invalid,
or if there are no queued-signal buffers available.
<p>
</blockquote><h4>ERRNO</h4><blockquote><p>
EINVAL EAGAIN
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./VXWTask.html#top">VXWTask</a></b>

<hr>
<a name="VXWTask::SRSet"></a>
<p align=right>
<a href="rtnIndex.html"><i>Wind Foundation Classes :  Methods</i></a></p>

</blockquote><h1><i>VXWTask::SRSet</i>(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong><i>VXWTask::SRSet</i>(&nbsp;)</strong> - set the task status register (MC680x0, MIPS, i386/i486)</p>

</blockquote><h4>SYNOPSIS</h4><blockquote><p>
<pre>STATUS SRSet
    (
    UINT16 sr
    )</pre>

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
</blockquote><h4>SYNOPSIS (I80X86)</h4><blockquote><p>
<pre>STATUS SRSet
    (
    UINT sr
    )
</pre>

</blockquote><h4>SYNOPSIS (MIPS)</h4><blockquote><p>