[people/ms/network.git] / src / functions / functions.device

#!/bin/bash
###############################################################################
#                                                                             #
# IPFire.org - A linux based firewall                                         #
# Copyright (C) 2010  Michael Tremer & Christian Schmidt                      #
#                                                                             #
# This program is free software: you can redistribute it and/or modify        #
# it under the terms of the GNU General Public License as published by        #
# the Free Software Foundation, either version 3 of the License, or           #
# (at your option) any later version.                                         #
#                                                                             #
# This program is distributed in the hope that it will be useful,             #
# but WITHOUT ANY WARRANTY; without even the implied warranty of              #
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               #
# GNU General Public License for more details.                                #
#                                                                             #
# You should have received a copy of the GNU General Public License           #
# along with this program.  If not, see <http://www.gnu.org/licenses/>.       #
#                                                                             #
###############################################################################

function devicify() {
	local device=${1}

	assert isset device

	if device_exists ${device}; then
		echo "${device}"
		return ${EXIT_OK}
	fi

	local d
	for d in $(devices_get_all); do
		if [ "$(device_get_address ${d})" = "${device}" ]; then
			echo "${d}"
			return ${EXIT_OK}
		fi
	done

	return ${EXIT_ERROR}
}

function macify() {
	local device=${1}

	assert isset device

	if mac_is_valid ${device}; then
		echo "${device}"
		return ${EXIT_OK}
	fi

	if device_exists ${device}; then
		device_get_address ${device}
		return ${EXIT_OK}
	fi

	return ${EXIT_ERROR}
}

# Check if the device exists
function device_exists() {
	local device=${1}

	# If device name was not found, exit.
	[ -n "${device}" ] || return ${EXIT_ERROR}

	# Check for a normal network device.
	[ -d "${SYS_CLASS_NET}/${device}" ] && return ${EXIT_OK}

	# If the check above, did not find a result,
	# we check for serial devices.
	serial_exists ${device}
}

function device_matches_pattern() {
	local device="${1}"
	assert isset device

	local pattern="${2}"
	assert isset pattern

	pattern="^${pattern//N/[[:digit:]]+}$"

	[[ ${device} =~ ${pattern} ]] \
		&& return ${EXIT_TRUE} || return ${EXIT_FALSE}
}

function device_delete() {
	local device=${1}
	assert isset device

	# Nothing to do, it device does not exist.
	device_exists ${device} || return ${EXIT_OK}

	# Delete the device.
	cmd_quiet ip link delete ${device}
	local ret=$?

	if [ ${ret} -ne ${EXIT_OK} ]; then
		log ERROR "device: Could not delete device '${device}': ${ret}"
		return ${EXIT_ERROR}
	fi

	return ${ret}
}

function device_has_flag() {
	local device=${1}
	local flag=${2}

	local flags=$(__device_get_file ${device} flags)

	if [[ "$(( ${flags} & ${flag} ))" -eq 0 ]]; then
		return ${EXIT_FALSE}
	else
		return ${EXIT_TRUE}
	fi
}

# Check if the device is up
function device_is_up() {
	local device=${1}

	device_exists ${device} || return ${EXIT_ERROR}

	device_has_flag ${device} 0x1
}

