Winsock Stress Test - ReceiveSend (Compact 7)
3/12/2014
The Winsock Stress Test strains Winsock and networking functionality by performing a large number of socket operations. The socket operations performed by this test may also stress the remainder of the networking stack, for example, when receiving and sending large amounts of data.
This test stresses the network stack by performing a large number of send or receive operations over a single connection. You can specify in the command line the number of megabytes (MB) of data to transmit. The test performs send and receive operations using random buffer sizes until the specified amount of data has been transferred. The test displays a message for each MB of data processed. The test can also display the status of each send or receive call.
You should run the server thread before or in the same command line as the client thread.
Test Prerequisites
Your device must meet the following requirements before you run this test.
There are no hardware prerequisites for Name Resolution Winsock Stress Test.
The following table shows the software requirements for the Name Resolution Winsock Stress Test.
| Requirements | Description |
|---|---|
netall.dll |
Module that provides functions that generate random numbers, output data, and parse command lines. The netall.dll file must be located in the same directory as the test. |
rsstres2_vx.exe |
Name Resolution Winsock stress test application |
Subtests
This test has no subtests.
Setting Up the Test
This test has no additional requirements beyond the standard test environment setup.
Running the Test
The Name Resolution Winsock Stress Test does not use the Tux test harness. You must run this test manually via Platform Builder's command line prompt.
The Name Resolution Winsock Stress Test has the following command line options, which you can display via the command: s rsstres2_vX.exe /?
rsstres2_vX [-cIPAddress] [-bBytes] [-wMSWait] [-srutvh] [-mTotBytesLimit]
| Parameter | Description |
|---|---|
c |
Specify the server to communicate with. (default: localhost) |
p |
Set port to use (default 40000) |
b |
Specify number of bytes per send. (randomly determined for each send if not specified) |
m |
Set total number of MBytes to transmit. (default: 1) |
w |
Time to wait (in milliseconds) between sends/recvs. |
s |
Run send thread |
r |
Run receive thread |
u |
Send and/or receive over datagram (UDP) sockets. [TCP is default] |
l |
Set max time for select to wait in seconds. (default: 10) |
e |
Set to verbose mode... data recv/send is printed to display. |
d |
Set to Deamon mode... recv thread is not closed upon client exit. |
i |
Version of IP to use 4, 6, or X (default: X) |
l |
local address to bind to for sending (default: implicit bind) |
h |
If specified, hard binding is used. Requires local bind for the send thread |
f |
Force data corruption check. - both sides have to use it - number of bytes in option b has to be multiple of 4. |
n |
Specify Min number of bytes per send. |
x |
Specify Max number of bytes per send. |
k |
Exit the Process while doing a Send/Receive (only for UDP) |
t |
close the socket (only valid with the -k option) |
j |
Don't call Select |
In addition, you can specify the following command-line options to modify the behavior of the test. Add one of the command-line parameter to:
| Parameter | Description |
|---|---|
-z |
Redirect output to the console |
-fl <filename> |
Redirect output to a file |
The following tables shows the test cases for the Name Resolution Winsock Stress Test.
| Command Line | Description |
|---|---|
s rsstres2_vx -r -m2 -u |
The following command line on the Windows CE-based device transfers 2 MB of data from a UPD client on the development computer to a server on the local Windows CE-based device. |
You must also run the following command line on the development computer: rsstres2_vx -s -m2 -u -c<CE device> -z
| Command Line | Description |
|---|---|
s rsstres2_vx -r -s -m200 -i4 |
The following command line on the Windows CE-based device performs a loopback transmission of 200 MB of data using IPv4. |
Verifying the Test
During the running of the test, there should not be any consistent failure messages displayed. At the end of the test a summary of the tests run will be displayed.
Troubleshooting the Test
If you specify the computer names or addresses, ensure that they are correct and reachable.
Ensure that the device has an network connection.
If the send/receive fails, you can try adding some delay between iterations or try smaller number of bytes.
For additional platform specific issues, consult the CTK articles on the TechNet wiki.