"Fossies" - the Fresh Open Source Software Archive

Member "bwping-1.17/README" (18 Apr 2020, 3350 Bytes) of package /linux/privat/bwping-1.17.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "README": 1.16_vs_1.17.

    1 bwping(8)                   System Manager's Manual                  bwping(8)
    2 
    3 NAME
    4        bwping  and  bwping6  are tools to measure bandwidth and response times
    5        between two hosts using Internet Control Message Protocol  (ICMP)  echo
    6        request/echo reply mechanism.
    7 
    8 SYNOPSIS
    9        bwping [ -4 | -6 ] [ -u buf_size ] [ -r reporting_period ] [ -T tos(v4)
   10        | traf_class(v6) ] [ -B bind_addr ]  -b  kbps  -s  pkt_size  -v  volume
   11        target
   12 
   13        bwping6  [  -4  |  -6  ]  [  -u buf_size ] [ -r reporting_period ] [ -T
   14        tos(v4) | traf_class(v6) ] [ -B bind_addr ]  -b  kbps  -s  pkt_size  -v
   15        volume target
   16 
   17 OPTIONS
   18        -4   Forces IPv4 mode. Default mode of operation is IPv4 for bwping and
   19             IPv6 for bwping6 otherwise.
   20 
   21        -6   Forces IPv6 mode. Default mode of operation is IPv4 for bwping and
   22             IPv6 for bwping6 otherwise.
   23 
   24        -u buf_size
   25             Sets  the send/receive buffer size in bytes. Default value will be
   26             automatically calculated based on transfer speed, packet size  and
   27             host timer accuracy.
   28 
   29        -r reporting_period
   30             Sets the interval time in seconds between periodic bandwidth, RTT,
   31             and loss reports. If zero,  there  will  be  no  periodic  reports
   32             (default).
   33 
   34        -T tos(v4) | traf_class(v6)
   35             Sets  the TOS (in IPv4 mode) or Traffic Class (in IPv6 mode) value
   36             of outgoing ip packets. Default value is zero.
   37 
   38        -B bind_addr
   39             Sets the source address of outgoing ip  packets.  By  default  the
   40             address of the outgoing interface will be used.
   41 
   42        -b kbps
   43             Sets the transfer speed in kilobits per second.
   44 
   45        -s pkt_size
   46             Sets  the  size  of  ICMP  packet  (excluding IPv4/IPv6 header) in
   47             bytes.
   48 
   49        -v volume
   50             Sets the volume to transfer in bytes.
   51 
   52 AUTHORS
   53        Oleg Derevenetz <oleg.derevenetz@gmail.com>
   54 
   55 BUGS
   56        None known.
   57 
   58 NOTES
   59        This utility uses raw sockets to deal with ICMP  messages,  so  it  may
   60        require  root  privileges or extended capabilities (such as CAP_NET_RAW
   61        on Linux) to run. It can also be run as setuid root.
   62 
   63        Although bwping and bwping6 does not require any  special  software  on
   64        the  remote  host  (only  the  ability  to respond on ICMP echo request
   65        messages),   there   are   some   special   requirements   to   network
   66        infrastructure, local and remote host performance:
   67 
   68        1. There should be no ICMP echo request/reply filtering on the network.
   69        This includes QoS mechanisms (which often affects ICMP) at any point in
   70        the testing path;
   71 
   72        2.  Local  host  should  have  enough  CPU  resources to send ICMP echo
   73        request messages with  given  rate,  and  remote  host  should  quickly
   74        respond  on  these  messages and should have no ICMP bandwidth limiting
   75        turned on.
   76 
   77        If some of these requirements are not satisfied  then  the  measurement
   78        results  will be inadequate or fail completely. In general, for testing
   79        bandwidth where QoS is  implemented,  always  test  with  traffic  that
   80        matches the QoS class to be tested.
   81 
   82 SEE ALSO
   83        netstat(1), ping(8)
   84 
   85                                                                      bwping(8)