.rn '' }`
''' $RCSfile$$Revision$$Date$
'''
''' $Log$
'''
.de Sh
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp
.if t .sp .5v
.if n .sp
..
.de Ip
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb
.ft CW
.nf
.ne \\$1
..
.de Ve
.ft R

.fi
..
'''
'''
'''     Set up \*(-- to give an unbreakable dash;
'''     string Tr holds user defined translation string.
'''     Bell System Logo is used as a dummy character.
'''
.tr \(*W-|\(bv\*(Tr
.ie n \{\
.ds -- \(*W-
.ds PI pi
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.ds L" ""
.ds R" ""
'''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
'''   \*(L" and \*(R", except that they are used on ".xx" lines,
'''   such as .IP and .SH, which do another additional levels of
'''   double-quote interpretation
.ds M" """
.ds S" """
.ds N" """""
.ds T" """""
.ds L' '
.ds R' '
.ds M' '
.ds S' '
.ds N' '
.ds T' '
'br\}
.el\{\
.ds -- \(em\|
.tr \*(Tr
.ds L" ``
.ds R" ''
.ds M" ``
.ds S" ''
.ds N" ``
.ds T" ''
.ds L' `
.ds R' '
.ds M' `
.ds S' '
.ds N' `
.ds T' '
.ds PI \(*p
'br\}
.\"	If the F register is turned on, we'll generate
.\"	index entries out stderr for the following things:
.\"		TH	Title 
.\"		SH	Header
.\"		Sh	Subsection 
.\"		Ip	Item
.\"		X<>	Xref  (embedded
.\"	Of course, you have to process the output yourself
.\"	in some meaninful fashion.
.if \nF \{
.de IX
.tm Index:\\$1\t\\n%\t"\\$2"
..
.nr % 0
.rr F
.\}
.TH tcpblast 8 "perl 5.005, patch 03" "24/Oct/2000" "tcpblast"
.UC
.if n .hy 0
.if n .na
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.de CQ          \" put $1 in typewriter font
.ft CW
'if n "\c
'if t \\&\\$1\c
'if n \\&\\$1\c
'if n \&"
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
'.ft R
..
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
.	\" AM - accent mark definitions
.bd B 3
.	\" fudge factors for nroff and troff
.if n \{\
.	ds #H 0
.	ds #V .8m
.	ds #F .3m
.	ds #[ \f1
.	ds #] \fP
.\}
.if t \{\
.	ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.	ds #V .6m
.	ds #F 0
.	ds #[ \&
.	ds #] \&
.\}
.	\" simple accents for nroff and troff
.if n \{\
.	ds ' \&
.	ds ` \&
.	ds ^ \&
.	ds , \&
.	ds ~ ~
.	ds ? ?
.	ds ! !
.	ds /
.	ds q
.\}
.if t \{\
.	ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.	ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.	ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.	ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.	ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.	ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
.	ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
.	ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.	ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
.\}
.	\" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.ds oe o\h'-(\w'o'u*4/10)'e
.ds Oe O\h'-(\w'O'u*4/10)'E
.	\" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.	\" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.	ds : e
.	ds 8 ss
.	ds v \h'-1'\o'\(aa\(ga'
.	ds _ \h'-1'^
.	ds . \h'-1'.
.	ds 3 3
.	ds o a
.	ds d- d\h'-1'\(ga
.	ds D- D\h'-1'\(hy
.	ds th \o'bp'
.	ds Th \o'LP'
.	ds ae ae
.	ds Ae AE
.	ds oe oe
.	ds Oe OE
.\}
.rm #[ #] #H #V #F C
.SH "NAME"
tcpblast \- tool for measuring network bandwidth
.SH "SYNOPSIS"
\fBtcpblast\fR [options] \fIdestination[:port]\fR
.SH "DESCRIPTION"
tcpblast/udpblast is a simple tool for probing network and estimating its
throughput. By default it sends 300 blocks (1024 bytes each) of data to
specified destination host.
.PP
Destination can be name or address, IPv4 or IPv6. When IPv6 address is specified
with port it should look like: \*(L'[3ffe:8010::1]:9\*(R' (with single quotes to prevent
shell expansion of []).
.Sh "Options"
.Ip "\fB\-4, --ipv4\fR           use only ipv4 address" 3
.Ip "\fB\-6, --ipv6\fR           use only ipv6 address" 3
.Ip "\fB\-a\fR                   send random data" 3
.Ip "\fB\-b\fR \fI\s-1BUF_SIZE\s0\fR          socket buf size (default: \-1, don't change), with `\-\*(T' to be substracted from results" 3
.Ip "\fB\-c, --count\fR \fI\s-1BLOCKS\s0\fR   change default (300) number of blocks, range: 1..10000000" 3
.Ip "\fB\-d\fR \fI\s-1DOTFREQ\s0\fR           print dot every \s-1DOTFREQ\s0 blocks, disables cont. speed disp." 3
.Ip "\fB\-h, --help\fR           this help" 3
.Ip "\fB\-i, --delay\fR \fI\s-1DELAY\s0\fR    write delay in microseconds (\s-1EXPERIMENTAL\s0)" 3
.Ip "\fB\-l, --last\fR \fI\s-1BLKS\s0\fR      show also speed for last \s-1BLKS\s0 blocks" 3
.Ip "\fB\-m\fR                   results for every block in separate line" 3
.Ip "\fB\-n, --nwrite\fR         do not write, use e.g. with chargen port" 3
.Ip "\fB\-o\fR                   switch from continuous speed displaying to dots printing" 3
.Ip "\fB\-p \s-1PORT\s0\fR              bind this local \s-1PORT\s0" 3
.Ip "\fB\-q --quiet\fR           show only final statistics" 3
.Ip "\fB\-r, --read\fR           read data returned to us, switches default port to echo" 3
.Ip "\fB\-R, --rate\fR \fI\s-1RATESPEC\s0\fR  limit the speed according to the \s-1RATESPEC\s0" 3
.Ip "\fB\-s\fR \fI\s-1BLOCK_SIZE\s0\fR        block size (default 1024 bytes)" 3
.Ip "\fB\-t\fR \fI\s-1MAXTIME\s0\fR           limit time to \s-1MAXTIME\s0 (up to 42950 h)" 3
.Ip "\fB    --tcp\fR            use \s-1TCP\s0 (default)" 3
.Ip "\fB    --udp\fR            use \s-1UDP\s0 (default if named udpblast)" 3
.Ip "\fB\-v, --verbosity\fR      verbosity, default 0, maximum 3. \-v adds time display, \-vv also speed in B/s, \-v \- speed in b/s." 3
.Ip "\fB\-V\fR, \fB--version\fR        version" 3
.Ip "\fIdestination\fR          host name or address" 3
.Ip "\fIport\fR                 use port #/name xyz instead of default port 9" 3
.PP
\s-1RATESPEC\s0         \s-1RATE\s0[,\s-1TIME\s0][:\s-1RATE\s0[,\s-1TIME\s0]]...
\s-1RATE\s0             generating data at \s-1RATE\s0 speed in B/s
\s-1TIME\s0             for \s-1TIME\s0 seconds (can be floating point number), last can
                   be omitted and that time will be infinite
.PP
Options \-b, \-c, \-R, \-s and \-t can use case insensitive unit multipliers and
specifiers:
  size (bytes):
    \-b and \-s argument without units is in bytes, can use [{k,m,g}]b (lower
    or upper case) for \s-1KB\s0, \s-1MB\s0 or \s-1GB\s0. {k,m,g} are powers of 1024.
  number:
    \-c argument is just a number, can have k, m or g added (powers of 1024),
    no unit needed
  rate (bytes pes second):
    \-R \s-1RATE\s0 is in B/s or Bps, the postfixes can be [{k,m,g}]{b/s,bps}
  time (seconds):
    \-t and \-R \s-1TIME\s0 argument is in seconds, can be postfixed with
    [{k,m,g}]{s,min,h,w,m,y}
.PP
Example:
  tcpblast \-b 4KB \-c 10k \-R 10kbps,2:20kbps,3s target
.PP
tcpblast version: FreeBSD + rzm 20001030
.SH "BUGS"
Rafal says that he is a perfectly bad and careless maintainer  :)
.PP
If You found any other bugs send it to him.
.SH "AUTHORS"
.Ip "Software: dfk@nic.eu.net (Daniel Karrenberg \- acc. to FreeBSD version)" 3
.Ip "Maintained by: Rafal Maszkowski <rzm@icm.edu.pl>" 3
.Ip "Manual page: Artur R. Czechowski <arturcz@bofh.org.pl>, Oct 1999; rzm, Oct 2000" 3

.rn }` ''
.IX Title "tcpblast 8"
.IX Name "tcpblast - tool for measuring network bandwidth"

.IX Header "NAME"

.IX Header "SYNOPSIS"

.IX Header "DESCRIPTION"

.IX Subsection "Options"

.IX Item "\fB\-4, --ipv4\fR           use only ipv4 address"

.IX Item "\fB\-6, --ipv6\fR           use only ipv6 address"

.IX Item "\fB\-a\fR                   send random data"

.IX Item "\fB\-b\fR \fI\s-1BUF_SIZE\s0\fR          socket buf size (default: \-1, don't change), with `\-\*(T' to be substracted from results"

.IX Item "\fB\-c, --count\fR \fI\s-1BLOCKS\s0\fR   change default (300) number of blocks, range: 1..10000000"

.IX Item "\fB\-d\fR \fI\s-1DOTFREQ\s0\fR           print dot every \s-1DOTFREQ\s0 blocks, disables cont. speed disp."

.IX Item "\fB\-h, --help\fR           this help"

.IX Item "\fB\-i, --delay\fR \fI\s-1DELAY\s0\fR    write delay in microseconds (\s-1EXPERIMENTAL\s0)"

.IX Item "\fB\-l, --last\fR \fI\s-1BLKS\s0\fR      show also speed for last \s-1BLKS\s0 blocks"

.IX Item "\fB\-m\fR                   results for every block in separate line"

.IX Item "\fB\-n, --nwrite\fR         do not write, use e.g. with chargen port"

.IX Item "\fB\-o\fR                   switch from continuous speed displaying to dots printing"

.IX Item "\fB\-p \s-1PORT\s0\fR              bind this local \s-1PORT\s0"

.IX Item "\fB\-q --quiet\fR           show only final statistics"

.IX Item "\fB\-r, --read\fR           read data returned to us, switches default port to echo"

.IX Item "\fB\-R, --rate\fR \fI\s-1RATESPEC\s0\fR  limit the speed according to the \s-1RATESPEC\s0"

.IX Item "\fB\-s\fR \fI\s-1BLOCK_SIZE\s0\fR        block size (default 1024 bytes)"

.IX Item "\fB\-t\fR \fI\s-1MAXTIME\s0\fR           limit time to \s-1MAXTIME\s0 (up to 42950 h)"

.IX Item "\fB    --tcp\fR            use \s-1TCP\s0 (default)"

.IX Item "\fB    --udp\fR            use \s-1UDP\s0 (default if named udpblast)"

.IX Item "\fB\-v, --verbosity\fR      verbosity, default 0, maximum 3. \-v adds time display, \-vv also speed in B/s, \-v \- speed in b/s."

.IX Item "\fB\-V\fR, \fB--version\fR        version"

.IX Item "\fIdestination\fR          host name or address"

.IX Item "\fIport\fR                 use port #/name xyz instead of default port 9"

.IX Header "BUGS"

.IX Header "AUTHORS"

.IX Item "Software: dfk@nic.eu.net (Daniel Karrenberg \- acc. to FreeBSD version)"

.IX Item "Maintained by: Rafal Maszkowski <rzm@icm.edu.pl>"

.IX Item "Manual page: Artur R. Czechowski <arturcz@bofh.org.pl>, Oct 1999; rzm, Oct 2000"