-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
143 lines (102 loc) · 4.36 KB
/
INSTALL
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