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