tgcmd(1M)
tgcmd - Tigon3 gigabit ethernet diagnostic tool
As shipped in IRIX 6.5.22. Last changed in IRIX 6.5.22.
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 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 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).