tgcmd(1M)tgcmd(1M)NAMEtgcmd - Tigon3 gigabit ethernet diagnostic tool
SYNOPSIS
/usr/etc/tgcmd subcommand [ tgN ... ]
DESCRIPTIONtgcmd 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.
Page 1
tgcmd(1M)tgcmd(1M)
# 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
intr_cpu -1
link_pref AUTO
mac_mask 0x0
mac_addr 0x0
mbuf_chain_len 8
sendQ_size 2048
tgcmd get_cpu tgN
Displays the CPU that the interrupt thread for the specified
interface is running on (if known). If no interrupts have yet
occurred on that interface, the interrupt CPU will not yet be known.
# tgcmd get_cpu tg1
tg1 interrupts are running on CPU 0.
# tgcmd get_cpu tg2
No tg2 interrupts have yet occurred.
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
Page 2
tgcmd(1M)tgcmd(1M)
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 ALSOethernet(7), hinv(1M), ifconfig(1M), network(1M), tg(7M), tgconfig(1M).
Page 3