xref: /aosp_15_r20/external/iperf3/docs/index.rst (revision 7ab6e6ace082586527a400463bc693a412a40341)
1.. iperf documentation master file, created by
2   sphinx-quickstart on Fri Mar 28 14:58:40 2014.
3   You can adapt this file completely to your liking, but it should at least
4   contain the root `toctree` directive.
5
6iperf3
7======
8
9The iperf series of tools perform active measurements to determine the
10maximum achievable bandwidth on IP networks.  It supports tuning of
11various parameters related to timing, protocols, and buffers.  For
12each test it reports the measured throughput, loss, and other
13parameters.
14
15This version, sometimes referred to as iperf3, is a redesign of an
16original version developed at NLANR / DAST.  iperf3 is a new
17implementation from scratch, with the goal of a smaller, simpler code
18base, and a library version of the functionality that can be used in
19other programs. iperf3 also incorporates a number of features found in
20other tools such as nuttcp and netperf, but were missing from the
21original iperf.  These include, for example, a zero-copy mode and
22optional JSON output.  Note that iperf3 is *not* backwards compatible
23with the original iperf.
24
25Primary development for iperf3 takes place on CentOS Linux, FreeBSD,
26and macOS.  At this time, these are the only officially
27supported platforms, however there have been some reports of success
28with OpenBSD, Android, and other Linux distributions.
29
30iperf3 is principally developed by `ESnet <http://www.es.net/>`_ /
31`Lawrence Berkeley National Laboratory <http://www.lbl.gov/>`_.  It
32is released under a three-clause BSD license.
33
34iperf2 is no longer being developed by its original maintainers.
35However, beginning in 2014, another developer began fixing bugs and
36enhancing functionality, and generating releases of iperf2.  Both
37projects (as of late 2017) are currently being developed actively, but
38independently.  More information can be found in the :ref:`faq`.
39
40Links for the Impatient
41-----------------------
42
43Project homepage and documentation hosted on GitHub Pages:
44https://software.es.net/iperf/
45
46Project site (source code repository, issue tracker) hosted on GitHub:
47https://github.com/esnet/iperf
48
49Source code downloads:
50https://downloads.es.net/pub/iperf/
51
52Contents
53--------
54
55.. toctree::
56   :maxdepth: 2
57
58   news
59   obtaining
60   building
61   invoking
62   dev
63   faq
64
65Indices and tables
66------------------
67
68* :ref:`genindex`
69* :ref:`modindex`
70* :ref:`search`
71
72