2 ###############################################################################
4 # IPFire.org - A linux based firewall #
5 # Copyright (C) 2010 Michael Tremer & Christian Schmidt #
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. #
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. #
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/>. #
20 ###############################################################################
22 .
/usr
/lib
/network
/header-zone
24 HOOK_MANPAGE
="network-zone-bridge"
26 HOOK_SETTINGS
="HOOK STP STP_FORWARD_DELAY STP_HELLO STP_MAXAGE STP_MODE"
27 HOOK_SETTINGS
="${HOOK_SETTINGS} STP_PRIORITY MAC MTU"
29 HOOK_PORT_SETTINGS
="COST PRIORITY"
41 function hook_check
() {
44 assert isoneof STP_MODE stp rstp
45 assert isinteger STP_HELLO
46 assert isinteger STP_FORWARD_DELAY
47 assert isinteger STP_PRIORITY
51 function hook_parse_cmdline
() {
52 while [ $# -gt 0 ]; do
58 STP_MODE
=${1#--stp-mode=}
61 STP_HELLO
=${1#--stp-hello=}
63 --stp-forward-delay=*)
64 STP_FORWARD_DELAY
=${1#--stp-forward-delay=}
67 STP_PRIORITY
=${1#--stp-priority=}
76 warning
"Ignoring unknown option '${1}'"
87 zone_settings_read
"${zone}" ${HOOK_SETTINGS}
89 # Create the bridge if it does not already exist.
90 if ! device_exists
"${zone}"; then
91 bridge_create
"${zone}" \
100 if isset STP_FORWARD_DELAY
; then
101 stp_bridge_set_forward_delay
"${zone}" "${STP_FORWARD_DELAY}"
104 if isset STP_HELLO
; then
105 stp_bridge_set_hello_time
"${zone}" "${STP_HELLO}"
108 if isset STP_MAXAGE
; then
109 stp_bridge_set_max_age
"${zone}" "${STP_MAXAGE}"
112 if isset STP_PRIORITY
; then
113 stp_bridge_set_priority
"${zone}" "${STP_PRIORITY}"
116 stp_disable
"${zone}"
119 device_set_up
"${zone}"
121 # XXX Currently, there is a bug (in the linux kernel?) that we need to
122 # set our bridges to promisc mode.
123 device_set_promisc
"${zone}" on
126 zone_ports_up
"${zone}"
128 # Bring up all configurations
129 zone_configs_up
"${zone}"
134 function hook_hotplug
() {
138 case "$(hotplug_action)" in
140 # Handle ports of this zone that have just been added
141 if hotplug_event_interface_is_port_of_zone
"${zone}"; then
142 # Bring up the zone if it is enabled but not active, yet.
143 if zone_is_enabled
"${zone}" && ! zone_is_active
"${zone}"; then
147 hook_port_up
"${zone}" "${INTERFACE}"
151 # Handle ports of this zone that have just been removed
152 if hotplug_event_interface_is_port_of_zone
"${zone}"; then
153 hook_port_down
"${zone}" "${INTERFACE}"
157 exit ${EXIT_NOT_HANDLED}
164 function hook_down
() {
168 if ! device_is_up
"${zone}"; then
169 warning
"Zone '${zone}' is not up"
173 # Stop all the configs.
174 zone_configs_down
"${zone}"
176 # Bring down all the ports.
177 zone_ports_down
"${zone}"
180 device_set_down
"${zone}"
181 bridge_delete
"${zone}"
186 function hook_status
() {
190 # Print the default header.
191 cli_device_headline
"${zone}"
193 # Exit if zone is down
194 if ! zone_is_up
"${zone}"; then
199 cli_headline
2 "Spanning Tree Protocol information"
200 if stp_is_enabled
"${zone}"; then
201 local proto
=$
(stp_bridge_get_protocol
${zone})
203 cli_print_fmt1
2 "Version" "$(stp_get_name ${proto})"
204 cli_print_fmt1
2 "ID" "$(stp_bridge_get_id ${zone})"
205 cli_print_fmt1
2 "Priority" "$(stp_bridge_get_priority ${zone})"
207 if stp_bridge_is_root
${zone}; then
208 cli_print
2 "This bridge is root."
210 cli_print_fmt1
2 "Designated root" \
211 "$(stp_bridge_get_designated_root ${zone})"
212 cli_print_fmt1
2 "Root path cost" \
213 "$(stp_bridge_get_root_path_cost ${zone})"
217 # Topology information
218 cli_print_fmt1
2 "Topology changing" \
219 "$(stp_bridge_get_topology_change_detected ${zone})"
220 cli_print_fmt1
2 "Topology change time" \
221 "$(beautify_time $(stp_bridge_get_topology_change_timer ${zone}))"
222 cli_print_fmt1
2 "Topology change count" \
223 "$(stp_bridge_get_topology_change_count ${zone})"
226 cli_print
2 "Disabled"
230 cli_headline
2 "Ports"
231 zone_ports_status
"${zone}"
234 cli_headline
2 "Configurations"
235 zone_configs_cmd status
"${zone}"
241 function __parse_cmdline_args
() {
242 while [ $# -gt 0 ]; do
245 PRIORITY
="$(cli_get_val ${1})"
248 COST
="$(cli_get_val ${1})"
257 function hook_port_add
() {
258 # Excepting at least two arguments here
265 __parse_cmdline_args
"$@"
266 [ $?
-eq ${EXIT_OK} ] ||
return ${EXIT_ERROR}
268 zone_port_settings_write
"${zone}" "${port}" ${HOOK_PORT_SETTINGS}
270 log INFO "Port
'${port}' has been added to zone
'${zone}'"
275 function hook_port_edit() {
282 zone_port_settings_read "${zone}" "${port}" ${HOOK_PORT_SETTINGS}
284 __parse_cmdline_args
"$@"
285 [ $?
-eq ${EXIT_OK} ] ||
return ${EXIT_ERROR}
287 zone_port_settings_write
"${zone}" "${port}" ${HOOK_PORT_SETTINGS}
289 log INFO "Port
'${port}' (member of zone
'${zone}') has been edited
"
294 function hook_port_remove() {
300 # Shut down the port (if possible)
303 log INFO "Port
'${port}' has been removed from zone
'${zone}'"
304 zone_port_settings_remove "${zone}" "${port}"
309 function hook_port_up() {
315 # Try bringing up the port if it has not been
317 # We will get here as soon as the port device has
318 # been created and will then connect it with the bridge.
319 if ! device_exists "${port}"; then
325 # Read configuration values
326 zone_port_settings_read "${zone}" "${port}" ${HOOK_PORT_SETTINGS}
328 # Attach the port to the bridge
329 bridge_attach_device
"${zone}" "${port}"
331 # Set STP configuration
333 stp_port_set_cost
"${zone}" "${port}" "${COST}"
336 # TODO Apply priority (#10609)
338 # Make sure that the port is up
339 device_set_up
"${port}"
344 function hook_port_down
() {
350 if device_exists
"${port}"; then
351 bridge_detach_device
"${zone}" "${port}"
359 function hook_port_status
() {
365 # Do nothing for devices which are not up and running.
366 device_exists
"${port}" ||
exit ${EXIT_OK}
370 # Check if the device is down.
371 if ! device_is_up
"${port}"; then
372 status
="${MSG_DEVICE_STATUS_DOWN}"
374 # Check if the device has no carrier.
375 elif ! device_has_carrier
"${port}"; then
376 status
="${MSG_DEVICE_STATUS_NOCARRIER}"
378 # Check for STP information.
379 elif stp_is_enabled
"${zone}"; then
380 local state
="$(stp_port_get_state "${zone}" "${port}")"
381 state
="MSG_STP_${state}"
384 status
="${status} - DSR: $(stp_port_get_designated_root "${zone}" "${port}")"
385 status="${status} - Cost: $(stp_port_get_cost "${zone}" "${port}")"
387 status
="${MSG_DEVICE_STATUS_UP}"
389 cli_statusline
3 "${port}" "${status}"