tgcmd(1M)

NAME
     tgcmd - Tigon3 gigabit ethernet diagnostic tool

SYNOPSIS
     /usr/etc/tgcmd subcommand [ tgN ... ]

DESCRIPTION
     tgcmd is the diagnostic utility for the Tigon3 gigabit Ethernet driver
     tg(7M).  It supports a number of subcommands to interrogate and control
     both the driver itself and the Tigon3 interfaces ('tgN') under its
     control.  Typing tgcmd with no arguments outputs a usage message which
     lists all of the available subcommands.

WARNING
     Only some of the tgcmd subcommands are documented here.  The remaining
     (undocumented) subcommands should be executed only under the direction of
     Silicon Graphics service personnel - they could adversely affect system
     performance or functionality.

OPTIONS
     The following subcommands are safe for the user:

     tgcmd inventory
          Displays a one line summary for each Tigon3 board found in the
          system and recognized by the driver.

          # tgcmd inventory
                  Chip   Chip   Sybsys Subsys Board
          I/F     Vendor Device Vendor Device Rev
          ===     ====== ====== ====== ====== ======
          tg1     0x14e4 0x1645 0x10a9 0x8011 0x0000 SGI 5701 Copper
          tg2     0x14e4 0x1645 0x10a9 0x8012 0x0000 SGI 5701 Fiber

     tgcmd link_state tgN
          Displays current link speed, duplex and flow control setting of the
          specified interface.

          # tgcmd link_state tg1
          tg1 link is UP at 1000 Mbps FULL duplex flow_ctrl is OFF

     tgcmd configs tgN
          Displays the configuration parameters currently in effect for the
          specified interface.  The parameter values that are displayed with
          this command differ from the "saved configuration" displayed by
          tgconfig(1M), in that they have been decoded from their original
          string values, and the defaults have been resolved.

          This decoding and resolution step occurs when the interface is
          brought up, so if 'tgconfig -s' is used to change the configuration
          of an interface that is already up, 'tgconfig -g' will display the
          new configuration and 'tgcmd configs tgN' will display the old
          configuration that is still in effect.
          # tgcmd configs tg1
          accept_bcast   1
          autoneg        ON
          coal_frames_rx 0
          coal_frames_tx 0
          coal_usecs_rx  0
          coal_usecs_tx  0
          ctrl_rrbs      1
          data_rrbs      4
          fill_thresh    10
          flow_ctrl      ON
          hw_cksum_rx    1
          hw_cksum_tx    1
          link_pref      AUTO
          mac_mask       0x0
          mac_addr       0x0
          mbuf_chain_len 8
          sendQ_size     2048

     tgcmd get_stats tgN
          Displays statistics for the specified interface.  These statistics
          are cumulative since the last time the interface was brought up via
          ifconfig or since the last time 'tgcmd clear_stats tgN' command was
          executed.

          These statistics are separated into those collected by the driver
          ("Driver Statistics") and those collected by the interface hardware
          ("NIC Statistics").

          # tgcmd get_stats tg1

          Driver Statistics:
                             3  mbufs allocated for ethernet headers
                         14562  Interrupts
                           209  Max Bfrs on Send Ring
                             1  Max Pkts seen on I/F Send Queue
                            15  Max Bfrs added to RxStd Ring
                         21302  Rx pkts with H/W generated checksum
                             4  Rx pkts with S/W generated checksum
                          3178  Send lock busy
                        449947  Send lock obtained
                         14562  Status Block updates detected
                        449920  Tx pkts with H/W generated checksum
                            36  Tx restarted from interrupt
                        449922  Tx Ring producer index updated
                            10  Tx pkts with S/W generated checksum

          NIC Statistics:
                       1363792  ifHCInOctets
                          3696  <0x408>
                         21306  ifHCInUcastPkts
                         21299  etherStatsPkts64Octets
                             6  etherStatsPkts65to127Octets
                             1  etherStatsPkts128to255Octets
                     681456263  ifHCOutOctets
                        449923  ifHCOutUcastPkts
                             7  ifHCOutBroadcastPkts
                         21306  COSIfHCInPkts[1]
                        449930  COSIfHCOutPkts[1]
                        499621  nicDmaReadQueueFull
                        452614  nicRingSetSendProdIndex
                         14562  nicRingStatusUpdate
                         14562  nicInterrupts
                         14359  nicSendThresholdHit

     tgcmd clear_stats tgN
          Clears statistics for the specified interface.  To display
          statistics which occur only during a specific interval, run 'tgcmd
          clear_stats tgN' before the interval and 'tgcmd get_stats tgN' after
          the interval.

DIAGNOSTICS
     Could not open "/hw/net/if_tg": open: No such file or directory

     All tgcmd subcommands make ioctl calls to the tg driver, via the
     "/hw/net/if_tg" hardware graph node that the driver sets up when it finds
     at least one Tigon3 card in the system.  This error message most likely
     indicates that no Tigon3 cards were recognized by the driver. Use the
     hinv(1M) command to verify the presence of Tigon3 cards.

SEE ALSO
     ethernet(7), hinv(1M), ifconfig(1M), network(1M), tg(7M), tgconfig(1M).