RTEMS 4.9.2 On-Line Library

Monitor Commands

RTEMS Network Supplement

4.3: Monitor Commands

There are a number of command available in the shell / monitor to aid in tracing the behavior of the network stack. The following is a list of them:

inet
This command shows the current routing information for the TCP/IP stack. Following is an example showing the output of this command.
```
Destination     Gateway/Mask/Hw    Flags     Refs     Use Expire Interface
10.0.0.0        255.0.0.0          U           0        0     17 smc1
127.0.0.1       127.0.0.1          UH          0        0      0 lo0
```
In this example, there is only one network interface with an IP address of 10.8.1.1. This link is currently not up.

Two routes that are shown are the default routes for the Ethernet interface (10.0.0.0) and the loopback interface (127.0.0.1).

Since the stack comes from BSD, this command is very similar to the netstat command. For more details on the network routing please look the following URL: (?url?http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-routing.html?)

For a quick reference to the flags, see the table below:

`U'
Up: The route is active.
`H'
Host: The route destination is a single host.
`G'
Gateway: Send anything for this destination on to this remote system, which will figure out from there where to send it.
`S'
Static: This route was configured manually, not automatically generated by the system.
`C'
Clone: Generates a new route based upon this route for machines we connect to. This type of route is normally used for local networks.
`W'
WasCloned: Indicated a route that was auto-configured based upon a local area network (Clone) route.
`L'
Link: Route involves references to Ethernet hardware.

mbuf

This command shows the current MBUF statistics. An example of the command is shown below:

************ MBUF STATISTICS ************
mbufs:4096    clusters: 256    free: 241
drops:   0       waits:   0  drains:   0
      free:4080          data:16          header:0           socket:0
       pcb:0           rtable:0           htable:0           atable:0
    soname:0           soopts:0           ftable:0           rights:0
    ifaddr:0          control:0          oobdata:0

if

This command shows the current statistics for your Ethernet driver as long as the ioctl hook SIO_RTEMS_SHOW_STATS has been implemented. Below is an example:

************ INTERFACE STATISTICS ************
***** smc1 *****
Ethernet Address: 00:12:76:43:34:25
Address:10.8.1.1        Broadcast Address:10.255.255.255  Net mask:255.0.0.0
Flags: Up Broadcast Running Simplex
Send queue limit:50   length:0    Dropped:0
SMC91C111 RTEMS driver A0.01 11/03/2002 Ian Caddy (ianc@microsol.iinet.net.au)
   Rx Interrupts:0              Not First:0               Not Last:0
           Giant:0                   Runt:0              Non-octet:0
         Bad CRC:0                Overrun:0              Collision:0
   Tx Interrupts:2               Deferred:0        Missed Hearbeat:0
      No Carrier:0       Retransmit Limit:0         Late Collision:0
        Underrun:0        Raw output wait:0              Coalesced:0
 Coalesce failed:0                Retries:0
***** lo0 *****
Address:127.0.0.1       Net mask:255.0.0.0
Flags: Up Loopback Running Multicast
Send queue limit:50   length:0    Dropped:0

ip
This command show the IP statistics for the currently configured interfaces.
icmp
This command show the ICMP statistics for the currently configured interfaces.
tcp
This command show the TCP statistics for the currently configured interfaces.
udp
This command show the UDP statistics for the currently configured interfaces.

RTEMS Network Supplement