1#!/bin/bash 2# Copyright 2014 Cynthia Rempel <cynthia@rtems.org> 3# 4# Brief: Some cursery coverage tests of ifconfig... 5# Note: requires permissions to run modprobe and all ifconfig options 6# Commands used: grep, grep -i, ip link, ip tuntap, wc -l 7# 8# Possible improvements: 9# 1. Verify the dummy interface actually has the modified characteristics 10# instead of relying on ifconfig output 11# 2. Introduce more error cases, to verify ifconfig fails gracefully 12# 3. Do more complex calls to ifconfig, while mixing the order of the 13# arguments 14# 4. Cover more ifconfig options: 15# hw ether|infiniband ADDRESS - set LAN hardware address (AA:BB:CC...) 16# txqueuelen LEN - number of buffered packets before output blocks 17# Obsolete fields included for historical purposes: 18# irq|io_addr|mem_start ADDR - micromanage obsolete hardware 19# outfill|keepalive INTEGER - SLIP analog dialup line quality monitoring 20# metric INTEGER - added to Linux 0.9.10 with comment "never used", still true 21 22[ -f testing.sh ] && . testing.sh 23 24if [ "$(id -u)" -ne 0 ] 25then 26 echo "$SHOWSKIP: ifconfig (not root)" 27 return 2>/dev/null 28 exit 29fi 30 31#testing "name" "command" "result" "infile" "stdin" 32 33# Add a dummy interface to test with 34modprobe dummy 2>/dev/null 35if ! ifconfig dummy0 up 2>/dev/null 36then 37 echo "$SHOWSKIP: ifconfig dummy0 up failed" 38 return 2>/dev/null 39 exit 40fi 41 42# Test Description: Disable the dummy0 interface 43# Results Expected: After calling ifconfig, no lines with dummy0 are displayed 44testing "dummy0 down and if config /-only" \ 45"ifconfig dummy0 down && ifconfig | grep dummy | wc -l" \ 46"0\n" "" "" 47 48# Test Description: Enable the dummy0 interface 49# Results Expected: After calling ifconfig, one line with dummy0 is displayed 50testing "dummy0 up" \ 51"ifconfig dummy0 up && ifconfig dummy0 | grep dummy | wc -l" \ 52"1\n" "" "" 53 54# Test Description: Set the ip address of the dummy0 interface 55# Results Expected: After calling ifconfig dummy0, one line displays the ip 56# address selected 57testing "dummy0 10.240.240.240" \ 58"ifconfig dummy0 10.240.240.240 && ifconfig dummy0 | grep 10\.240\.240\.240 | wc -l" \ 59"1\n" "" "" 60 61# Test Description: Change the netmask to the interface 62# Results Expected: After calling ifconfig dummy0, one line displays the 63# netmask selected 64testing "dummy0 netmask 255.255.240.0" \ 65"ifconfig dummy0 netmask 255.255.240.0 && ifconfig dummy0 | grep 255\.255\.240\.0 | wc -l" \ 66"1\n" "" "" 67 68# Test Description: Change the broadcast address to the interface 69# Results Expected: After calling ifconfig dummy0, one line displays the 70# broadcast address selected 71testing "dummy0 broadcast 10.240.240.255" \ 72"ifconfig dummy0 broadcast 10.240.240.255 && ifconfig dummy0 | grep 10\.240\.240\.255 | wc -l" \ 73"1\n" "" "" 74 75# Test Description: Revert to the default ip address 76# Results Expected: After calling ifconfig dummy0, there are no lines 77# displaying the ip address previously selected 78testing "dummy0 default" \ 79"ifconfig dummy0 default && ifconfig dummy0 | grep 10\.240\.240\.240 | wc -l" \ 80"0\n" "" "" 81 82# Test Description: Change the Maximum transmission unit (MTU) of the interface 83# Results Expected: After calling ifconfig dummy0, there is one line with the 84# selected MTU 85testing "dummy0 mtu 1269" \ 86"ifconfig dummy0 mtu 1269 && ifconfig dummy0 | grep 1269 | wc -l" \ 87"1\n" "" "" 88 89# Test Description: ifconfig add for IPv6 fails with an mtu too small for IPv6. 90# Results Expected: Failure. No check for the exact error because old kernels 91# used ENOBUFS but 5.4 uses EINVAL. 92testing "dummy0 add ::2 -- too small mtu" \ 93"ifconfig dummy0 add ::2 2>/dev/null || echo expected" "expected\n" "" "" 94 95# Test Description: Change the Maximum transmission unit (MTU) of the interface 96# Results Expected: After calling ifconfig dummy0, there is one line with the 97# selected MTU 98testing "dummy0 mtu 2000" \ 99"ifconfig dummy0 mtu 2000 && ifconfig dummy0 | grep 2000 | wc -l" \ 100"1\n" "" "" 101 102# Test Description: Verify ifconfig add succeeds with a larger mtu 103# Results Expected: after calling ifconfig dummy0, there is one line with the 104# selected ip address 105testing "dummy0 add ::2" \ 106"ifconfig dummy0 add ::2/126 && ifconfig dummy0 | grep \:\:2/126 | wc -l" \ 107"1\n" "" "" 108 109# Test Description: Verify ifconfig del removes the selected ip6 address 110# Results Expected: after calling ifconfig dummy0, there are no lines with the 111# selected ip address 112testing "dummy0 del ::2" \ 113"ifconfig dummy0 del ::2/126 && ifconfig dummy0 | grep \:\:2/126 | wc -l" \ 114"0\n" "" "" 115 116# Test Description: Remove the noarp flag and bring the interface down in 117# preparation for the next test 118# Results Expected: After calling ifconfig dummy0, there are no lines with the 119# NOARP flag 120testing "dummy0 arp down" \ 121"ifconfig dummy0 arp down && ifconfig dummy0 | grep -i NOARP | wc -l" \ 122"0\n" "" "" 123 124# Test Description: Call the pointopoint option with no argument 125# Results Expected: After calling ifconfig dummy0, there is one line with the 126# NOARP and UP flags 127# TODO: http://lists.landley.net/pipermail/toybox-landley.net/2014-November/003795.html 128#testing "dummy0 pointopoint" \ 129#"ifconfig dummy0 pointopoint && ifconfig dummy0 | grep -i NOARP | grep -i UP | wc -l" \ 130#"1\n" "" "" 131 132# Test Description: Test the pointopoint option and set the ipaddress 133# Results Expected: After calling ifconfig dummy0, there is one line with the 134# word inet and the selected ip address 135# TODO: http://lists.landley.net/pipermail/toybox-landley.net/2014-November/003795.html 136#testing "dummy0 pointopoint 127.0.0.2" \ 137#"ifconfig dummy0 pointopoint 127.0.0.2 && ifconfig dummy0 | grep -i inet | grep -i 127\.0\.0\.2 | wc -l" \ 138#"1\n" "" "" 139 140####### Flags you can set on an interface (or -remove by prefixing with -): ############### 141 142# Test Description: Enable allmulti mode on the interface 143# Results Expected: After calling ifconfig dummy0, there is one line with the 144# allmulti flag 145testing "dummy0 allmulti" \ 146"ifconfig dummy0 allmulti && ifconfig dummy0 | grep -i allmulti | wc -l" "1\n" \ 147"" "" 148 149# Test Description: Disable multicast mode the interface 150# Results Expected: After calling ifconfig dummy0, there are no lines with the 151# allmulti flag 152testing "dummy0 -allmulti" \ 153"ifconfig dummy0 -allmulti && ifconfig dummy0 | grep -i allmulti | wc -l" "0\n" \ 154"" "" 155 156# Test Description: Disable NOARP mode on the interface 157# Results Expected: After calling ifconfig dummy0, there are no lines with the 158# NOARP flag 159testing "dummy0 arp" \ 160"ifconfig dummy0 arp && ifconfig dummy0 | grep -i NOARP | wc -l" "0\n" \ 161"" "" 162 163# Test Description: Enable NOARP mode on the interface 164# Results Expected: After calling ifconfig dummy0, there is one line with the 165# NOARP flag 166testing "dummy0 -arp" \ 167"ifconfig dummy0 -arp && ifconfig dummy0 | grep -i NOARP | wc -l" "1\n" \ 168"" "" 169 170# Test Description: Enable multicast mode on the interface 171# Results Expected: After calling ifconfig dummy0, there is one line with the 172# multicast flag 173testing "dummy0 multicast" \ 174"ifconfig dummy0 multicast && ifconfig dummy0 | grep -i multicast | wc -l" \ 175"1\n" "" "" 176 177# Test Description: Disable multicast mode the interface 178# Results Expected: After calling ifconfig dummy0, there are no lines with the 179# multicast flag 180testing "dummy0 -multicast" \ 181"ifconfig dummy0 -multicast && ifconfig dummy0 | grep -i multicast | wc -l" \ 182"0\n" "" "" 183 184# Test Description: Enable promiscuous mode the interface 185# Results Expected: After calling ifconfig dummy0, there is one line with the 186# promisc flag 187testing "dummy0 promisc" \ 188"ifconfig dummy0 promisc && ifconfig dummy0 | grep -i promisc | wc -l" "1\n" \ 189"" "" 190 191# Disable promiscuous mode the interface 192# Results Expected: After calling ifconfig dummy0, there are no lines with the 193# promisc flag 194testing "dummy0 -promisc" \ 195"ifconfig dummy0 -promisc && ifconfig dummy0 | grep -i promisc | wc -l" "0\n" \ 196"" "" 197 198# Disable the dummy interface 199ifconfig dummy0 down 200