📄 semshow.html
字号:
<html><head><!-- /vobs/wpwr/docs/vxworks/ref/semShow.html - generated by refgen from semShow.c --> <title> semShow </title></head><body bgcolor="#FFFFFF"> <hr><a name="top"></a><p align=right><a href="libIndex.html"><i>VxWorks Reference Manual : Libraries</i></a></p></blockquote><h1>semShow</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong>semShow</strong> - semaphore show routines </p></blockquote><h4>ROUTINES</h4><blockquote><p><p><b><i><a href="./semShow.html#semShowInit">semShowInit</a></i>( )</b> - initialize the semaphore show facility<br><b><i><a href="./semShow.html#semInfo">semInfo</a></i>( )</b> - get a list of task IDs that are blocked on a semaphore<br><b><i><a href="./semShow.html#semShow">semShow</a></i>( )</b> - show information about a semaphore<br><p></blockquote><h4>DESCRIPTION</h4><blockquote><p>This library provides routines to show semaphore statistics, such assemaphore type, semaphore queuing method, tasks pended, etc.<p>The routine <b><i><a href="./semShow.html#semShowInit">semShowInit</a></i>( )</b> links the semaphore show facility into the VxWorkssystem. It is called automatically when the semaphore show facility isconfigured into VxWorks using either of the following methods:<ul><li>If you use the configuration header files, define<b>INCLUDE_SHOW_ROUTINES</b> in <b>config.h</b>.</li><li>If you use the Tornado project facility, select <b>INCLUDE_SEM_SHOW</b>. </ul><p><p></blockquote><h4>INCLUDE FILES</h4><blockquote><p><b>semLib.h</b><p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./semShow.html#top">semShow</a></b>, <b><a href="./semLib.html#top">semLib</a></b>, <i>VxWorks Programmer's Guide: Basic OS</i><hr><a name="semShowInit"></a><p align=right><a href="rtnIndex.html"><i>Libraries : Routines</i></a></p></blockquote><h1><i>semShowInit</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>semShowInit</i>( )</strong> - initialize the semaphore show facility</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>void semShowInit (void)</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine links the semaphore show facility into the VxWorks system.It is called automatically when the semaphore show facility isconfigured into VxWorks using either of the following methods:<ul><li> If you use the configuration header files, define<b>INCLUDE_SHOW_ROUTINES</b> in <b>config.h</b>.</li><li> If you use the Tornado project facility, select <b>INCLUDE_SEM_SHOW</b>.</ul><p></blockquote><h4>RETURNS</h4><blockquote><p><p> N/A</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./semShow.html#top">semShow</a></b><hr><a name="semInfo"></a><p align=right><a href="rtnIndex.html"><i>Libraries : Routines</i></a></p></blockquote><h1><i>semInfo</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>semInfo</i>( )</strong> - get a list of task IDs that are blocked on a semaphore</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>int semInfo ( SEM_ID semId, /* semaphore ID to summarize */ int idList[], /* array of task IDs to be filled in */ int maxTasks /* max tasks idList can accommodate */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine reports the tasks blocked on a specified semaphore.Up to <i>maxTasks</i> task IDs are copied to the array specified by <i>idList</i>.The array is unordered.<p></blockquote><h4>WARNING</h4><blockquote><p><p>There is no guarantee that all listed tasks are still valid or that newtasks have not been blocked by the time <b><i><a href="./semShow.html#semInfo">semInfo</a></i>( )</b> returns.<p></blockquote><h4>RETURNS</h4><blockquote><p>The number of blocked tasks placed in <i>idList</i>.</blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./semShow.html#top">semShow</a></b><hr><a name="semShow"></a><p align=right><a href="rtnIndex.html"><i>Libraries : Routines</i></a></p></blockquote><h1><i>semShow</i>( )</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote> <p><strong><i>semShow</i>( )</strong> - show information about a semaphore</p></blockquote><h4>SYNOPSIS</h4><blockquote><p><pre>STATUS semShow ( SEM_ID semId, /* semaphore to display */ int level /* 0 = summary, 1 = details */ )</pre></blockquote><h4>DESCRIPTION</h4><blockquote><p>This routine displays the state and optionally the pended tasks of a semaphore.<p>A summary of the state of the semaphore is displayed as follows:<pre> Semaphore Id : 0x585f2 Semaphore Type : BINARY Task Queuing : PRIORITY Pended Tasks : 1 State : EMPTY {Count if COUNTING, Owner if MUTEX}</pre>If <i>level</i> is 1, then more detailed information will be displayed.If tasks are blocked on the queue, they are displayed in the orderin which they will unblock, as follows:<pre> NAME TID PRI DELAY ---------- -------- --- ----- tExcTask 3fd678 0 21 tLogTask 3f8ac0 0 611</pre></blockquote><h4>RETURNS</h4><blockquote><p>OK or ERROR.<p></blockquote><h4>SEE ALSO</h4><blockquote><p><b><a href="./semShow.html#top">semShow</a></b>, <i>VxWorks Programmer's Guide: Target Shell, </i>windsh, <i>Tornado User's Guide: Shell</i></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -