📄 streams.doc25.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><link rel="STYLESHEET" type="text/css" href="../../wrs.css"><title>Configuration WindNet STREAMS for Tornado </title></head><body bgcolor="FFFFFF"><p class="navbar" align="right"><a href="index.html"><img border="0" alt="[Contents]" src="../../icons/contents.gif"></a><a href="streams.doc24.html"><img border="0" alt="[Prev]" src="../../icons/prev.gif"></a><a href="streams.doc26.html"><img border="0" alt="[Next]" src="../../icons/next.gif"></a></p><font face="Helvetica, sans-serif" class="sans"><h3 class="H2"><i><a name="72373" class="autotag">6.1 Configuring VxWorks for WindNet STREAMS</a></i></h3></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="72374" class="autotag"> </a>To configure WindNet STREAMS into your VxWorks target, follow these steps:</p></dd></dl><dl class="margin"><dd><p><ol class="List"><li value="1."><a name="72375" class="autotag"> </a>Define configuration constants in <b class="file">configAll.h</b> that suit your application needs. WindNet STREAMS is designed to offer you scalable functionality.</li></ol></p><dl class="margin"><dd><p><ol class="List2"><li value="1" type="a"><a name="81354" class="autotag"> </a>To include all services, define <b>INCLUDE_STREAMS_ALL</b> in <b class="file">configAll.h</b>. By default, this constant is located in the EXCLUDED FACILITIES section. Move it to the INCLUDED FACILITIES section. </li></ol></p><p><ol class="List2"><li value="2" type="a"><a name="81397" class="autotag"> </a>To include only basic STREAMS services, define <b>INCLUDE_STREAMS</b> in <b class="file">configAll.h</b>. You can then include any of the other facilities provided with WindNet STREAMS by defining in <b class="file">configAll.h </b>their respective configuration constants, as listed in <a href="streams.doc25.html#72381"><i class="title">Table 8</i></a>. Each of these constants is described briefly in the sections that follow. By default, these constants are located in the EXCLUDED FACILITIES section of <b class="file">configAll.h</b>. To make them operational, move the desired constants to the INCLUDED FACILITIES section.</li></ol></p></dd></dl><p><ol class="List"><li value="2."><a name="72376" class="autotag"> </a>Modify the constants shown in <a href="streams.doc26.html#72458"><i class="title">Table 9</i></a>, all located in <b class="file">configAll.h</b>, if their default values do not agree with your application requirements. These constants control the operation of WindNet STREAMS and each is described in one of the subsections in <a href="streams.doc26.html#72453"><i class="title">§6.2 WindNet STREAMS Configuration</i></a>. </li></ol></p><p><ol class="List"><li value="3."><a name="72377" class="autotag"> </a>Rebuild VxWorks.<p class="table"><h4 class="EntityTitle"><a name="72381" class="autotag"><font face="Helvetica, sans-serif" size="-1" class="sans">Table 8. WindNet STREAMS Configuration Constants</font></a></h4><table border="0" cellpadding="3" cellspacing="0"><tr><td colspan="20"><hr class="tablerule"></td></tr><tr valign="middle"><th rowspan="1" colspan="1"><div class="CellHeading"><b><a name="72385" class="autotag"> </a><font face="Helvetica, sans-serif" size="-1" class="sans">Constant</font></b></div></th><th rowspan="1" colspan="1"><div class="CellHeadingC" align="center"><a name="72387" class="autotag"> </a><b><font face="Helvetica, sans-serif" size="-1" class="sans">Facility Included</font></b></div></th></tr><tr><td colspan="20"><hr class="tablerule2"></td></tr><tr valign="middle"><th rowspan="1" colspan="1"></th><th rowspan="1" colspan="1"></th></tr><tr><td colspan="20"><hr class="tablerule2"></td></tr><tr valign="top"><td colspan=1 rowspan=1><div class="CellBody"><a name="72393" class="autotag"> </a>INCLUDE_STREAMS</div></td><td colspan=1 rowspan=1><div class="CellBody"><a name="72395" class="autotag"> </a>Basic STREAMS services.</div></td></tr><tr valign="top"><td colspan=1 rowspan=1><div class="CellBody"><a name="72397" class="autotag"> </a>INCLUDE_STREAMS_ALL</div></td><td colspan=1 rowspan=1><div class="CellBody"><a name="72399" class="autotag"> </a>All the STREAMS services in this table.</div></td></tr><tr valign="top"><td colspan=1 rowspan=1><div class="CellBody"><a name="72401" class="autotag"> </a>INCLUDE_STREAMS_SOCKET</div></td><td colspan=1 rowspan=1><div class="CellBody"><a name="72403" class="autotag"> </a>Socket library and module.</div></td></tr><tr valign="top"><td colspan=1 rowspan=1><div class="CellBody"><a name="72405" class="autotag"> </a>INCLUDE_STREAMS_TLI</div></td><td colspan=1 rowspan=1><div class="CellBody"><a name="72407" class="autotag"> </a>XTI/TLI library and module.</div></td></tr><tr valign="top"><td colspan=1 rowspan=1><div class="CellBody"><a name="72409" class="autotag"> </a>INCLUDE_STREAMS_DLPI</div></td><td colspan=1 rowspan=1><div class="CellBody"><a name="72411" class="autotag"> </a>DLPI driver.</div></td></tr><tr valign="top"><td colspan=1 rowspan=1><div class="CellBody"><a name="72413" class="autotag"> </a>INCLUDE_STREAMS_AUTOPUSH</div></td><td colspan=1 rowspan=1><div class="CellBody"><a name="72415" class="autotag"> </a><b class="keyword">Autopush</b> utility.</div></td></tr><tr valign="top"><td colspan=1 rowspan=1><div class="CellBody"><a name="72417" class="autotag"> </a>INCLUDE_STREAMS_STRACE</div></td><td colspan=1 rowspan=1><div class="CellBody"><a name="72419" class="autotag"> </a><b class="keyword">Strace</b> utility.</div></td></tr><tr valign="top"><td colspan=1 rowspan=1><div class="CellBody"><a name="72421" class="autotag"> </a>INCLUDE_STREAMS_STRERR</div></td><td colspan=1 rowspan=1><div class="CellBody"><a name="72423" class="autotag"> </a><b class="keyword">Strerr</b> utility.</div></td></tr><tr valign="top"><td colspan=1 rowspan=1><div class="CellBody"><a name="72425" class="autotag"> </a>INCLUDE_STREAMS_DEBUG</div></td><td colspan=1 rowspan=1><div class="CellBody"><a name="72427" class="autotag"> </a>Show routines.</div></td></tr><tr valign="top"><td colspan=1 rowspan=1></td><td colspan=1 rowspan=1></td></tr><tr><td colspan="20"><hr class="tablerule"></td></tr><tr valign="middle"><td colspan="20"></td></tr></table></p></li></ol></p></dd></dl></dd></dl><font face="Helvetica, sans-serif" class="sans"><h4 class="H3"><i><a name="72434" class="autotag">6.1.1 <b>INCLUDE_STREAMS_ALL </b></a></i></h4></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="72435" class="autotag"> </a>This constant forces the inclusion of all STREAMS services supported by WindNet STREAMS and listed in <a href="streams.doc25.html#72381"><i class="title">Table 8</i></a>, except <b>INCLUDE_STREAMS_DEBUG</b> which should be defined only during debugging.</p></dd></dl></dd></dl><font face="Helvetica, sans-serif" class="sans"><h4 class="H3"><i><a name="72436" class="autotag">6.1.2 <b>INCLUDE_STREAMS </b></a></i></h4></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="72437" class="autotag"> </a>The constant <b>INCLUDE_STREAMS</b> provides basic WindNet STREAMS services, that is, protocol services to protocol drivers and modules. The user application interface to access STREAMS-based protocols is included as part of this option. The STREAMS <b class="keyword">log</b> and <b class="keyword">nuls</b> drivers are included, as well as the <b class="keyword">pipemod</b> module.</p></dd></dl></dd></dl><font face="Helvetica, sans-serif" class="sans"><h4 class="H3"><i><a name="72438" class="autotag">6.1.3 <b>INCLUDE_STREAMS_DEBUG </b></a></i></h4></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="72439" class="autotag"> </a>This option adds the show routines available with WindNet STREAMS useful for debugging STREAMS applications. These routines display the STREAMS queues, messages in the queues, STREAMS statistics, and STREAMS module and driver information. For a list and description of each of these routines, call or see the manual entry for <b class="routine"><i class="routine">strmShow</i></b><b>( )</b>. For information on how to use the debug printing option, see <a href="streams.doc21.html#80250"><i class="title">§5.1 cmn_err( ): STREAMS Debug Printing</i></a>.</p></dd></dl></dd></dl><font face="Helvetica, sans-serif" class="sans"><h4 class="H3"><i><a name="72440" class="autotag">6.1.4 <b>INCLUDE_STREAMS_STRACE </b></a></i></h4></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="72441" class="autotag"> </a>This constant adds the <b class="command">strace</b> utility, which works in conjunction with the WindNet STREAMS <b class="keyword">log</b> driver to display or store trace messages from a STREAMS module or driver. This utility can be very useful when debugging STREAMS modules and drivers. The #define <b>STREAMS_STRACE_OUTPUT</b> can be set to a directory in the host machine where trace messages can be stored (see <a href="streams.doc26.html#72519"><i class="title">§6.2.8 STREAMS_STRACE_OUTPUT_DIR</i></a>). For information on how to use the <b class="keyword">strace</b> utility, see <a href="streams.doc22.html#80429"><i class="title">§5.2.1 strace Utility</i></a>. </p></dd></dl></dd></dl><dl class="margin"><dd><table border="0" cellpadding="3" cellspacing="0"><tr valign="top"><td valign="top" width="40"><a name="81592" class="autotag"><br></a><img border="0" alt="*" src="../../icons/note.gif"> </td><td><div class="Note"><hr><b class="symbol_UC">NOTE: </b> It is recommended that the VxWorks NFS client service be included when this option is used to optimize operating speed.<hr></div></td></tr></table></dd></dl><font face="Helvetica, sans-serif" class="sans"><h4 class="H3"><i><a name="72443" class="autotag">6.1.5 <b>INCLUDE_STREAMS_STRERR </b></a></i></h4></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="72444" class="autotag"> </a>This constant adds the <b class="command">strerr</b> utility which works in conjunction with the WindNet STREAMS <b class="keyword">log</b> driver to store in a file error messages coming from STREAMS drivers and modules. The file is created in the directory specified with the #define <b>STREAMS_STRERR_OUTPUT</b> (see also <a href="streams.doc26.html#72517"><i class="title">§6.2.7 STREAMS_STRERR_OUTPUT_DIR</i></a>). This directory must be accessible to the VxWorks target. For information on how to use the <b class="keyword">strerr</b> utility, see <a href="streams.doc22.html#80441"><i class="title">§5.2.2 strerr Utility</i></a>.</p></dd></dl></dd></dl><dl class="margin"><dd><table border="0" cellpadding="3" cellspacing="0"><tr valign="top"><td valign="top" width="40"><a name="81597" class="autotag"><br></a><img border="0" alt="*" src="../../icons/note.gif"> </td><td><div class="Note"><hr><b class="symbol_UC">NOTE: </b> It is recommended that the VxWorks NFS client service be included when this option is used to optimize operating speed.<hr></div></td></tr></table></dd></dl><font face="Helvetica, sans-serif" class="sans"><h4 class="H3"><i><a name="72445" class="autotag">6.1.6 <b>INCLUDE_STREAMS_AUTOPUSH </b></a></i></h4></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="89201" class="autotag"> </a>This option adds the <b class="command">autopush</b> utility which works in conjunction with the STREAMS SAD driver. Use the <b class="command">autopush</b> utility to configure the SAD<b class="keyword"> </b>driver to automatically push modules on top of a STREAMS driver when the driver is opened by an application. For more information on using <b class="command">autopush</b> and the SAD driver, see <a href="streams.doc10.html#84484"><i class="title">§3.4.1 The Autopush Utility</i></a>.</p></dd></dl></dd></dl><font face="Helvetica, sans-serif" class="sans"><h4 class="H3"><i><a name="89205" class="autotag">6.1.7 <b>INCLUDE_STREAMS_SOCKET </b></a></i></h4></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="72448" class="autotag"> </a>This option adds to the WindNet STREAMS package a STREAMS socket library and the STREAMS driver <b class="keyword">sockmod</b>. The socket library can then be used to access STREAMS transport providers. For information on using STREAMS sockets, see <a href="streams.doc8.html#76298"><i class="title">§3.2 STREAMS Sockets Programming</i></a>.</p></dd></dl></dd></dl><font face="Helvetica, sans-serif" class="sans"><h4 class="H3"><i><a name="72449" class="autotag">6.1.8 <b>INCLUDE_STREAMS_TLI </b></a></i></h4></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="72450" class="autotag"> </a>This option adds to the WindNet STREAMS package a STREAMS Transport Library Interface (TLI), and the STREAMS modules <b class="keyword">tirdwr</b> and <b class="keyword">timod</b>. The TLI library can then be used to access STREAMS transport providers which are compatible with TPI. For information on the XTI and TLI interfaces, see <a href="streams.doc7.html#80040"><i class="title">§3.1 XTI/TLI Programming</i></a>.</p></dd></dl></dd></dl><font face="Helvetica, sans-serif" class="sans"><h4 class="H3"><i><a name="72451" class="autotag">6.1.9 <b>INCLUDE_STREAMS_DLPI </b></a></i></h4></font><dl class="margin"><dd><dl class="margin"><dd><p class="Body"><a name="72452" class="autotag"> </a>This facility adds to the WindNet STREAMS package a Data Link Provider Interface (DLPI) driver, <b class="keyword">/dev/dlb</b>, that can be used to access existing VxWorks Ethernet drivers. The DLPI driver is provided to allow backward compatibility to previously released VxWorks Ethernet drivers. The capabilities of this driver are limited; see <a href="streams.doc9.html#83069"><i class="title">§3.3 Data Link Provider Interface (DLPI) Driver</i></a> for more information.</p></dd></dl></dd></dl><a name="foot"><hr></a><p class="navbar" align="right"><a href="index.html"><img border="0" alt="[Contents]" src="../../icons/contents.gif"></a><a href="streams.doc24.html"><img border="0" alt="[Prev]" src="../../icons/prev.gif"></a><a href="streams.doc26.html"><img border="0" alt="[Next]" src="../../icons/next.gif"></a></p></body></html><!---This file generated April 10, 1998, 12:25PM PDTby WRS Documentation (jeff), Wind River Systems, Inc. conversion tool: Quadralay WebWorks Publisher 3.5.0 template: CSS Template, Jan 1998 - Jefro --->⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -