Section: User Commands (1)
netperf - a network performance benchmark
netperf[global options] -- [test specific options]
is a benchmark that can be used to measure various aspects ofnetworking performance.Currently, its focus is on bulk data transfer and request/responseperformance using either TCP or UDP, and the Berkeley Socketsinterface. In addition, tests for DLPI, and Unix DomainSockets, tests for IPv6 may be conditionally compiled-in.
- Use AF_INET (aka IPv4) addressing for the control and possibly dataconnections.
- Use AF_INET6 (aka IPv6) addressing for the control and possibly dataconnections.
- -a sizespec
- Alter the send and receive buffer alignments on the local system.This defaults to 8 bytes.
- -A sizespec
- As -a, but for the remote system.
- -B brandstr
- Add brandstr to the output of a test with banners disabled.
- -c [rate]
- Request CPU utilization and service demand calculations for thelocal system. If the optional rate parameter is specified,netperfwill use that instead of calculating the rate itself.
- -C [rate]
- As -c, but for the remote system.
- Increase the quantity of debugging output displayed duringa test (possibly at the expense of performance).
- -D [secs,units] (*)
- Display interim results at least every secs seconds uning units as theinitial guess for units per second. This is only available whennetperf has been configured with --enable-demo.
- -f GMKgmk
- Change the units of measure for *_STREAM tests. Capital letters arepowers of two, lowercase are powers of ten.
- -F fill_file
- Pre-fill the send buffers with data from the named file. This isintended to provide a means for avoiding buffers that are filled withdata which is trivially easy to compress. A good choice for a filethat should be present on any system is this manpage - netperf.man.Other files may be provided as part of the distribution.
- Display a usage string, and exit.
- -H name|ip,family (*)
- Set the hostname (or IP address) and address family to use toestablish the control connection to the remote system. Passing asingle name with no comma will only set remote_host and will leaveselection of address family for the control connection to the stack orby a -4 -r -6 command line option.
- -i max,min
- Set the maximum and minimum number of iterations when trying to reachcertain confidence levels.
- -I lvl,[,intvl]
- Specify the confidence level (either 95 or 99 - 99 is the default) andthe width of the confidence interval as a percentage (default 10)
- -l testlen
- Specify the length of the test (default 10 seconds).A negative value sets the number of request/response transactions,or the number of bytes for a stream test.
- -L name|ip,fam (*)
- Set the local name|IP and/or address family for the socket used forthe control connection to the remote netserver.
- -n numcpus
- Specify the number of CPU's in the system on those systems for whichnetperf has no way to find the number of CPU's programatically.
- This option will tell netperf to not establish a control connection toa remote netserver. Instead it will try to establish a dataconnection directly, using only the information supplied by thecommand line parameters and/or internal defaults. Unless other portsare provided by the command line, by default the data connection willbe to the "discard" port for a "STREAM" or "SENDFILE" test, the "echo"port for an "RR" test or the "chargen" port for a "MAERTS" test.
- -o sizespec
- Set an offset from the alignment specified with -a.
- -O sizespec
- As -o, but for the remote system.
- -p portnum,locport (*)
- Direct the control connection to a netserver listening on thespecified port, rather than using a "netperf" entry in/etc/services or the internal default (port 12865). If ",locport" isspecified the control connection will be established from that localport number. Specifying a single port number with no comma willspecify only the remote netserver port number and will leave localport number selection to the stack.
- -P 0|1
- Show (1) or suppress (0) the test banner.
- -t testname
- Specify the test to perform.Valid testnames include, but are not limited to, nor always compiled-in:
- -T lcpu,remcpu
- Request that netperf be bound to CPU lcpu and/or netserver be bound toCPU rcpu.
- -v verbosity
- Set the verbosity level for the test (only with -P).
TEST SPECIFIC OPTIONS
- Display a usage string based on the test name set with -t, and exit.
Please consult the netperf manualNetperf: A Network Performance Benchmark (netperf.ps) for more information. Or you can join and mail to netperf-talkAATTnetperf.org.
For those options taking two parms, at least one must be specified;specifying one value without a comma will set both parms to thatvalue, specifying a value with a leading comma will set just thesecond parm, a value with a trailing comma will set just the first. Toset each parm to unique values, specify both and separate them with acomma.
* For these options taking two parms, specifying one value with nocomma will only set the first parms and will leave the second at thedefault value. To set the second value it must be preceded with acomma or be a comma-separated pair. This is to retain previous netperfbehaviour.
There are bound to be bugs. If you think you have found a bug, pleasemention it in netperf-talkAATTnetperf.org. List membership is requiredto send email to the list. Seehttp://www.netperf.org/cgi-bin/mailman/listinfo/netperf-talk
. If allelse fails send email to Rick Jones <rajAATTcup.hp.com>.
SEE ALSONetperf: A Network Performance Benchmarkhttp://www.netperf.org/
HP Information Networks Division - Networking Performance Team.
Others too numerous to mention here - see the ACKNWLDGMNTS file
- GLOBAL OPTIONS
- TEST SPECIFIC OPTIONS
- SEE ALSO
This document was created byman2html,using the manual pages.