function device_ifindex_to_name() {
	local idx=${1}
	assert isset idx

	local device device_idx
	for device in ${SYS_CLASS_NET}/*; do
		device=$(basename ${device})
		device_exists ${device} || continue

		device_idx=$(device_get_ifindex ${device})

		if [ "${device_idx}" = "${idx}" ]; then
			print "${device}"
			return ${EXIT_OK}
		fi
	done

	return ${EXIT_ERROR}
}

function device_get_ifindex() {
	local device=${1}
	assert isset device

	local path="${SYS_CLASS_NET}/${1}/ifindex"

	# Check if file can be read.
	[ -r "${path}" ] || return ${EXIT_ERROR}

	print "$(<${path})"
}

# Check if the device is a batman-adv bridge
function device_is_batman_adv() {
	[ -d "${SYS_CLASS_NET}/${1}/mesh" ]
}

# Check if the device is a batman-adv slave port
function device_is_batman_adv_slave() {
	local device="${1}"

	if [ -d "${SYS_CLASS_NET}/${device}/batman_adv" ]; then
		local status="$(<${SYS_CLASS_NET}/${device}/batman_adv/iface_status)"

		case "${status}" in
			"active")
				return ${EXIT_TRUE}
				;;
			*)
				return ${EXIT_FALSE}
				;;
		esac
	fi

	return ${EXIT_FALSE}
}

# Check if the device is a bonding device
function device_is_bonding() {
	[ -d "/sys/class/net/${1}/bonding" ]
}

# Check if the device bonded in a bonding device
function device_is_bonded() {
	local device=${1}

	[ -d "${SYS_CLASS_NET}/${device}/bonding_slave" ]
}

# Check if the device is a bridge
function device_is_bridge() {
	[ -d "/sys/class/net/${1}/bridge" ]
}

function device_is_bridge_attached() {
	local device=${1}
	[ -d "${SYS_CLASS_NET}/${device}/brport" ]
}

function device_is_wireless_monitor() {
	local device="${1}"
	assert isset device

	device_is_wireless "${device}" && \
		device_matches_pattern "${device}" "${PORT_PATTERN_WIRELESS_MONITOR}"
}

function device_is_wireless_adhoc() {
	local device="${1}"
	assert isset device

	device_is_wireless "${device}" && \
		device_matches_pattern "${device}" "${PORT_PATTERN_WIRELESS_ADHOC}"
}

function device_get_bridge() {
	local device=${1}
	assert isset device

	# Check if device is attached to a bridge.
	device_is_bridge_attached ${device} || return ${EXIT_ERROR}

	local ifindex_path="${SYS_CLASS_NET}/${device}/brport/bridge/ifindex"
	[ -r "${ifindex_path}" ] || return ${EXIT_ERROR}

	local ifindex=$(<${ifindex_path})
	assert isset ifindex

	device_ifindex_to_name ${ifindex}
}

# Check if the device is a vlan device
function device_is_vlan() {
	local device=${1}
	assert isset device

	[ -e "${PROC_NET_VLAN}/${device}" ]
}

# Check if the device has vlan devices
function device_has_vlans() {
	local device=${1}
	assert isset device

	if device_is_vlan ${device}; then
		return ${EXIT_FALSE}
	fi

	local vlans=$(device_get_vlans ${device})
	[ -n "${vlans}" ] && return ${EXIT_OK} || return ${EXIT_ERROR}
}

function device_get_vlans() {
	local device=${1}
	assert isset device

	# If no 8021q module has been loaded into the kernel,
	# we cannot do anything.
	[ -r "${PROC_NET_VLAN_CONFIG}" ] || return ${EXIT_OK}

	local dev spacer1 id spacer2 parent
	while read dev spacer1 id spacer2 parent; do
		[ "${parent}" = "${device}" ] || continue

		print "${dev}"
	done < ${PROC_NET_VLAN_CONFIG}
}

# Check if the device is a ppp device
function device_is_ppp() {
	local device=${1}

	local type=$(__device_get_file ${device} type)

	[ "${type}" = "512" ] && return ${EXIT_OK} || return ${EXIT_ERROR}
}

# Check if the device is a pointopoint device.
function device_is_ptp() {
	local device=${1}

	device_has_flag ${device} 0x10
}

# Check if the device is a loopback device
function device_is_loopback() {
	local device=${1}

	[ "${device}" = "lo" ]
}

# Check if the device is a wireless device
function device_is_wireless() {
	local device=${1}

	[ -d "${SYS_CLASS_NET}/${device}/phy80211" ]
}

function device_get_phy() {
	local device="${1}"

	if device_is_wireless "${device}"; then
		print "$(<${SYS_CLASS_NET}/${device}/phy80211/name)"
		return ${EXIT_OK}
	fi

	return ${EXIT_ERROR}
}

function device_is_serial() {
	serial_exists $@
}

# Check if the device is a physical network interface
function device_is_ethernet() {
	local device=${1}

	device_is_loopback ${device} && \
		return ${EXIT_ERROR}

	device_is_bonding ${device} &&  \
		return ${EXIT_ERROR}

	device_is_bridge ${device} && \
		return ${EXIT_ERROR}

	device_is_ppp ${device} && \
		return ${EXIT_ERROR}

	device_is_vlan ${device} && \
		return ${EXIT_ERROR}

	[ "$(__device_get_file ${device} type)" != "1" ] && \
		return ${EXIT_ERROR}

	return ${EXIT_OK}
}

# Get the device type
function device_get_type() {
	local device=${1}

	# If the device does not exist (happens on udev remove events),
	# we do not bother to run all checks.
	if ! device_exists "${device}"; then
		echo "unknown"

	elif device_is_vlan ${device}; then
		echo "vlan"

	elif device_is_bonding ${device}; then
		echo "bonding"

	elif device_is_bridge ${device}; then
		echo "bridge"

	elif device_is_ppp ${device}; then
		echo "ppp"

	elif device_is_batman_adv ${device}; then
		echo "batman-adv"

	elif device_is_loopback ${device}; then
		echo "loopback"

	elif device_is_wireless_adhoc ${device}; then
		echo "wireless-adhoc"

	elif device_is_wireless ${device}; then
		echo "wireless"

	elif device_is_ethernet ${device}; then
		echo "ethernet"

	elif device_is_serial ${device}; then
		echo "serial"

	else
		echo "unknown"
	fi
}

function device_is_ethernet_compatible() {
	local device="${1}"

	# /sys/class/net/*/type must equal 1 for ethernet compatible devices
	local type="$(__device_get_file "${device}" "type")"
	[[ "${type}" = "1" ]]
}

function device_get_status() {
	local device=${1}
	assert isset device

	local status=${STATUS_DOWN}

	if device_is_up ${device}; then
		status=${STATUS_UP}

		if ! device_has_carrier ${device}; then
			status=${STATUS_NOCARRIER}
		fi
	fi

	echo "${status}"
}

function device_get_address() {
	local device=${1}

	cat ${SYS_CLASS_NET}/${device}/address 2>/dev/null
}

