...

• deviceIP : The IP address of the phone in the network shared by your PC. Normally this is an address of the type 10.42.0.x (replace the x with the correct number)

• gatewayIP : This is the IP address of your PC (which acts as a gateway) in the shared network. This can be found using the ifconfig command. Normally it is : 10.42.0.1

• networkInterface : The name of the network interface on the shared network. This can be found using the ifconfig command. You can also obtain it by typing the command sudo tcpdump -D. The network interface corresponding to the shared connection begins with "wl" (Wireless Lan) on Linux.

• keepPcap : If the boolean is set to true, the pcap file is saved at the end of the measurements.

• ipFilters : These are filters to remove certain network exchanges from the measurement. For measurements on iOS, set the "apple" boolean to true to filter IP addresses corresponding to 17.0.0.0/8 (Apple).

Launch of measures

Run the testrunner as usual:

...

If the tcpdump module has been activated in the job.yml file, the root password will be requested on Linux and Mac OS when the testrunner is initialised.

Add rights to run tcpdump without password on Linux [optional]

The procedure comes from this website : https://askubuntu.com/questions/530920/tcpdump-permissions-problem

• Create a pcap group and add yourself to it

sudo groupadd pcap
sudo usermod -a -G pcap $USER

• Change the group of tcpdump and set permissions. You may need to change the path by /usr/bin/tcpdump.

sudo chgrp pcap /usr/sbin/tcpdump
sudo chmod 750 /usr/sbin/tcpdump

• Use setcap to give tcpdump the necessary permissions

sudo setcap cap_net_raw,cap_net_admin=eip /usr/sbin/tcpdump

• Restart your PC. You should be able to run the tcpdump command without sudo.

Schema of situation

...