xbstat(1M)

NAME
     xbstat - monitor Crossbow (Xbow) traffic

SYNOPSIS
     xbstat [-d devname] [-t sec]

DESCRIPTION
     xbstat monitors the traffic from and to each of the active slots of the
     Crossbow (Xbow) i/o interconnect.  It reports the total number of
     micropackets sent from and received at each link.  It also reports the
     LLP retries at each link.

     The -d devname option specifies which Crossbow to monitor in a multi-
     Crossbow system.  devname should be a valid Xtalk monitor point under the
     /hw graph.  If the devname is not explicitly specified, xbstat monitors
     /dev/xbmon by default.

     The -t sec option determines the duration of time in units of seconds
     that the Xbow traffic will be monitored.  If this option is not is
     selected, the monitoring continues until the user terminates it with a
     CTRL-C (or intr).

OVERVIEW
     xbstat gets its information from the two hardware performance counters
     and the Link Auxiliary Status Registers in the Xbow.  It uses a
     multiplexing technique to sample and report the SRC and DST link traffic
     at each XBow slot.  Cumulative counts since the beginning of the
     monitoring period are reported in units of micropackets.

     xbstat is capable of monitoring any selected Xbow in a multi-Xbow system.
     Use find /hw -name mon -print | grep xtalk to find all possible Xbow
     monitor points. A specific Xbow can be selected in two ways: explicitly,
     as a devname  with the -d option, or implicitly, as a soft link to
     /dev/xbmon.


     When specifying the Xbow implicitly, first create a symbolic link between
     the selected Xbow monitor point and /dev/xbmon before invoking this
     command. See examples below.

     Multiple instances of the command selecting different Xbows can be
     executed at a time.  However, one Xbow can be specified at a time with
     each instance of the command.


     The monitor data is statistical since the traffic over many links and
     slots is sampled or scanned during any given monitoring period.  All live
     links are monitored for the same amount of time during any monitoring
     cycle.
     Note that each slot consists of two links: SRC (Source) and
     DST(Destination).

     Slot          Physical slot being monitored.  I/O slots will be labelled
                   as IO1 through IO12, node slots will have labels N1 through
                   N4. Devices connected to each slot vary and are platform
                   and configuration dependent.

     Flags         Selected flags from the Link(x) Auxiliary Status register.

                   Currently only the "Widget Present" flag is shown to
                   indicate an active/live slot.

     Source        Number of micropackets sent from the SRC link of this slot.

     Destination   Number of micropackets received at the DST link of this
                   slot.

     RcRtry        Number of LLP receive retries.

     TxRtry        Number of LLP transmit retries.

EXAMPLES
          xbstat -d /hw/module/1/slot/n1/node/xtalk/0/mon -t 60

     Monitors for 60 seconds the traffic at the Xbow specified.

          ln -s /hw/node/xtalk/0/mon /dev/xbmon;

          xbstat -t 60

     Monitors for 60 seconds the traffic at the Xbow associated with
     /dev/xbmon.

          xbstat

     Monitors traffic until terminated by CTRL-C at the Xbow associated with
     /dev/xbmon.

FILES
     /dev/xbmon

RESTRICTIONS
     The command requires root privilege to run.

NOTES
     When a Xbow is not explicitly specified, make sure that /dev/xbmon points
     to an existing Xbow in the system.