summaryrefslogtreecommitdiffstats
path: root/INSTALL
blob: 244ca60586f3f4ea1b15aaa7c16ce9790583b386 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
$Id: INSTALL,v 1.1.1.1 2004/05/18 01:50:44 kgibbs Exp $

Briefly:

Do one-time if needed, e.g. for systems with dnf
  dnf install gcc
  dnf install gcc-c++
  dnf install make
  dnf install automake

then to build do:
  ./configure      -- configure for your machine
  make             -- compile Iperf
  make install     -- install Iperf, if desired, from root

and to use:
  iperf -s               (on machine "foo.bar.edu")
  iperf -c foo.bar.edu   (on some other machine)
  iperf -h               (for help screen)
  iperf -v               (for version information)


Platform Specific Notes

FreeBSD

  If you use a cc or c++ other than the system one, threads may not be
  detected properly.  To work around this set the following environment
  variables:

    setenv CC /usr/bin/cc
    setenv CXX /usr/bin/c++

---

Windows (cross compile from Linux)

# dnf install mingw32-gcc mingw32-gcc-c++ mingw32-winpthreads-static

$ ../iperf2-code/configure --host=i686-w64-mingw32
$ make

---

Windows (Cygwin)

  configure / make as normal:

  $ ../iperf2-code/configure
  $ make

  The result requires Cygwin on client machines.

---

Windows (Cygwin + i686-w64-mingw32)

  Use Cygwin Setup to install i686-w64-mingw32 and related packages

  Configure as a cross-compile:

  $ ../iperf2-code/configure -host i686-w64-mingw32
  $ make

  The result runs natively on WinXP and above without requiring Cygwin

---

Windows (MinGW + Msys)

  Install MinGW+Msys
  	  https://sourceforge.net/projects/mingw/
	  http://www.mingw.org/wiki/MinGW
	  http://www.mingw.org/wiki/MSYS

  configure / make as normal:

  $ ../iperf2-code/configure
  $ make

  The result runs natively on WinXP and above without requiring
  MinGW+Msys on client machines.

---

OpenWRT cross compile (example only)

  Setup buildroot (not fully described here, link https://electrosome.com/cross-compile-openwrt-c-program/)
      determine the target environment from the openwrt banner (this example is openwrt)
      get the build environment, e.g. git clone https://github.com/openwrt/openwrt.git
      update feeds
          $ ./scripts/feeds update -a
	  $ ./scripts/feeds install -a
      configure target
          $ make menuconfig
      Then select Target System, Subtarget and Target Profile as per your target environment, e.g.
          Target System: MediaTek Ralink MIPS
	  Subtarget system: MT7620 based boards
	  Target profile: NETGEAR R6350

  Set environment variables (via any editor or manual exports to get)
      [rjmcmahon@localhost iperf2-code]$ more ../openwrt.config
      export STAGING_DIR=/home/usernmae/Code/openwrt/staging_dir
      export TOOLCHAIN_DIR=$STAGING_DIR/toolchain-mipsel_24kc_gcc-8.4.0_musl (this is target dependent)
      export LDCFLAGS=$TOOLCHAIN_DIR/usr/lib
      export LD_LIBRARY_PATH=$TOOLCHAIN_DIR/usr/lib
      export PATH=$TOOLCHAIN_DIR/bin:$PATH
      $ source ../openwrt.config

  Download iperf 2 source
      $ cd iperf2-code
  Run configure, e.g. (replace /home/rjmcmahon/Code with your directory)
      $ ./configure --target=mips-buildroot-linux-gnu --host=mips-buildroot-linux-gnu CC=/home/rjmcmahon/Code/openwrt/staging_dir/toolchain-mipsel_24kc_gcc-8.4.0_musl/bin/mipsel-openwrt-linux-gcc CXX=/home/rjmcmahon/Code/openwrt/staging_dir/toolchain-mipsel_24kc_gcc-8.4.0_musl/bin/mipsel-openwrt-linux-g++

  Cross compile (binary in the src/ directory)
      $ make

  Install iperf and shared libraries onto openwrt device
      ssh into openwrt device, $ opkg install libstdcpp
      $ scp src/iperf user@host:/usr/bin

---
Other configure and compile options

      ./configure --enable-debuginfo - enable asserts
      ./configure --enable-thread-debug - enable thread level debugging
      ./configure --enable-summing-debug - enable summing level debugging
      ./configure --enable-packet-debug - show packet sequence numbers - very chatty
      ./configure --enable-fastsampling - sub millisecond timestamping
      ./configure --enable-checkprograms - compile supplmentary test programs
      ./configure --disable-ipv6
      ./configure --disable-multicast
      ./configure --disable-threads
      ./configure --disable-write-select
      ./configure --enable-debug-symbols - enable debugging with symbols
      ./configure --enable-default-localonly - limit test traffic to the local network (off by default)
---

dnf installs needed for build:

       dnf install gcc
       dnf install gcc-c++
       dnf install automake