Changeset 52053579 in rtems


Ignore:
Timestamp:
Mar 29, 2008, 4:39:56 AM (12 years ago)
Author:
Chris Johns <chrisj@…>
Branches:
4.10, 4.11, 4.9, master
Children:
990458b
Parents:
a408b33a
Message:

2008-03-29 Chris Johns <chrisj@…>

  • networking/testing.t: Patch from Ian Caddy to document the routes debug information.
Location:
doc
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • doc/ChangeLog

    ra408b33a r52053579  
     12008-03-29      Chris Johns <chrisj@rtems.org>
     2
     3        * networking/testing.t: Patch from Ian Caddy to document the
     4        routes debug information.
     5
    162008-03-11      Joel Sherrill <joel.sherrill@oarcorp.com>
    27
  • doc/networking/testing.t

    ra408b33a r52053579  
    9494@end itemize
    9595
     96@section Monitor Commands
     97
     98There are a number of command available in the shell / monitor
     99to aid in tracing the behavior of the network stack.  The following
     100is a list of them:
     101
     102@itemize @bullet
     103
     104@item @code{inet}
     105
     106This command shows the current routing information for the TCP/IP stack. Following is an
     107example showing the output of this command.
     108
     109@code{Destination     Gateway/Mask/Hw    Flags     Refs     Use Expire Interface
     11010.0.0.0        255.0.0.0          U           0        0     17 smc1
     111127.0.0.1       127.0.0.1          UH          0        0      0 lo0}
     112
     113In this example, there is only one network interface with an IP address of 10.8.1.1.  This
     114link is currently not up.
     115
     116Two routes that are shown are the default routes for the Ethernet interface (10.0.0.0) and the
     117loopback interface (127.0.0.1).
     118
     119Since the stack comes from BSD, this command is very similar to the netstat command.  For more
     120details on the network routing please look the following
     121URL: (@code{http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-routing.html})
     122
     123For a quick reference to the flags, see the table below:
     124
     125U       Up: The route is active.
     126H       Host: The route destination is a single host.
     127G       Gateway: Send anything for this destination on to this remote
     128        system, which will figure out from there where to send it.
     129S       Static: This route was configured manually, not automatically
     130        generated by the system.
     131C       Clone: Generates a new route based upon this route for machines
     132        we connect to. This type of route is normally used for local
     133        networks.
     134W       WasCloned: Indicated a route that was auto-configured based upon
     135        a local area network (Clone) route.
     136L       Link: Route involves references to Ethernet hardware.
     137
     138@item @code{mbuf}
     139
     140This command shows the current MBUF statistics.  An example of the command is shown below:
     141
     142@code{************ MBUF STATISTICS ************
     143mbufs:4096    clusters: 256    free: 241
     144drops:   0       waits:   0  drains:   0
     145      free:4080          data:16          header:0           socket:0
     146       pcb:0           rtable:0           htable:0           atable:0
     147    soname:0           soopts:0           ftable:0           rights:0
     148    ifaddr:0          control:0          oobdata:0
     149}
     150
     151@item @code{if}
     152
     153This command shows the current statistics for your Ethernet driver as long as the ioctl hook
     154@code{SIO_RTEMS_SHOW_STATS} has been implemented.  Below is an example:
     155
     156@code{************ INTERFACE STATISTICS ************
     157***** smc1 *****
     158Ethernet Address: 00:12:76:43:34:25
     159Address:10.8.1.1        Broadcast Address:10.255.255.255  Net mask:255.0.0.0
     160Flags: Up Broadcast Running Simplex
     161Send queue limit:50   length:0    Dropped:0
     162SMC91C111 RTEMS driver A0.01 11/03/2002 Ian Caddy (ianc@microsol.iinet.net.au)
     163   Rx Interrupts:0              Not First:0               Not Last:0
     164           Giant:0                   Runt:0              Non-octet:0
     165         Bad CRC:0                Overrun:0              Collision:0
     166   Tx Interrupts:2               Deferred:0        Missed Hearbeat:0
     167      No Carrier:0       Retransmit Limit:0         Late Collision:0
     168        Underrun:0        Raw output wait:0              Coalesced:0
     169 Coalesce failed:0                Retries:0
     170***** lo0 *****
     171Address:127.0.0.1       Net mask:255.0.0.0
     172Flags: Up Loopback Running Multicast
     173Send queue limit:50   length:0    Dropped:0
     174}
     175
     176@item @code{ip}
     177
     178This command show the IP statistics for the currently configured interfaces.
     179
     180@item @code{icmp}
     181
     182This command show the ICMP statistics for the currently configured interfaces.
     183
     184@item @code{tcp}
     185
     186This command show the TCP statistics for the currently configured interfaces.
     187
     188@item @code{udp}
     189
     190This command show the UDP statistics for the currently configured interfaces.
     191
     192@end itemize
     193
     194
    96195@section Driver basic operation
    97196
Note: See TracChangeset for help on using the changeset viewer.