tests/ifconfig.test

   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
  24 if [ "$(id -u)" -ne 0 ]
  25 then
  26   echo "$SHOWSKIP: ifconfig (not root)"
  27   continue 2>/dev/null
  28   exit
  29 fi
  30
  31 #testing "name" "command" "result" "infile" "stdin"
  32
  33 # Add a dummy interface to test with
  34 modprobe dummy 2>/dev/null
  35 if ! ifconfig dummy0 up 2>/dev/null
  36 then
  37   echo "$SHOWSKIP: ifconfig dummy0 up failed"
  38 fi
  39
  40 # Test Description: Disable the dummy0 interface
  41 # Results Expected: After calling ifconfig, no lines with dummy0 are displayed
  42 testing "dummy0 down and if config /-only" \
  43 "ifconfig dummy0 down && ifconfig | grep dummy | wc -l" \
  44 "0\n" "" ""
  45
  46 # Test Description: Enable the dummy0 interface
  47 # Results Expected: After calling ifconfig, one line with dummy0 is displayed
  48 testing "dummy0 up" \
  49 "ifconfig dummy0 up && ifconfig dummy0 | grep dummy | wc -l" \
  50 "1\n" "" ""
  51
  52 # Test Description: Set the ip address of the dummy0 interface
  53 # Results Expected: After calling ifconfig dummy0, one line displays the ip
  54 #                   address selected
  55 testing "dummy0 10.240.240.240" \
  56 "ifconfig dummy0 10.240.240.240 && ifconfig dummy0 | grep 10\.240\.240\.240 | wc -l" \
  57 "1\n" "" ""
  58
  59 # Test Description: Change the netmask to the interface
  60 # Results Expected: After calling ifconfig dummy0, one line displays the
  61 #                   netmask selected
  62 testing "dummy0 netmask 255.255.240.0" \
  63 "ifconfig dummy0 netmask 255.255.240.0 && ifconfig dummy0 | grep 255\.255\.240\.0 | wc -l" \
  64 "1\n" "" ""
  65
  66 # Test Description: Change the broadcast address to the interface
  67 # Results Expected: After calling ifconfig dummy0, one line displays the
  68 #                   broadcast address selected
  69 testing "dummy0 broadcast 10.240.240.255" \
  70 "ifconfig dummy0 broadcast 10.240.240.255 && ifconfig dummy0 | grep 10\.240\.240\.255 | wc -l" \
  71 "1\n" "" ""
  72
  73 # Test Description: Revert to the default ip address
  74 # Results Expected: After calling ifconfig dummy0, there are no lines
  75 #                   displaying the ip address previously selected
  76 testing "dummy0 default" \
  77 "ifconfig dummy0 default && ifconfig dummy0 | grep 10\.240\.240\.240 | wc -l" \
  78 "0\n" "" ""
  79
  80 # Test Description: Change the Maximum transmission unit (MTU) of the interface
  81 # Results Expected: After calling ifconfig dummy0, there is one line with the
  82 #                   selected MTU
  83 testing "dummy0 mtu 1269" \
  84 "ifconfig dummy0 mtu 1269 && ifconfig dummy0 | grep 1269 | wc -l" \
  85 "1\n" "" ""
  86
  87 # Test Description: Verify ifconfig add fails with such a small mtu
  88 # Results Expected: There is one line of error message containing
  89 #                   "No buffer space available"
  90 testing "dummy0 add ::2 -- too small mtu" \
  91 "ifconfig dummy0 add ::2 2>&1 | grep No\ buffer\ space\ available | wc -l" \
  92 "1\n" "" ""
  93
  94 # Test Description: Change the Maximum transmission unit (MTU) of the interface
  95 # Results Expected: After calling ifconfig dummy0, there is one line with the
  96 #                   selected MTU
  97 testing "dummy0 mtu 2000" \
  98 "ifconfig dummy0 mtu 2000 && ifconfig dummy0 | grep 2000 | wc -l" \
  99 "1\n" "" ""
 100
 101 # Test Description: Verify ifconfig add succeeds with a larger mtu
 102 # Results Expected: after calling ifconfig dummy0, there is one line with the
 103 #                   selected ip address
 104 testing "dummy0 add ::2" \
 105 "ifconfig dummy0 add ::2/126 && ifconfig dummy0 | grep \:\:2\/126 | wc -l" \
 106 "1\n" "" ""
 107
 108 # Test Description: Verify ifconfig del removes the selected ip6 address
 109 # Results Expected: after calling ifconfig dummy0, there are no lines with the
 110 #                   selected ip address
 111 testing "dummy0 del ::2" \
 112 "ifconfig dummy0 del ::2/126 && ifconfig dummy0 | grep \:\:2 | wc -l" \
 113 "0\n" "" ""
 114
 115 # Test Description: Remove the noarp flag and bring the interface down in
 116 #                   preparation for the next test
 117 # Results Expected: After calling ifconfig dummy0, there are no lines with the
 118 #                   NOARP flag
 119 testing "dummy0 arp down" \
 120 "ifconfig dummy0 arp down && ifconfig dummy0 | grep -i NOARP | wc -l" \
 121 "0\n" "" ""
 122
 123 # Test Description: Call the pointopoint option with no argument
 124 # Results Expected: After calling ifconfig dummy0, there is one line with the
 125 #                   NOARP and UP flags
 126 testing "dummy0 pointopoint" \
 127 "ifconfig dummy0 pointopoint && ifconfig dummy0 | grep -i NOARP | grep -i UP | wc -l" \
 128 "1\n" "" ""
 129
 130 # Test Description: Test the pointopoint option and set the ipaddress
 131 # Results Expected: After calling ifconfig dummy0, there is one line with the
 132 #                   word inet and the selected ip address
 133 testing "dummy0 pointopoint 127.0.0.2" \
 134 "ifconfig dummy0 pointopoint 127.0.0.2 && ifconfig dummy0 | grep -i inet | grep -i 127\.0\.0\.2 | wc -l" \
 135 "1\n" "" ""
 136
 137 ####### Flags you can set on an interface (or -remove by prefixing with -): ###############
 138
 139 # Test Description: Enable allmulti mode on the interface
 140 # Results Expected: After calling ifconfig dummy0, there is one line with the
 141 #                   allmulti flag
 142 testing "dummy0 allmulti" \
 143 "ifconfig dummy0 allmulti && ifconfig dummy0 | grep -i allmulti | wc -l" "1\n" \
 144 "" ""
 145
 146 # Test Description: Disable multicast mode the interface
 147 # Results Expected: After calling ifconfig dummy0, there are no lines with the
 148 #                   allmulti flag
 149 testing "dummy0 -allmulti" \
 150 "ifconfig dummy0 -allmulti && ifconfig dummy0 | grep -i allmulti | wc -l" "0\n" \
 151 "" ""
 152
 153 # Test Description: Disable NOARP mode on the interface
 154 # Results Expected: After calling ifconfig dummy0, there are no lines with the
 155 #                   NOARP flag
 156 testing "dummy0 arp" \
 157 "ifconfig dummy0 arp && ifconfig dummy0 | grep -i NOARP | wc -l" "0\n" \
 158 "" ""
 159
 160 # Test Description: Enable NOARP mode on the interface
 161 # Results Expected: After calling ifconfig dummy0, there is one line with the
 162 #                   NOARP flag
 163 testing "dummy0 -arp" \
 164 "ifconfig dummy0 -arp && ifconfig dummy0 | grep -i NOARP | wc -l" "1\n" \
 165 "" ""
 166
 167 # Test Description: Enable multicast mode on the interface
 168 # Results Expected: After calling ifconfig dummy0, there is one line with the
 169 #                   multicast flag
 170 testing "dummy0 multicast" \
 171 "ifconfig dummy0 multicast && ifconfig dummy0 | grep -i multicast | wc -l" \
 172 "1\n" "" ""
 173
 174 # Test Description: Disable multicast mode the interface
 175 # Results Expected: After calling ifconfig dummy0, there are no lines with the
 176 #                   multicast flag
 177 testing "dummy0 -multicast" \
 178 "ifconfig dummy0 -multicast && ifconfig dummy0 | grep -i multicast | wc -l" \
 179 "0\n" "" ""
 180
 181 # Test Description: Enable promiscuous mode the interface
 182 # Results Expected: After calling ifconfig dummy0, there is one line with the
 183 #                   promisc flag
 184 testing "dummy0 promisc" \
 185 "ifconfig dummy0 promisc && ifconfig dummy0 | grep -i promisc | wc -l" "1\n" \
 186 "" ""
 187
 188 # Disable promiscuous mode the interface
 189 # Results Expected: After calling ifconfig dummy0, there are no lines with the
 190 #                   promisc flag
 191 testing "dummy0 -promisc" \
 192 "ifconfig dummy0 -promisc && ifconfig dummy0 | grep -i promisc | wc -l" "0\n" \
 193 "" ""
 194
 195 # Disable the dummy interface
 196 ifconfig dummy0 down