The gemtest provides functional test coverage of the Sun GigabitEthernet SBus and PCI bus Adapters. It runs in loopback (external/internal) mode and must be selected mutually exclusive with the nettest. The gemtest provides better fault isolation as compared to nettest.
No network configuration is necessary, however, you must have the GigabitEthernet card and the ge device driver installed and a loopback connector in place before running gemtest.
The gemtest uses DLPI RAW mode to talk to the device driver. For the purpose of this test, a packet is defined as an Ethernet header followed by the Ethernet data payload (refer to IEEE 802.3z). The test generates and sends out the desired number of packets (a tunable parameter) and expects to receive the same number of packets through the loopback interface, external or internal. If an error occurs (for example, packet mismatch or timeout), an error message indicating the type of error, its probable cause(s) and recommended action(s) is displayed on the SunVTS console.The data sent out is generated by a random number generator, and put into a data buffer. Each time the packet sent is selected from a different starting point of the data buffer, so that any two consecutively transmitted packets will not be the same.
Do NOT run nettest and gemtest at the same time.
To run gemtest, you must have a loopback connector connected to the Sun GigabitEthernet card. gemtest cannot run if the network interface is connected to a live network, however the link must be up. A loopback connector provides the network interface driver the necessary link for testing, while maintaining isolation from a live network. The loopback connector is required for both the internal and external tests.
Refer to Table 18-1 for test parameter descriptions.Table 18-1 gemtest Options
|Configuration||Specifies the Port Address, Host ID and Domain Name of the system under test.|
|Total Packets||Specifies the total number of the packets to send.The default number of packet is 1000.|
|Packet size||Determines the size (in bytes) of the packets to betransmitted. 60 <= packet size <= 1514. The default packet size is 1000 bytes|
|Loopback||Determines the external and internal loopback mode. The default setting is internal loopback mode.|
|Print_Warning||Enables or disable the printing of warningmessages. The default setting is Disable|
|Processor Affinity||Binds the test to a specific processor. If no processor is specified, the test migrates between processors. This option is only available on multiprocessor systems.|
The gemtest can only be run in Functional test mode. It is assumed that the host is not connected to the network through the intended test device(s).
/opt/SUNWvts/bin/gemtest standard_arguments -o dev=device,tpkts=n,pksz=pkt_size,lb=Internal ,warn=DisableTable 18-2 gemtest Command Line Syntax
|dev=device_name||Specifies the device to test such as ge0|
|tpkts=n||[1..100000], count of packets to loopback|
|pksz=pkt_size||[60 ... 1514], packet size in bytes|
|lb=Internal||select internal (or external) loopback mode|
|warn=Disable||enable or disable printing of warning messages|
64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to "32-Bit and 64-Bit Tests".
|6000||Timed out for receiving pkt number||Card and/or driver not configured properly.||Configure driver or reseat card. Check loopback connector. If the problem persists, contact your authorized Sun service Provider.|
|6001||system error||System may have run out of memory.||Reduce the number of processes currently running or increase system memory.|
|6002||Data mismatch between transmitted and received pkt data||Link loss,CRC error,Alignment Error.||If the frequency of errors is large, replace the card and/or contact your authorized Sun service Provider.|
|8000||errmsg for device||Card not present||Check for card.|
|8001||Memory allocation failure||System ran out of memory.||Reduce the number of processes currently running. Increase system memory.|
|8002||No card found||No card found.||Install card.|
|8003||Failed to get the link up||Loopback connector not connected.||Faulty loopback connector. Check it an replace it if necessary. If problem persists, contact your authorized Sun service Provider|
|8004||Transmit failed error||STREAMS was unable to accept more data, perhaps due to insufficient STREAMS memory resources.||Reduce the system load.|
|8005||Receive failed, error for pkt number||Try again, if the problem persists, then it is a system error. Contact your authorized Sun service provider.|
|8006||DLPI error for device string||Wrong Instance number X specified in geX||Specify correct instance number.|