netshow.html

Vxworks API操作系统和驱动程序设计API。压缩的HTML文件

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

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

</blockquote><h1>netShowInit(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>netShowInit(&nbsp;)</strong> - initialize network show routines</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine links the network show facility into the VxWorks system.
These routines are included automatically if <b>INCLUDE_NET_SHOW</b>
is defined.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./netShow.html#top">netShow</a></b>

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

</blockquote><h1>arpShow(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>arpShow(&nbsp;)</strong> - display entries in the system ARP table</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays the current Internet-to-Ethernet address mappings 
in the ARP table.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>    -&gt; arpShow

    LINK LEVEL ARP TABLE
    Destination      LL Address        Flags  Refcnt Use        Interface
    ---------------------------------------------------------------------
    90.0.0.63        08:00:3e:23:79:e7 0x405  0      82         lo0
    ---------------------------------------------------------------------
</pre>

Some configuration is required when this routine is to be used remotely over
the network eg. through a telnet session or through the host shell using 
<b>WDB_COMM_NETWORK</b>. If more than 5 entries are expected in the table the 
parameter <b>RT_BUFFERED_DISPLAY</b> should be set to TRUE to prevent a possible
deadlock. This requires a buffer whose size can be set with <b>RT_DISPLAY_MEMORY</b>.
It will limit the number of entries that can be displayed (each entry requires
approx. 70 bytes).
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./netShow.html#top">netShow</a></b>

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

</blockquote><h1>arptabShow(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>arptabShow(&nbsp;)</strong> - display the known ARP entries</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays current Internet-to-Ethernet address mappings in the
ARP table.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./netShow.html#top">netShow</a></b>

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

</blockquote><h1>routestatShow(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>routestatShow(&nbsp;)</strong> - display routing statistics</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays routing statistics.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./netShow.html#top">netShow</a></b>

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

</blockquote><h1>routeShow(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>routeShow(&nbsp;)</strong> - display all IP routes (summary information)</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays the list of destinations in the routing table
along with the next-hop gateway and associated interface for each entry.
It separates the routes into network routes and host-specific entries,
but does not display the netmask for a route since it was created for
class-based routes which used predetermined values for that field.
<p>
The IP forwarding process will only use the first route entry to a 
destination. When multiple routes exist to the same destination with
the same netmask (which is not shown), the first route entry uses the
lowest administrative weight. The remaining entries (listed as additional
routes) use the same destination address. One of those entries will
replace the primary route if it is deleted.
<p>
</blockquote><h4>EXAMPLE</h4><blockquote><p>
<pre>    -&gt; routeShow

    ROUTE NET TABLE
    Destination      Gateway          Flags  Refcnt Use        Interface
    --------------------------------------------------------------------
    90.0.0.0         90.0.0.63        0x1    1      142        enp0
    10.0.0.0         90.0.0.70        0x1    1      142        enp0
      Additional routes to 10.0.0.0:
                     80.0.0.70        0x1    0      120        enp1
    --------------------------------------------------------------------

    ROUTE HOST TABLE
    Destination      Gateway          Flags  Refcnt Use        Interface
    --------------------------------------------------------------------
    127.0.0.1        127.0.0.1        0x101  0      82         lo0
    --------------------------------------------------------------------
</pre>

The flags field represents a decimal value of the flags specified
for a given route.  The following is a list of currently available
flag values:
<p>
<table>
<tr valign=top>
<td align=left>    0x1     </td><td align=left> - route is usable (that is, "up")</tr>
<tr valign=top>
<td align=left>    0x2     </td><td align=left> - destination is a gateway</tr>
<tr valign=top>
<td align=left>    0x4     </td><td align=left> - host specific routing entry</tr>
<tr valign=top>
<td align=left>    0x8     </td><td align=left> - host or net unreachable</tr>
<tr valign=top>
<td align=left>    0x10    </td><td align=left> - created dynamically (by redirect)</tr>
<tr valign=top>
<td align=left>    0x20    </td><td align=left> - modified dynamically (by redirect)</tr>
<tr valign=top>
<td align=left>    0x40    </td><td align=left> - message confirmed</tr>
<tr valign=top>
<td align=left>    0x80    </td><td align=left> - subnet mask present</tr>
<tr valign=top>
<td align=left>    0x100   </td><td align=left> - generate new routes on use</tr>
<tr valign=top>
<td align=left>    0x200   </td><td align=left> - external daemon resolves name</tr>
<tr valign=top>
<td align=left>    0x400   </td><td align=left> - generated by ARP</tr>
<tr valign=top>
<td align=left>    0x800   </td><td align=left> - manually added (static)</tr>
<tr valign=top>
<td align=left>    0x1000  </td><td align=left> - just discard packets (during updates)</tr>
<tr valign=top>
<td align=left>    0x2000  </td><td align=left> - modified by management protocol</tr>
<tr valign=top>
<td align=left>    0x4000  </td><td align=left> - protocol specific routing flag</tr>
<tr valign=top>
<td align=left>    0x8000  </td><td align=left> - protocol specific routing flag</tr>
<tr valign=top>
<td align=left></tr>
</tr>

</table>

In the above display example, the entry in the ROUTE NET TABLE has a 
flag value of 1, which indicates that this route is "up" and usable and 
network specific (the 0x4 bit is turned off).  The entry in the ROUTE 
HOST TABLE has a flag value of 5 (0x1 OR'ed with 0x4), which indicates 
that this route is "up" and usable and host-specific.
<p>
Some configuration is required when this routine is to be used remotely over
the network eg. through a telnet session or through the host shell using 
<b>WDB_COMM_NETWORK</b>. If more than 5 routes are expected in the table the 
parameter <b>RT_BUFFERED_DISPLAY</b> should be set to TRUE to prevent a possible
deadlock. This requires a buffer whose size can be set with <b>RT_DISPLAY_MEMORY</b>.
It will limit the number of routes that can be displayed (each route requires
approx. 70 bytes).
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./netShow.html#top">netShow</a></b>

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

</blockquote><h1>hostShow(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>hostShow(&nbsp;)</strong> - display the host table</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine prints a list of remote hosts, along with their Internet
addresses and aliases.
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
<p>
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./netShow.html#top">netShow</a></b>, <b><a href="./hostLib.html#hostAdd">hostAdd</a>(&nbsp;)</b>
<p>


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

</blockquote><h1>mRouteShow(&nbsp;)</h1> <blockquote></a></blockquote><h4>NAME</h4><blockquote>  
<p><strong>mRouteShow(&nbsp;)</strong> - display all IP routes (verbose information)</p>

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

</blockquote><h4>DESCRIPTION</h4><blockquote><p>
This routine displays the list of destinations in the routing table
along with the next-hop gateway and associated interface. It also
displays the netmask for a route (to handle classless routes which
use arbitrary values for that field) and the value which indicates
the route's creator, as well as any type-of-service information.
<p>
When multiple routes exist to the same destination with the same netmask,
the IP forwarding process only uses the first route entry with the lowest
administrative weight. The remaining entries (listed as additional routes)
use the same address and netmask. One of those entries will replace the
primary route if it is deleted.
<p>
Some configuration is required when this routine is to be used remotely over
the network eg. through a telnet session or through the host shell using 
<b>WDB_COMM_NETWORK</b>. If more than 5 routes are expected in the table the 
parameter <b>RT_BUFFERED_DISPLAY</b> should be set to TRUE to prevent a possible
deadlock. This requires a buffer whose size can be set with <b>RT_DISPLAY_MEMORY</b>.
It will limit the number of routes that can be displayed (each route requires
approx. 90 bytes).
<p>
</blockquote><h4>RETURNS</h4><blockquote><p>
N/A
</blockquote><h4>SEE ALSO</h4><blockquote><p>
<b><a href="./netShow.html#top">netShow</a></b>

</body>
</html>