CHAPTER 3

SunATM Adapter Test(atmtest)

atmtest checks the SunATM-155 and SunATM-622 SBus and PCI bus adapters. It runs only in loopback (external or internal) mode. In order to run the atmtest external loopback mode, it requires a loopback connector, ATM adapter, and ATM device driver. The internal loopback mode does not require a loopback connector.

atmtest uses DLPI RAW mode to talk to the device driver. It establishes a virtual circuit (vc) to send a message, receive a message, and compare messages. If the message does not match, or the message is out of sequence, it sends out an error message.

The data that is sent is generated by a random number generator and put into a data buffer. Each message that is sent is selected from a different starting point in the data buffer so that no two consecutive messages are the same.

atmtest can test more than one virtual circuit. The more virtual circuits used increases the stress level of the test. atmtest automatically selects the virtual circuit number which is unique to the test. atmtest is nonscalable as it provides for more than one virtual circuit to be tested for each instance, which is adequate for the purpose of stress test. atmtest can only be selected when the intervention mode is enabled as it requires a loopback connector for external loopback testing. While intervention mode is enabled, atmtest and nettest are both valid as default selections, the user need to deselect the nettest for testing ATM device in loopback mode.

atmtest Options

FIGURE 3-1 atmtest

TABLE 3-1 atmtest

atmtest Options	Description
Configuration	Specifies the Post Address, Host ID, and Domain Name of the system being tested.
Total Packets	Specifies the total number of packets sent. The default number of packets sent is 10000.
Number of VC	Specifies the number of virtual circuits to be setup by one instance. The default number of virtual circuits is two for each instance. The atmtest uses these two virtual circuits to send out messages simultaneously. The message is received in sending order.
Loopback	Enables the user to select either the external loopback field or internal loopback field. The default selection is the external loopback field. A loopback connector is only needed for external loopback testing.
MAX_PKG_LEN	Specifies the maximum packet length to be used by the test to send out the data. The default number is 9140.
Outstanding_pkts	Describes the maximum number of outstanding packets. atmtest stops sending messages when the outstanding packet count is more than the number of packets this field specifies.
First_VC_no	Enables the user to setup the starting virtual circuit number to be used for each atmtest instance. atmtest can automatically avoid virtual circuit numbers that have already been used.
Bandwidth	Enables the user to select different bandwidths to test. The default number is 14.

atmtest Test Modes

atmtest can only be run in Functional test mode.

atmtest Command Line Syntax

/opt/SUNWvts/bin/atmtest standard_arguments -o dev=device,tpkts=n,nv=n,ml=n,bw=n,opkts=n,ld,sd,sl,nc,ns,vcf

TABLE 3-2 atmtest

Argument	Explanation
dev=device	Specifies the device name to be tested, such as ba0
tpkts=n	Specifies the number of packets to loopback [1..2147483647]
nv=num_vc	Specifies the number of simultaneous virtual circuits to be tested
ml=max_len	Specifies the maximum length of the random packet
bw=bandwidth	Specifies the bandwidth in MBits/s of a virtual circuit
opkts=n	Specifies the number of packets for each virtual circuit that can be transmitted without a corresponding receive
lb	Selects the internal loopback mode
sd	Changes the payload data to static instead of random
sl	Changes all packets to their maximum length
nc	Instructs the test not to check the receive payload (Improves throughput)
ns	Instructs the test not to exit on a packet reception failure
vcf=n	Specifies the first virtual circuit number used

atmtest Error Messages

The atmtest error messages are listed below with explanations or probable causes:

TABLE 3-3 atmtest

	Error Message	Probable Cause(s)	Recommended Action
6000	putmsg failed, errmsg=<data>
6001	getmsg failed, errmsg=<data>

TABLE 3-3 atmtest(Continued)

	Error Message	Probable Cause(s)	Recommended Action
6002	wrong vc: exp: <number>, obs: <number>
6003	VC<number> bogus pkt, seq: exp=<number>, obs=<number>; len: exp=<number>, obs=<number>
6004	VC<number> bad pkt len, EXP: <number>, OBS: <number>, seq=<number>
6005	VC<number> memcmp error
6006	VC<number> failed to rcv a packet
6007	Complete Usage: <string> u
6008	<string>: alarm
6009	<string>: getmsg
6010	receive <string> for <string> with <string> error
6011	DL_OK_ACK was not M_PCPROTO
6012	short response ctl.len: <number>
6013	ctl.len > sizeof (dl_ok_ack_t): <number>
6014	receive <string> for <string> with <string> error
6015	DL_BIND_ACK was not M_PCPROTO
6016	ioctl DLIOCRAW failed, errmsg <string>
6017	ioctl DL_IOC_HDR_INFO failed, errmsg <string>
6018	len=<number> > hdrmax=<number>
6019	ioctl ADDVC failed, errmsg <string>
6020	ioctl ALLOCBW failed, errmsg <string>

TABLE 3-3 atmtest(Continued)

	Error Message	Probable Cause(s)	Recommended Action
8000	open <device> failed, errmsg=<string>
8001	sa_add_vpci failed, errmsg=<string>
8002	sa_allocatebw failed, errmsg=<string>
8003	atm_attach failed, errmsg=%s