xref: /freebsd/tools/regression/netinet/tcpstream/README (revision 05248206f720394d95c2a7475429311df670a2e9)
1e8929330SRobert Watsontcpstream - a simple TCP streaming test tool
2e8929330SRobert Watson--------------------------------------------
3e8929330SRobert Watson
4e8929330SRobert Watsontcpstream generates TCP connections between a 'client' and a 'server'.  The
5e8929330SRobert Watsonclient writes a pseudo-random byte stream using varying write sizes.  The
6e8929330SRobert Watsonserver then reads the stream and uses the same generator to confirm that the
7e8929330SRobert Watsondata is correct.  To run tcpstream, select a seed value (should be the same
8e8929330SRobert Watsonfor the client and server), and a port number (also the same for client and
9e8929330SRobert Watsonserver).  Typical use might be:
10e8929330SRobert Watson
11e8929330SRobert WatsonRun the server on port 8080 and use a seed of 100:
12e8929330SRobert Watson
13e8929330SRobert Watson    tcpstream server 8080 100
14e8929330SRobert Watson
15e8929330SRobert WatsonNow run the client on a second machine with the server's IP, port 8080, and
16e8929330SRobert Watsonseed of 100:
17e8929330SRobert Watson
18e8929330SRobert Watson    tcpstream client 192.168.10.10 8080 100
19