Davide Pesavento | 3f13f35 | 2021-05-21 20:53:35 -0400 | [diff] [blame] | 1 | # Testing NetworkMonitor functionality |
Davide Pesavento | 2bf35a6 | 2017-04-02 00:41:06 -0400 | [diff] [blame] | 2 | |
Davide Pesavento | 3f13f35 | 2021-05-21 20:53:35 -0400 | [diff] [blame] | 3 | > These instructions are only for Linux and macOS. |
Davide Pesavento | 2bf35a6 | 2017-04-02 00:41:06 -0400 | [diff] [blame] | 4 | |
Davide Pesavento | 394977c | 2020-04-25 21:40:31 -0400 | [diff] [blame] | 5 | Run the network-monitor integration test binary, e.g.: |
Davide Pesavento | 3f13f35 | 2021-05-21 20:53:35 -0400 | [diff] [blame] | 6 | |
| 7 | ```sh |
| 8 | # sudo not required |
Davide Pesavento | 394977c | 2020-04-25 21:40:31 -0400 | [diff] [blame] | 9 | ./build/tests/integration/network-monitor |
Davide Pesavento | 2bf35a6 | 2017-04-02 00:41:06 -0400 | [diff] [blame] | 10 | ``` |
Davide Pesavento | 2bf35a6 | 2017-04-02 00:41:06 -0400 | [diff] [blame] | 11 | |
| 12 | You should see an `onInterfaceAdded` message for each ethernet and loopback |
| 13 | network interface present on the system, followed by an `onAddressAdded` |
| 14 | message for each IPv4/IPv6 address on each interface. Finally, |
| 15 | `onEnumerationCompleted` is printed, along with a summary of all interfaces |
| 16 | discovered thus far. |
| 17 | |
Alexander Afanasyev | 3b3355c | 2017-03-26 11:57:13 -0500 | [diff] [blame] | 18 | ## Linux |
| 19 | |
Davide Pesavento | 3f13f35 | 2021-05-21 20:53:35 -0400 | [diff] [blame] | 20 | The following commands assume `eth0` is the name of an ethernet interface |
| 21 | on the machine. If your interfaces are named differently, replace `eth0` |
| 22 | with the name of any ethernet interface that you have available. |
Davide Pesavento | 2bf35a6 | 2017-04-02 00:41:06 -0400 | [diff] [blame] | 23 | |
| 24 | Command | Expected output |
| 25 | --------|---------------- |
| 26 | sudo ip link add link eth0 name nmtest0 type vlan id 42 | `nmtest0: onInterfaceAdded` |
| 27 | sudo ip link set dev nmtest0 mtu 1342 | `nmtest0: onMtuChanged <old_mtu> -> 1342` (`old_mtu` is most likely 1500) |
| 28 | sudo ip link set dev nmtest0 up | `nmtest0: onStateChanged down -> <new_state>` (`new_state` is one of: running, dormant, no-carrier) |
| 29 | sudo ip address add 198.51.100.100/24 dev nmtest0 | `nmtest0: onAddressAdded 198.51.100.100/24` |
| 30 | sudo ip address del 198.51.100.100/24 dev nmtest0 | `nmtest0: onAddressRemoved 198.51.100.100/24` |
| 31 | sudo ip address add 2001:db8::1/80 dev nmtest0 | `nmtest0: onAddressAdded 2001:db8::1/80` |
| 32 | sudo ip address del 2001:db8::1/80 dev nmtest0 | `nmtest0: onAddressRemoved 2001:db8::1/80` |
| 33 | sudo ip link delete dev nmtest0 | `nmtest0: onInterfaceRemoved` |
| 34 | |
| 35 | If you unplug the ethernet cable from your network card, you should see: |
Davide Pesavento | 3f13f35 | 2021-05-21 20:53:35 -0400 | [diff] [blame] | 36 | |
Davide Pesavento | 2bf35a6 | 2017-04-02 00:41:06 -0400 | [diff] [blame] | 37 | ``` |
| 38 | eth0: onStateChanged running -> no-carrier |
| 39 | nmtest0: onStateChanged running -> no-carrier |
| 40 | ``` |
| 41 | |
| 42 | Plugging the cable back in should produce the following messages: |
Davide Pesavento | 3f13f35 | 2021-05-21 20:53:35 -0400 | [diff] [blame] | 43 | |
Davide Pesavento | 2bf35a6 | 2017-04-02 00:41:06 -0400 | [diff] [blame] | 44 | ``` |
| 45 | eth0: onStateChanged no-carrier -> running |
| 46 | nmtest0: onStateChanged no-carrier -> running |
| 47 | ``` |
Alexander Afanasyev | 3b3355c | 2017-03-26 11:57:13 -0500 | [diff] [blame] | 48 | |
| 49 | ## macOS |
| 50 | |
Davide Pesavento | 3f13f35 | 2021-05-21 20:53:35 -0400 | [diff] [blame] | 51 | The following commands assume `en0` is the name of an ethernet interface |
| 52 | on the machine. If your interfaces are named differently, replace `en0` |
| 53 | with the name of any ethernet interface that you have available. |
Alexander Afanasyev | 3b3355c | 2017-03-26 11:57:13 -0500 | [diff] [blame] | 54 | |
| 55 | Command | Expected output |
| 56 | --------|---------------- |
| 57 | sudo ifconfig vlan1 create | `vlan1: onInterfaceAdded` |
| 58 | sudo ifconfig vlan1 vlan 1 vlandev en0 | `vlan1: onStateChanged down -> running` |
| 59 | sudo ifconfig vlan1 198.51.100.100/24 | `vlan1: onAddressAdded 198.51.100.100/24` |
| 60 | sudo ifconfig vlan1 198.51.100.100/24 remove | `vlan1: onAddressRemoved 198.51.100.100/24` |
| 61 | sudo ifconfig vlan1 inet6 2001:db8::1/80 | `vlan1: onAddressAdded 2001:db8::1/80` (and potentially link-local addresses) |
| 62 | sudo ifconfig vlan1 inet6 2001:db8::1/80 remove | `vlan1: onAddressRemoved 2001:db8::1/80` |
| 63 | sudo ifconfig vlan1 destroy | `vlan1: onInterfaceRemoved` |
| 64 | |
| 65 | If you unplug the ethernet cable from your network card, you should see: |
Davide Pesavento | 3f13f35 | 2021-05-21 20:53:35 -0400 | [diff] [blame] | 66 | |
Alexander Afanasyev | 3b3355c | 2017-03-26 11:57:13 -0500 | [diff] [blame] | 67 | ``` |
| 68 | en6: onStateChanged running -> down |
| 69 | ``` |
| 70 | |
| 71 | Plugging the cable back in should produce the following messages: |
Davide Pesavento | 3f13f35 | 2021-05-21 20:53:35 -0400 | [diff] [blame] | 72 | |
Alexander Afanasyev | 3b3355c | 2017-03-26 11:57:13 -0500 | [diff] [blame] | 73 | ``` |
| 74 | en6: onStateChanged down -> running |
| 75 | ``` |