Version 1.0

NetManage Inc. 
10725 De Anza Blvd.
Cupertino, CA 95014
(408) 973-7171
FAX: (408) 257-6405


Socket Wrencher was developed by NetManage to be an easy to use Winsock
testing tool for the Winsock and TCP/IP community of developers, users,
analysts, etc. Socket Wrencher provides a suite of performance tests over
TCP and UDP as well as several tests to check characteristics of a Winsock
based protocol stack.

Each performance test checks a different aspect of a Winsock compatible
TCP/IP protocol stack. Characteristics checked include synchronous and
asynchronous operation, UDP and TCP operation, send only or echo, as well
as performance with different block sizes.  As a group these tests provide
a way to check stack performance independent of any particular application's
use of the stack or any particular implementation of a stack.

In each of the performance tests you will see NetManage performance 
numbers provided as a reference.  These results were obtained on a 
production network running Socket Wrencher over NetManage's TCP/IP protocol
stack on a 50MHz 486DX computer running Windows 3.1 with a 3Com 3C509 
ethernet card.  The tests were run to a Sun SparcStation IPC running 
SunOS 4.1.3.  Note that the host you test against will have a significant 
impact on the test results, and all tests should be run against the same
host when comparing results between protocol stacks or tests.

NetManage has provided this software free of charge and you are encouraged
to copy and distribute it unchanged to anyone else free of charge.  
We believe that improved testing will lead to better quality products 
which ultimately benefit everyone in the industry.


Installation and Operation:
===========================
To run the software create a directory on your hard drive,
such as c:\sockwrc.  

1. Copy all of the files on the floppy into this directory.  

2. Create an icon from Program Manager for the file sockwrc.exe. 
Double click on this icon to launch Socket Wrencher.

3. From Socket Wrencher's main window select the Configure option.  
In the dialog box you see, enter the name of a host system running 
TCP/IP (i.e. a UNIX computer on your network).  

4. Select the number of iterations you would like.  The results of 
your tests will be an average of all the iterations.  

5. Then select the option for how much data you would like to send.  
As an example if you select 5 iterations of 1MB then each performance 
test will send 1 Megabyte of data 5 times and time how long it takes 
to send.  The results will be averaged and reported on a bar graph as 
well as in a file sockwrc.log.  Additionally each test will be run with 
block sizes of 1K, 2K, 4K, 8K and 16K.  

6. To run a test simply double click on one of the icons in the main 
window or select the test from the Performance options.  You may want to 
run several tests with only several iterations and only sending 128K of 
data to get a feel for how the tests run since some of the tests may take 
several minutes to run if more data or more iterations are used.  
Eventually you should run the tests with 1MB to get the most accurate
results.