function device_set_address() {
	assert [ $# -eq 2 ]

	local device="${1}"
	local addr="${2}"
	
	if ! device_exists "${device}"; then
		error "Device '${device}' does not exist."
		return ${EXIT_ERROR}
	fi

	# Do nothing if the address has not changed
	local old_addr="$(device_get_address "${device}")"
	if [ -n "${old_addr}" -a "${addr}" = "${old_addr}" ]; then
		return ${EXIT_OK}
	fi

	log DEBUG "Setting address of '${device}' from '${old_addr}' to '${addr}'"

	local up
	if device_is_up "${device}"; then
		device_set_down "${device}"
		up=1
	fi

	ip link set "${device}" address "${addr}"
	local ret=$?

	if [ "${up}" = "1" ]; then
		device_set_up "${device}"
	fi

	if [ "${ret}" != "0" ]; then
		error_log "Could not set address '${addr}' on device '${device}'"
	fi

	return ${ret}
}

function device_get() {
	local device
	local devices

	for device in ${SYS_CLASS_NET}/*; do
		device=$(basename ${device})

		# bonding_masters is no device
		[ "${device}" = "bonding_masters" ] && continue

		devices="${devices} ${device}"
	done

	echo ${devices}
	return ${EXIT_OK}
}

function devices_get_all() {
	device_get
}

# Check if a device has a cable plugged in
function device_has_carrier() {
	local device=${1}
	assert isset device

	local carrier=$(__device_get_file ${device} carrier)
	[ "${carrier}" = "1" ]
}

function device_is_promisc() {
	local device=${1}

	device_has_flag ${device} 0x200
}

function device_set_promisc() {
	local device=${1}
	local state=${2}

	assert device_exists ${device}
	assert isset state
	assert isoneof state on off

	ip link set ${device} promisc ${state}
}

# Check if the device is free
function device_is_free() {
	! device_is_used $@
}

# Check if the device is used
function device_is_used() {
	local device=${1}

	device_has_vlans ${device} && \
		return ${EXIT_OK}
	device_is_bonded ${device} && \
		return ${EXIT_OK}
	device_is_bridge_attached ${device} && \
		return ${EXIT_OK}

	return ${EXIT_ERROR}
}

function device_hash() {
	local device=${1}

	# Get mac address of device and remove all colons (:)
	# that will result in a hash.
	device=$(macify ${device})

	echo "${device//:/}"
}

# Give the device a new name
function device_set_name() {
	local source=$1
	local destination=${2}

	# Check if devices exists
	if ! device_exists ${source} || device_exists ${destination}; then
		return 4
	fi

	local up
	if device_is_up ${source}; then
		ip link set ${source} down
		up=1
	fi

	ip link set ${source} name ${destination}

	if [ "${up}" = "1" ]; then
		ip link set ${destination} up
	fi
}

# Set device up
function device_set_up() {
	local device=${1}

	# Silently fail if device was not found
	[ -z "${device}" ] && return ${EXIT_ERROR}

	# Do nothing if device is already up
	device_is_up ${device} && return ${EXIT_OK}

	device_set_parent_up ${device}

	log DEBUG "Setting up device '${device}'"

	ip link set ${device} up
}

function device_set_parent_up() {
	local device=${1}
	local parent

	if device_is_vlan ${device}; then
		parent=$(vlan_get_parent ${device})

		device_is_up ${parent} && return ${EXIT_OK}

		log DEBUG "Setting up parent device '${parent}' of '${device}'"

		device_set_up ${parent}
		return $?
	fi

	return ${EXIT_OK}
}

# Set device down
function device_set_down() {
	local device=${1}
	assert isset device

	local ret=${EXIT_OK}

	if device_is_up ${device}; then
		log DEBUG "Tearing down device '${device}'"

		ip link set ${device} down
		ret=$?
	fi

	device_set_parent_down ${device}

	return ${ret}
}

function device_set_parent_down() {
	local device=${1}
	local parent

	if device_is_vlan ${device}; then
		parent=$(vlan_get_parent ${device})

		device_is_up ${parent} || return ${EXIT_OK}

		if device_is_free ${parent}; then
			log DEBUG "Tearing down parent device '${parent}' of '${device}'"

			device_set_down ${parent}
		fi
	fi
	
	return ${EXIT_OK}
}

function device_get_mtu() {
	local device=${1}

	if ! device_exists ${device}; then
		error "Device '${device}' does not exist."
		return ${EXIT_ERROR}
	fi

	echo $(<${SYS_CLASS_NET}/${device}/mtu)
}

# Set mtu to a device
function device_set_mtu() {
	local device=${1}
	local mtu=${2}

	if ! device_exists ${device}; then
		error "Device '${device}' does not exist."
		return ${EXIT_ERROR}
	fi
	
	local oldmtu=$(device_get_mtu ${device})

	if [ "${oldmtu}" = "${mtu}" ]; then
		# No need to set mtu.
		return ${EXIT_OK}
	fi

	log INFO "Setting mtu of '${device}' to '${mtu}' - was ${oldmtu}."

	local up
	if device_is_up ${device}; then
		device_set_down ${device}
		up=1
	fi

	ip link set ${device} mtu ${mtu}
	local ret=$?

	if [ "${up}" = "1" ]; then
		device_set_up ${device}
	fi

	if [ "${ret}" != "0" ]; then
		error_log "Could not set mtu '${mtu}' on device '${device}'."
	fi

	return ${ret}
}

function device_adjust_mtu() {
	assert [ $# -eq 2 ]

	local device="${1}"
	local other_device="${2}"

	local mtu="$(device_get_mtu "${other_device}")"
	device_set_mtu "${device}" "${mtu}"
}

function device_discover() {
	local device=${1}

	log INFO "Running discovery process on device '${device}'."

	local hook
	for hook in $(hook_zone_get_all); do
		hook_zone_exec ${hook} discover ${device}
	done
}

function device_has_ip() {
	local device=${1}
	local addr=${2}

	assert isset addr
	assert device_exists ${device}

	# IPv6 addresses must be fully imploded
	local protocol=$(ip_detect_protocol ${addr})
	case "${protocol}" in
		ipv6)
			addr=$(ipv6_implode ${addr})
			;;
	esac

	listmatch ${addr} $(device_get_addresses ${device})
}

function device_get_addresses() {
	local device=${1}

	assert device_exists ${device}

	local prot
	local addr
	local line
	ip addr show ${device} | \
		while read prot addr line; do
			[ "${prot:0:4}" = "inet" ] && echo "${addr}"
		done
}

function __device_get_file() {
	local device=${1}
	local file=${2}

	assert isset device
	assert isset file

	local path="${SYS_CLASS_NET}/${device}/${file}"
	[ -r "${path}" ] || return ${EXIT_ERROR}

	echo "$(<${path})"
}

function __device_set_file() {
	assert [ $# -eq 3 ]

	local device="${1}"
	local file="${2}"
	local value="${3}"

	local path="${SYS_CLASS_NET}/${device}/${file}"
	if [ ! -w "${path}" ]; then
		log DEBUG "Cannot write to file '${file}' (${value})"
		return ${EXIT_ERROR}
	fi

	echo "${value}" > "${path}"
}

function device_get_rx_bytes() {
	local device=${1}

	__device_get_file ${device} statistics/rx_bytes
}

function device_get_tx_bytes() {
	local device=${1}

	__device_get_file ${device} statistics/tx_bytes
}

function device_get_rx_packets() {
	local device=${1}

	__device_get_file ${device} statistics/rx_packets
}

function device_get_tx_packets() {
	local device=${1}

	__device_get_file ${device} statistics/tx_packets
}

function device_get_rx_errors() {
	local device=${1}

	__device_get_file ${device} statistics/rx_errors
}

function device_get_tx_errors() {
	local device=${1}

	__device_get_file ${device} statistics/tx_errors
}

function device_get_speed() {
	local device=${1}

	__device_get_file ${device} speed
}

function device_get_duplex() {
	local device=${1}

	__device_get_file ${device} duplex
}

function device_get_link_string() {
	local device="${1}"
	assert isset device

	local s

	local speed="$(device_get_speed "${device}")"
	if isset speed; then
		list_append s "${speed} MBit/s"
	fi

	local duplex="$(device_get_duplex "${device}")"
	if isset duplex; then
		list_append s "${duplex} duplex"
	fi

	print "${s}"
}
Commit	Line	Data
1848564d MT	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
1b7a1578	22	function devicify() {
1848564d MT	23	local device=${1}
1848564d MT	24
711ffac1 MT	25	assert isset device
711ffac1 MT	26
1848564d MT	27	if device_exists ${device}; then
	28	echo "${device}"
	29	return ${EXIT_OK}
	30	fi
	31
	32	local d
	33	for d in $(devices_get_all); do
	34	if [ "$(device_get_address ${d})" = "${device}" ]; then
	35	echo "${d}"
	36	return ${EXIT_OK}
	37	fi
	38	done
	39
	40	return ${EXIT_ERROR}
	41	}
	42
	43	function macify() {
	44	local device=${1}
	45
711ffac1 MT	46	assert isset device
711ffac1 MT	47
1848564d MT	48	if mac_is_valid ${device}; then
	49	echo "${device}"
	50	return ${EXIT_OK}
	51	fi
	52
	53	if device_exists ${device}; then
	54	device_get_address ${device}
	55	return ${EXIT_OK}
	56	fi
	57
	58	return ${EXIT_ERROR}
	59	}
	60
	61	# Check if the device exists
	62	function device_exists() {
	63	local device=${1}
	64
	65	# If device name was not found, exit.
	66	[ -n "${device}" ] \|\| return ${EXIT_ERROR}
	67
6c74a64c MT	68	# Check for a normal network device.
	69	[ -d "${SYS_CLASS_NET}/${device}" ] && return ${EXIT_OK}
	70
	71	# If the check above, did not find a result,
	72	# we check for serial devices.
	73	serial_exists ${device}
1848564d MT	74	}
1848564d MT	75
a23fdc0e MT	76	function device_matches_pattern() {
	77	local device="${1}"
	78	assert isset device
	79
	80	local pattern="${2}"
	81	assert isset pattern
	82
	83	pattern="^${pattern//N/[[:digit:]]+}$"
	84
	85	[[ ${device} =~ ${pattern} ]] \
	86	&& return ${EXIT_TRUE} \|\| return ${EXIT_FALSE}
	87	}
	88
99be6026 MT	89	function device_delete() {
	90	local device=${1}
	91	assert isset device
	92
	93	# Nothing to do, it device does not exist.
	94	device_exists ${device} \|\| return ${EXIT_OK}
	95
	96	# Delete the device.
	97	cmd_quiet ip link delete ${device}
	98	local ret=$?
	99
	100	if [ ${ret} -ne ${EXIT_OK} ]; then
	101	log ERROR "device: Could not delete device '${device}': ${ret}"
	102	return ${EXIT_ERROR}
	103	fi
	104
	105	return ${ret}
	106	}
	107
e369be1a MT	108	function device_has_flag() {
	109	local device=${1}
	110	local flag=${2}
	111
	112	local flags=$(__device_get_file ${device} flags)
	113
	114	if [[ "$(( ${flags} & ${flag} ))" -eq 0 ]]; then
	115	return ${EXIT_FALSE}
	116	else
	117	return ${EXIT_TRUE}
	118	fi
	119	}
	120
1848564d MT	121	# Check if the device is up
	122	function device_is_up() {
	123	local device=${1}
	124
	125	device_exists ${device} \|\| return ${EXIT_ERROR}
	126
e369be1a	127	device_has_flag ${device} 0x1
1848564d MT	128	}
1848564d MT	129
99be6026 MT	130	function device_ifindex_to_name() {
	131	local idx=${1}
	132	assert isset idx
	133
	134	local device device_idx
	135	for device in ${SYS_CLASS_NET}/*; do
	136	device=$(basename ${device})
	137	device_exists ${device} \|\| continue
	138
	139	device_idx=$(device_get_ifindex ${device})
	140
	141	if [ "${device_idx}" = "${idx}" ]; then
	142	print "${device}"
	143	return ${EXIT_OK}
	144	fi
	145	done
	146
	147	return ${EXIT_ERROR}
	148	}
	149
	150	function device_get_ifindex() {
	151	local device=${1}
	152	assert isset device
	153
	154	local path="${SYS_CLASS_NET}/${1}/ifindex"
	155
	156	# Check if file can be read.
	157	[ -r "${path}" ] \|\| return ${EXIT_ERROR}
	158
	159	print "$(<${path})"
	160	}
	161
e6993835 MT	162	# Check if the device is a batman-adv bridge
	163	function device_is_batman_adv() {
	164	[ -d "${SYS_CLASS_NET}/${1}/mesh" ]
	165	}
	166
b8026986 MT	167	# Check if the device is a batman-adv slave port
b8026986 MT	168	function device_is_batman_adv_slave() {
7b192cf4 MT	169	local device="${1}"
	170
	171	if [ -d "${SYS_CLASS_NET}/${device}/batman_adv" ]; then
	172	local status="$(<${SYS_CLASS_NET}/${device}/batman_adv/iface_status)"
	173
	174	case "${status}" in
	175	"active")
	176	return ${EXIT_TRUE}
	177	;;
	178	*)
	179	return ${EXIT_FALSE}
	180	;;
	181	esac
	182	fi
	183
	184	return ${EXIT_FALSE}
e6993835 MT	185	}
e6993835 MT	186
1848564d MT	187	# Check if the device is a bonding device
	188	function device_is_bonding() {
	189	[ -d "/sys/class/net/${1}/bonding" ]
	190	}
	191
	192	# Check if the device bonded in a bonding device
	193	function device_is_bonded() {
711ffac1	194	local device=${1}
1848564d	195
0959482b	196	[ -d "${SYS_CLASS_NET}/${device}/bonding_slave" ]
1848564d MT	197	}
	198
	199	# Check if the device is a bridge
	200	function device_is_bridge() {
	201	[ -d "/sys/class/net/${1}/bridge" ]
	202	}
	203
81ed640c MT	204	function device_is_bridge_attached() {
81ed640c MT	205	local device=${1}
81ed640c MT	206	[ -d "${SYS_CLASS_NET}/${device}/brport" ]
	207	}
	208
a23fdc0e MT	209	function device_is_wireless_monitor() {
	210	local device="${1}"
	211	assert isset device
	212
	213	device_is_wireless "${device}" && \
	214	device_matches_pattern "${device}" "${PORT_PATTERN_WIRELESS_MONITOR}"
	215	}
	216
b8026986 MT	217	function device_is_wireless_adhoc() {
	218	local device="${1}"
	219	assert isset device
	220
	221	device_is_wireless "${device}" && \
	222	device_matches_pattern "${device}" "${PORT_PATTERN_WIRELESS_ADHOC}"
	223	}
	224
99be6026 MT	225	function device_get_bridge() {
	226	local device=${1}
	227	assert isset device
	228
	229	# Check if device is attached to a bridge.
	230	device_is_bridge_attached ${device} \|\| return ${EXIT_ERROR}
	231
	232	local ifindex_path="${SYS_CLASS_NET}/${device}/brport/bridge/ifindex"
	233	[ -r "${ifindex_path}" ] \|\| return ${EXIT_ERROR}
	234
	235	local ifindex=$(<${ifindex_path})
	236	assert isset ifindex
	237
	238	device_ifindex_to_name ${ifindex}
	239	}
	240
7951525a MT	241	# Check if the device is a vlan device
7951525a MT	242	function device_is_vlan() {
1848564d	243	local device=${1}
7951525a	244	assert isset device
1848564d	245
7951525a	246	[ -e "${PROC_NET_VLAN}/${device}" ]
1848564d MT	247	}
1848564d MT	248
7951525a MT	249	# Check if the device has vlan devices
7951525a MT	250	function device_has_vlans() {
fb02e543	251	local device=${1}
7951525a	252	assert isset device
fb02e543	253
7951525a	254	if device_is_vlan ${device}; then
ec63256a	255	return ${EXIT_FALSE}
fb02e543 MT	256	fi
fb02e543 MT	257
7951525a MT	258	local vlans=$(device_get_vlans ${device})
7951525a MT	259	[ -n "${vlans}" ] && return ${EXIT_OK} \|\| return ${EXIT_ERROR}
ec63256a MT	260	}
ec63256a MT	261
7951525a	262	function device_get_vlans() {
ec63256a	263	local device=${1}
7951525a	264	assert isset device
ec63256a	265
8357a7ff MT	266	# If no 8021q module has been loaded into the kernel,
8357a7ff MT	267	# we cannot do anything.
7951525a	268	[ -r "${PROC_NET_VLAN_CONFIG}" ] \|\| return ${EXIT_OK}
8357a7ff	269
ec63256a MT	270	local dev spacer1 id spacer2 parent
ec63256a MT	271	while read dev spacer1 id spacer2 parent; do
7951525a MT	272	[ "${parent}" = "${device}" ] \|\| continue
	273
	274	print "${dev}"
	275	done < ${PROC_NET_VLAN_CONFIG}
1848564d MT	276	}
1848564d MT	277
1848564d MT	278	# Check if the device is a ppp device
	279	function device_is_ppp() {
	280	local device=${1}
	281
55b802cc	282	local type=$(__device_get_file ${device} type)
28f0b4ab	283
e369be1a MT	284	[ "${type}" = "512" ] && return ${EXIT_OK} \|\| return ${EXIT_ERROR}
e369be1a MT	285	}
55b802cc	286
e369be1a MT	287	# Check if the device is a pointopoint device.
	288	function device_is_ptp() {
	289	local device=${1}
	290
	291	device_has_flag ${device} 0x10
1848564d MT	292	}
	293
	294	# Check if the device is a loopback device
	295	function device_is_loopback() {
5bb2429a MT	296	local device=${1}
5bb2429a MT	297
1848564d MT	298	[ "${device}" = "lo" ]
	299	}
	300
a508c27e MT	301	# Check if the device is a wireless device
	302	function device_is_wireless() {
	303	local device=${1}
	304
	305	[ -d "${SYS_CLASS_NET}/${device}/phy80211" ]
	306	}
	307
4733a336 MT	308	function device_get_phy() {
	309	local device="${1}"
	310
	311	if device_is_wireless "${device}"; then
	312	print "$(<${SYS_CLASS_NET}/${device}/phy80211/name)"
	313	return ${EXIT_OK}
	314	fi
	315
	316	return ${EXIT_ERROR}
	317	}
	318
6c74a64c MT	319	function device_is_serial() {
	320	serial_exists $@
	321	}
	322
1848564d	323	# Check if the device is a physical network interface
ec63256a	324	function device_is_ethernet() {
1848564d MT	325	local device=${1}
	326
	327	device_is_loopback ${device} && \
	328	return ${EXIT_ERROR}
	329
	330	device_is_bonding ${device} && \
	331	return ${EXIT_ERROR}
	332
	333	device_is_bridge ${device} && \
	334	return ${EXIT_ERROR}
	335
	336	device_is_ppp ${device} && \
	337	return ${EXIT_ERROR}
	338
7951525a	339	device_is_vlan ${device} && \
1848564d MT	340	return ${EXIT_ERROR}
1848564d MT	341
419b4cd0 MT	342	[ "$(__device_get_file ${device} type)" != "1" ] && \
	343	return ${EXIT_ERROR}
	344
1848564d MT	345	return ${EXIT_OK}
	346	}
	347
	348	# Get the device type
	349	function device_get_type() {
5bb2429a	350	local device=${1}
1848564d	351
b9f27baf MT	352	# If the device does not exist (happens on udev remove events),
	353	# we do not bother to run all checks.
	354	if ! device_exists "${device}"; then
	355	echo "unknown"
	356
	357	elif device_is_vlan ${device}; then
1848564d MT	358	echo "vlan"
	359
	360	elif device_is_bonding ${device}; then
	361	echo "bonding"
	362
	363	elif device_is_bridge ${device}; then
	364	echo "bridge"
	365
	366	elif device_is_ppp ${device}; then
	367	echo "ppp"
	368
e6993835 MT	369	elif device_is_batman_adv ${device}; then
	370	echo "batman-adv"
	371
1848564d MT	372	elif device_is_loopback ${device}; then
	373	echo "loopback"
	374
b8026986 MT	375	elif device_is_wireless_adhoc ${device}; then
	376	echo "wireless-adhoc"
	377
a508c27e MT	378	elif device_is_wireless ${device}; then
	379	echo "wireless"
	380
ec63256a MT	381	elif device_is_ethernet ${device}; then
ec63256a MT	382	echo "ethernet"
1848564d	383
6c74a64c MT	384	elif device_is_serial ${device}; then
	385	echo "serial"
	386
1848564d MT	387	else
	388	echo "unknown"
	389	fi
	390	}
	391
a4f7ad26 MT	392	function device_is_ethernet_compatible() {
	393	local device="${1}"
	394
	395	# /sys/class/net/*/type must equal 1 for ethernet compatible devices
	396	local type="$(__device_get_file "${device}" "type")"
	397	[[ "${type}" = "1" ]]
	398	}
	399
711ffac1 MT	400	function device_get_status() {
711ffac1 MT	401	local device=${1}
711ffac1 MT	402	assert isset device
711ffac1 MT	403
3cb2fc42	404	local status=${STATUS_DOWN}
711ffac1	405
3cb2fc42	406	if device_is_up ${device}; then
711ffac1	407	status=${STATUS_UP}
711ffac1	408
3cb2fc42 MT	409	if ! device_has_carrier ${device}; then
	410	status=${STATUS_NOCARRIER}
	411	fi
	412	fi
711ffac1 MT	413
	414	echo "${status}"
	415	}
	416
1848564d MT	417	function device_get_address() {
	418	local device=${1}
	419
	420	cat ${SYS_CLASS_NET}/${device}/address 2>/dev/null
	421	}
	422
	423	function device_set_address() {
08c5b789 MT	424	assert [ $# -eq 2 ]
	425
	426	local device="${1}"
	427	local addr="${2}"
1b7a1578	428
08c5b789	429	if ! device_exists "${device}"; then
1b7a1578 MT	430	error "Device '${device}' does not exist."
	431	return ${EXIT_ERROR}
	432	fi
	433
08c5b789 MT	434	# Do nothing if the address has not changed
	435	local old_addr="$(device_get_address "${device}")"
	436	if [ -n "${old_addr}" -a "${addr}" = "${old_addr}" ]; then
	437	return ${EXIT_OK}
	438	fi
	439
	440	log DEBUG "Setting address of '${device}' from '${old_addr}' to '${addr}'"
1b7a1578 MT	441
1b7a1578 MT	442	local up
08c5b789 MT	443	if device_is_up "${device}"; then
08c5b789 MT	444	device_set_down "${device}"
1b7a1578 MT	445	up=1
	446	fi
	447
08c5b789	448	ip link set "${device}" address "${addr}"
1b7a1578 MT	449	local ret=$?
	450
	451	if [ "${up}" = "1" ]; then
08c5b789	452	device_set_up "${device}"
1b7a1578 MT	453	fi
	454
	455	if [ "${ret}" != "0" ]; then
08c5b789	456	error_log "Could not set address '${addr}' on device '${device}'"
1b7a1578 MT	457	fi
	458
	459	return ${ret}
1848564d MT	460	}
1848564d MT	461
711ffac1	462	function device_get() {
2ae0fb8d	463	local device
711ffac1 MT	464	local devices
711ffac1 MT	465
2ae0fb8d MT	466	for device in ${SYS_CLASS_NET}/*; do
2ae0fb8d MT	467	device=$(basename ${device})
711ffac1	468
2ae0fb8d MT	469	# bonding_masters is no device
	470	[ "${device}" = "bonding_masters" ] && continue
	471
	472	devices="${devices} ${device}"
	473	done
711ffac1 MT	474
	475	echo ${devices}
	476	return ${EXIT_OK}
	477	}
	478
1848564d	479	function devices_get_all() {
711ffac1	480	device_get
1848564d MT	481	}
	482
	483	# Check if a device has a cable plugged in
	484	function device_has_carrier() {
5bb2429a MT	485	local device=${1}
	486	assert isset device
	487
ec63256a MT	488	local carrier=$(__device_get_file ${device} carrier)
ec63256a MT	489	[ "${carrier}" = "1" ]
1848564d MT	490	}
1848564d MT	491
1e4c26a4 MT	492	function device_is_promisc() {
	493	local device=${1}
	494
e369be1a	495	device_has_flag ${device} 0x200
1e4c26a4 MT	496	}
1e4c26a4 MT	497
cf6e4606 MT	498	function device_set_promisc() {
	499	local device=${1}
	500	local state=${2}
	501
	502	assert device_exists ${device}
	503	assert isset state
	504	assert isoneof state on off
	505
	506	ip link set ${device} promisc ${state}
	507	}
	508
1848564d MT	509	# Check if the device is free
1848564d MT	510	function device_is_free() {
81ed640c	511	! device_is_used $@
1848564d MT	512	}
	513
	514	# Check if the device is used
	515	function device_is_used() {
5bb2429a	516	local device=${1}
1848564d	517
7951525a	518	device_has_vlans ${device} && \
fb02e543	519	return ${EXIT_OK}
1848564d	520	device_is_bonded ${device} && \
fb02e543	521	return ${EXIT_OK}
81ed640c MT	522	device_is_bridge_attached ${device} && \
81ed640c MT	523	return ${EXIT_OK}
1848564d	524
fb02e543	525	return ${EXIT_ERROR}
1848564d MT	526	}
1848564d MT	527
1b7a1578 MT	528	function device_hash() {
	529	local device=${1}
	530
37e4ec8b MT	531	# Get mac address of device and remove all colons (:)
	532	# that will result in a hash.
	533	device=$(macify ${device})
	534
	535	echo "${device//:/}"
1b7a1578 MT	536	}
	537
	538	# Give the device a new name
	539	function device_set_name() {
1848564d	540	local source=$1
1578dae9	541	local destination=${2}
1848564d MT	542
	543	# Check if devices exists
	544	if ! device_exists ${source} \|\| device_exists ${destination}; then
	545	return 4
	546	fi
	547
	548	local up
	549	if device_is_up ${source}; then
	550	ip link set ${source} down
	551	up=1
	552	fi
	553
	554	ip link set ${source} name ${destination}
	555
	556	if [ "${up}" = "1" ]; then
	557	ip link set ${destination} up
	558	fi
	559	}
	560
1848564d MT	561	# Set device up
1848564d MT	562	function device_set_up() {
5bb2429a	563	local device=${1}
1848564d	564
711ffac1 MT	565	# Silently fail if device was not found
	566	[ -z "${device}" ] && return ${EXIT_ERROR}
	567
1848564d MT	568	# Do nothing if device is already up
	569	device_is_up ${device} && return ${EXIT_OK}
	570
81ed640c MT	571	device_set_parent_up ${device}
	572
	573	log DEBUG "Setting up device '${device}'"
	574
1848564d MT	575	ip link set ${device} up
	576	}
	577
81ed640c MT	578	function device_set_parent_up() {
	579	local device=${1}
	580	local parent
	581
7951525a MT	582	if device_is_vlan ${device}; then
7951525a MT	583	parent=$(vlan_get_parent ${device})
81ed640c MT	584
	585	device_is_up ${parent} && return ${EXIT_OK}
	586
	587	log DEBUG "Setting up parent device '${parent}' of '${device}'"
	588
	589	device_set_up ${parent}
	590	return $?
	591	fi
	592
	593	return ${EXIT_OK}
	594	}
	595
1848564d MT	596	# Set device down
1848564d MT	597	function device_set_down() {
5bb2429a MT	598	local device=${1}
5bb2429a MT	599	assert isset device
1848564d	600
81ed640c MT	601	local ret=${EXIT_OK}
	602
	603	if device_is_up ${device}; then
	604	log DEBUG "Tearing down device '${device}'"
	605
	606	ip link set ${device} down
	607	ret=$?
	608	fi
	609
	610	device_set_parent_down ${device}
1848564d	611
81ed640c MT	612	return ${ret}
	613	}
	614
	615	function device_set_parent_down() {
	616	local device=${1}
	617	local parent
	618
7951525a MT	619	if device_is_vlan ${device}; then
7951525a MT	620	parent=$(vlan_get_parent ${device})
81ed640c MT	621
	622	device_is_up ${parent} \|\| return ${EXIT_OK}
	623
	624	if device_is_free ${parent}; then
	625	log DEBUG "Tearing down parent device '${parent}' of '${device}'"
	626
	627	device_set_down ${parent}
	628	fi
	629	fi
	630
	631	return ${EXIT_OK}
1848564d MT	632	}
1848564d MT	633
1848564d MT	634	function device_get_mtu() {
	635	local device=${1}
	636
	637	if ! device_exists ${device}; then
	638	error "Device '${device}' does not exist."
	639	return ${EXIT_ERROR}
	640	fi
	641
f3e6fe50	642	echo $(<${SYS_CLASS_NET}/${device}/mtu)
1848564d MT	643	}
	644
	645	# Set mtu to a device
	646	function device_set_mtu() {
1b7a1578	647	local device=${1}
1848564d MT	648	local mtu=${2}
1848564d MT	649
1b7a1578 MT	650	if ! device_exists ${device}; then
	651	error "Device '${device}' does not exist."
	652	return ${EXIT_ERROR}
	653	fi
	654
	655	local oldmtu=$(device_get_mtu ${device})
	656
	657	if [ "${oldmtu}" = "${mtu}" ]; then
	658	# No need to set mtu.
	659	return ${EXIT_OK}
	660	fi
	661
	662	log INFO "Setting mtu of '${device}' to '${mtu}' - was ${oldmtu}."
	663
1848564d	664	local up
1b7a1578 MT	665	if device_is_up ${device}; then
1b7a1578 MT	666	device_set_down ${device}
1848564d MT	667	up=1
	668	fi
	669
1b7a1578	670	ip link set ${device} mtu ${mtu}
1848564d MT	671	local ret=$?
	672
	673	if [ "${up}" = "1" ]; then
1b7a1578 MT	674	device_set_up ${device}
	675	fi
	676
	677	if [ "${ret}" != "0" ]; then
	678	error_log "Could not set mtu '${mtu}' on device '${device}'."
1848564d MT	679	fi
	680
	681	return ${ret}
	682	}
	683
3ee5ccb1 MT	684	function device_adjust_mtu() {
	685	assert [ $# -eq 2 ]
	686
	687	local device="${1}"
	688	local other_device="${2}"
	689
	690	local mtu="$(device_get_mtu "${other_device}")"
	691	device_set_mtu "${device}" "${mtu}"
	692	}
	693
1848564d MT	694	function device_discover() {
	695	local device=${1}
	696
1b7a1578 MT	697	log INFO "Running discovery process on device '${device}'."
1b7a1578 MT	698
1848564d	699	local hook
d61a01d4 MT	700	for hook in $(hook_zone_get_all); do
d61a01d4 MT	701	hook_zone_exec ${hook} discover ${device}
1848564d MT	702	done
	703	}
	704
38f61548	705	function device_has_ip() {
1848564d MT	706	local device=${1}
	707	local addr=${2}
	708
38f61548 MT	709	assert isset addr
	710	assert device_exists ${device}
	711
	712	# IPv6 addresses must be fully imploded
	713	local protocol=$(ip_detect_protocol ${addr})
	714	case "${protocol}" in
	715	ipv6)
	716	addr=$(ipv6_implode ${addr})
	717	;;
	718	esac
1848564d	719
38f61548	720	listmatch ${addr} $(device_get_addresses ${device})
1848564d	721	}
4231f419	722
38f61548	723	function device_get_addresses() {
4231f419	724	local device=${1}
4231f419	725
38f61548	726	assert device_exists ${device}
4231f419	727
38f61548 MT	728	local prot
	729	local addr
	730	local line
	731	ip addr show ${device} \| \
	732	while read prot addr line; do
	733	[ "${prot:0:4}" = "inet" ] && echo "${addr}"
	734	done
4231f419	735	}
711ffac1	736
711ffac1 MT	737	function __device_get_file() {
	738	local device=${1}
	739	local file=${2}
	740
	741	assert isset device
	742	assert isset file
	743
e369be1a MT	744	local path="${SYS_CLASS_NET}/${device}/${file}"
	745	[ -r "${path}" ] \|\| return ${EXIT_ERROR}
	746
	747	echo "$(<${path})"
711ffac1 MT	748	}
711ffac1 MT	749
2c083d57 MT	750	function __device_set_file() {
	751	assert [ $# -eq 3 ]
	752
	753	local device="${1}"
	754	local file="${2}"
	755	local value="${3}"
	756
	757	local path="${SYS_CLASS_NET}/${device}/${file}"
	758	if [ ! -w "${path}" ]; then
	759	log DEBUG "Cannot write to file '${file}' (${value})"
	760	return ${EXIT_ERROR}
	761	fi
	762
	763	echo "${value}" > "${path}"
	764	}
	765
711ffac1 MT	766	function device_get_rx_bytes() {
	767	local device=${1}
	768
	769	__device_get_file ${device} statistics/rx_bytes
	770	}
	771
	772	function device_get_tx_bytes() {
	773	local device=${1}
	774
	775	__device_get_file ${device} statistics/tx_bytes
	776	}
	777
	778	function device_get_rx_packets() {
	779	local device=${1}
	780
	781	__device_get_file ${device} statistics/rx_packets
	782	}
	783
	784	function device_get_tx_packets() {
	785	local device=${1}
	786
	787	__device_get_file ${device} statistics/tx_packets
	788	}
	789
	790	function device_get_rx_errors() {
	791	local device=${1}
	792
	793	__device_get_file ${device} statistics/rx_errors
	794	}
	795
	796	function device_get_tx_errors() {
	797	local device=${1}
	798
	799	__device_get_file ${device} statistics/tx_errors
	800	}
ec63256a MT	801
	802	function device_get_speed() {
	803	local device=${1}
	804
	805	__device_get_file ${device} speed
	806	}
	807
	808	function device_get_duplex() {
	809	local device=${1}
	810
	811	__device_get_file ${device} duplex
	812	}
657540d8 MT	813
	814	function device_get_link_string() {
	815	local device="${1}"
	816	assert isset device
	817
	818	local s
	819
	820	local speed="$(device_get_speed "${device}")"
	821	if isset speed; then
	822	list_append s "${speed} MBit/s"
	823	fi
	824
	825	local duplex="$(device_get_duplex "${device}")"
	826	if isset duplex; then
	827	list_append s "${duplex} duplex"
	828	fi
	829
	830	print "${s}"
	831	}