SunVTS 3.0 Test Reference Manual

Chapter 18 Sun GigabitEthernet Test (gemtest)

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.

Note -

Do NOT run nettest and gemtest at the same time.

Note -

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.

gemtest Options

Figure 18-1 gemtest Option Menu


Refer to Table 18-1 for test parameter descriptions.

Table 18-1 gemtest Options
gemtest Options Description
 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.

gemtest Test Modes

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).

gemtest Command Line Syntax

/opt/SUNWvts/bin/gemtest standard_arguments -o dev=device,tpkts=n,pksz=pkt_size,lb=Internal ,warn=Disable

Table 18-2 gemtest Command Line Syntax



dev=device_nameSpecifies 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

Note -

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".

gemtest Error Messages

Table 18-3 gemtest Error Messages


Error Message 

Probable Cause(s) 

Recommended Action 

 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.
 8006DLPI error for device string Wrong Instance number X specified in geX Specify correct instance number.