src/functions/functions.bonding

   1 #!/bin/bash
   2 ###############################################################################
   3 #                                                                             #
   4 # IPFire.org - A linux based firewall                                         #
   5 # Copyright (C) 2010  Michael Tremer & Christian Schmidt                      #
   6 #                                                                             #
   7 # This program is free software: you can redistribute it and/or modify        #
   8 # it under the terms of the GNU General Public License as published by        #
   9 # the Free Software Foundation, either version 3 of the License, or           #
  10 # (at your option) any later version.                                         #
  11 #                                                                             #
  12 # This program is distributed in the hope that it will be useful,             #
  13 # but WITHOUT ANY WARRANTY; without even the implied warranty of              #
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               #
  15 # GNU General Public License for more details.                                #
  16 #                                                                             #
  17 # You should have received a copy of the GNU General Public License           #
  18 # along with this program.  If not, see <http://www.gnu.org/licenses/>.       #
  19 #                                                                             #
  20 ###############################################################################
  21
  22 BONDING_ALLOWED_MODES="balance-rr active-backup balance-xor broadcast 802.3ad \
  23         balance-tlb balance-alb"
  24 BONDING_MASTERS="/sys/class/net/bonding_masters"
  25 BONDING_PORT_PATTERN="bN"
  26
  27 bonding_create() {
  28         local device=${1}
  29         assert isset device
  30         shift
  31
  32         local address
  33         local mode="balance-rr"
  34
  35         while [ $# -gt 0 ]; do
  36                 case "${1}" in
  37                         --address=*)
  38                                 address=$(cli_get_val "${1}")
  39                                 ;;
  40                         --mode=*)
  41                                 mode=$(cli_get_val "${1}")
  42                                 ;;
  43                         *)
  44                                 error "Unrecognized argument: ${1}"
  45                                 return ${EXIT_ERROR}
  46                                 ;;
  47                 esac
  48                 shift
  49         done
  50
  51         if isset address; then
  52                 if ! ismac address; then
  53                         log ERROR "Invalid mac address: ${address}"
  54                         return ${EXIT_ERROR}
  55                 fi
  56         fi
  57
  58         if ! list_match "${mode}" ${BONDING_ALLOWED_MODES}; then
  59                 log ERROR "Bonding mode is not supported: ${mode}"
  60                 log ERROR "Valid modes are: ${BONDING_ALLOWED_MODES}"
  61                 return ${EXIT_ERROR}
  62         fi
  63
  64         # Load the kernel module
  65         module_load "bonding"
  66
  67         # Create the bonding device
  68         if cmd ip link add "${device}" address "${address}" \
  69                         type bond mode "${mode}"; then
  70                 log DEBUG "Successfully created bonding device '${device}'"
  71         else
  72                 log ERROR "Could not create bonding device '${device}'"
  73                 return ${EXIT_ERROR}
  74         fi
  75
  76         return ${EXIT_OK}
  77 }
  78
  79 bonding_remove() {
  80         local device=${1}
  81         assert isset device
  82
  83         # Remove the device.
  84         if device_delete "${device}"; then
  85                 log DEBUG "Successfully removed bonding device '${device}'"
  86         else
  87                 log ERROR "Could not remove bonding device '${device}'"
  88                 return ${EXIT_ERROR}
  89         fi
  90
  91         return ${EXIT_OK}
  92 }
  93
  94 bonding_get_mode() {
  95         local device=${1}
  96         assert isset device
  97
  98         local mode mode_num
  99         read mode mode_num < ${SYS_CLASS_NET}/${device}/bonding/mode
 100         print "${mode}"
 101 }
 102
 103 bonding_set_mode() {
 104         assert [ $# -eq 2 ]
 105
 106         local device="${1}"
 107         local mode="${2}"
 108
 109         if fappend "${SYS_CLASS_NET}/${device}/bonding/mode" "${mode}"; then
 110                 log DEBUG "Set mode of bond '${device}' to '${mode}'"
 111         else
 112                 log ERROR "Could not set mode of bond '${device}' to '${mode}'"
 113                 return ${EXIT_ERROR}
 114         fi
 115
 116         return ${EXIT_OK}
 117 }
 118
 119 bonding_enslave_device() {
 120         local device=${1}
 121         assert isset device
 122
 123         local slave=${2}
 124         assert isset slave
 125
 126         shift 2
 127
 128         local slaves="$(bonding_get_slaves "${device}")"
 129         if list_match "${slave}" ${slaves}; then
 130                 log DEBUG "${slave} is already enslaved in ${device}"
 131                 return ${EXIT_OK}
 132         fi
 133
 134         # Slave must be down to be enslaved.
 135         if ! device_set_down "${slave}"; then
 136                 log ERROR "Cannot enslave '${slave}' because it cannot be set down."
 137                 return ${EXIT_ERROR}
 138         fi
 139
 140         # Add it
 141         if ! device_set_master "${slave}" "${device}"; then
 142                 log ERROR "Could not enslave '${slave}' to '${device}'"
 143                 return ${EXIT_ERROR}
 144         fi
 145
 146         log DEBUG "Successfully enslaved '${slave}' to '${device}'"
 147         return ${EXIT_OK}
 148 }
 149
 150 bonding_get_slaves() {
 151         local device=${1}
 152         assert isset device
 153         shift
 154
 155         local file="slaves"
 156         while [ $# -gt 0 ]; do
 157                 case "${1}" in
 158                         --active)
 159                                 file="active_slave"
 160                                 ;;
 161                         *)
 162                                 error "Unrecognized argument: ${1}"
 163                                 return ${EXIT_ERROR}
 164                                 ;;
 165                 esac
 166                 shift
 167         done
 168
 169         fread ${SYS_CLASS_NET}/${device}/bonding/${file}
 170
 171         return ${EXIT_OK}
 172 }
 173
 174 bonding_get_lacp_rate() {
 175         local device=${1}
 176         assert isset device
 177
 178         local rate rateno
 179         read -r rate rateno \
 180                 < ${SYS_CLASS_NET}/${device}/bonding/lacp_rate
 181
 182         print "${rate}"
 183         return ${EXIT_OK}
 184 }
 185
 186 bonding_get_miimon() {
 187         local device=${1}
 188         assert isset device
 189
 190         fread ${SYS_CLASS_NET}/${device}/bonding/miimon
 191 }
 192
 193 bonding_set_miimon() {
 194         local device=${1}
 195         assert isset device
 196
 197         local miimon=${2}
 198         assert isset miimon
 199
 200         print "${miimon}" > ${SYS_CLASS_NET}/${device}/bonding/miimon
 201 }
 202
 203 bonding_slave_get_master() {
 204         local slave=${1}
 205         assert isset slave
 206
 207         device_is_bonded ${slave} || return ${EXIT_ERROR}
 208
 209         local master=$(fread ${SYS_CLASS_NET}/${slave}/master/ifindex)
 210         if isset master; then
 211                 device_ifindex_to_name ${master}
 212                 return ${EXIT_OK}
 213         fi
 214
 215         return ${EXIT_ERROR}
 216 }