[people/stevee/network.git] / functions.zone

#!/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 zone_dir() {
	local zone=${1}

	echo "${NETWORK_ZONE_DIR}/zones/${zone}"
}

function zone_exists() {
	local zone=${1}
	assert isset zone

	[ -d "$(zone_dir ${zone})" ]
}

function zone_match() {
	local match

	local i
	for i in ${VALID_ZONES}; do
		match="${match}|${i}[0-9]{1,5}"
	done

	echo "${match:1:${#match}}"
}

function zone_name_is_valid() {
	local zone=${1}

	# Don't accept empty strings.
	[ -z "${zone}" ] && return ${EXIT_FALSE}

	[[ ${zone} =~ $(zone_match) ]]
}

function zone_is_local() {
	local zone=${1}

	[[ "${zone:0:${#ZONE_LOCAL}}" = "${ZONE_LOCAL}" ]]
}

function zone_is_nonlocal() {
	local zone=${1}

	[[ "${zone:0:${#ZONE_NONLOCAL}}" = "${ZONE_NONLOCAL}" ]]
}

function zone_get_hook() {
	local zone=${1}
	assert isset zone

	config_get_hook $(zone_dir ${zone})/settings
}

function zone_start() {
	# This function will bring up the zone
	# 'asynchronously' with help of systemd.

	local zone=${1}
	assert zone_exists ${zone}

	service_start "network@${zone}.service"
}

function zone_stop() {
	# This function will bring down the zone
	# 'asynchronously' with help of systemd.

	local zone=${1}
	assert zone_exists ${zone}

	service_stop "network@${zone}.service"
}

function zone_enable() {
	# This function will enable the zone
	# with help of systemd.

	local zone="${1}"
	assert zone_exists "${zone}"

	# Enable service for the zone
	service_enable "network@${zone}.service"
	local ret=$?

	if [ ${ret} -eq ${EXIT_OK} ]; then
		log INFO "Auto-start enabled for zone ${zone}"
		return ${EXIT_OK}
	fi

	log ERROR "Could not enable zone ${zone}: ${ret}"
	return ${ret}
}

function zone_disable() {
	# This function will disable the zone
	# with help of systemd.

	local zone="${1}"
	assert zone_exists "${zone}"

	# Disable service for the zone
	service_disable "network@${zone}.service"
	local ret=$?

	if [ ${ret} -eq ${EXIT_OK} ]; then
		log INFO "Auto-start disabled for zone ${zone}"
		return ${EXIT_OK}
	fi

	log ERROR "Could not disable zone ${zone}: ${ret}"
	return ${ret}
}

function zone_is_enabled() {
	local zone="${1}"
	assert isset zone

	# Ask systemd if the zone is enabled.
	if service_is_enabled "network@${zone}.service"; then
		return ${EXIT_TRUE}
	fi

	return ${EXIT_FALSE}
}

function zone_create() {
	local zone=${1}
	local hook=${2}
	shift 2

	if ! zone_name_is_valid ${zone}; then
		error "Zone name '${zone}' is not valid."
		return ${EXIT_ERROR}
	fi

	if zone_exists ${zone}; then
		error "Zone '${zone}' does already exist."
		return ${EXIT_ERROR}
	fi

	if ! hook_zone_exists ${hook}; then
		error "Hook '${hook}' does not exist."
		return ${EXIT_ERROR}
	fi

	mkdir -p $(zone_dir ${zone})

	# Create directories for configs and ports
	mkdir -p $(zone_dir ${zone})/{configs,ports}

	hook_zone_exec ${hook} create ${zone} $@
	local ret=$?

	# Maybe the zone create hook did not exit correctly.
	# If this is the case we remove the created zone immediately.
	if [ "${ret}" = "${EXIT_ERROR}" ]; then
		zone_remove_now ${zone}
		return ${EXIT_ERROR}
	fi

	# Automatically enable zone.
	zone_enable "${zone}"
}

function zone_edit() {
	local zone=${1}
	shift

	if ! zone_exists ${zone}; then
		error "Zone '${zone}' does not exist."
		return ${EXIT_ERROR}
	fi

	# Check if the zone is tagged for removal.
	if zone_has_remove_tag ${zone}; then
		error "You cannot edit a zone that is tagged for removal."
		return ${EXIT_ERROR}
	fi

	local hook=$(config_get_hook $(zone_dir ${zone})/settings)

	if [ -z "${hook}" ]; then
		error "Config file did not provide any hook."
		return ${EXIT_ERROR}
	fi

	if ! hook_zone_exists ${hook}; then
		error "Hook '${hook}' does not exist."
		return ${EXIT_ERROR}
	fi

	hook_zone_exec ${hook} edit ${zone} $@
}


function zone_remove() {
	local zone=${1}
	assert zone_exists ${zone}

	# Make the zone for removal.
	touch $(zone_dir ${zone})/.remove

	log INFO "Zone '${zone}' has been tagged for removal."
}

function zone_has_remove_tag() {
	local zone=${1}
	assert zone_exists ${zone}

	[ -e "$(zone_dir ${zone})/.remove" ]
}

# This function will remove the given zone
# RIGHT NOW. Use zone_remove to remove it
# at the next status change.
function zone_remove_now() {
	local zone=${1}
	assert zone_exists ${zone}

	log INFO "Removing zone '${zone}' right now."

	# Force the zone down.
	zone_is_up ${zone} && zone_set_down ${zone}

	# Disable zone.
	zone_disable "${zone}"

	rm -rf $(zone_dir ${zone})
}

function zone_up() {
	local zone=${1}
	shift

	if ! zone_exists ${zone}; then
		error "Zone '${zone}' does not exist."
		return ${EXIT_ERROR}
	fi

	# Check if a zone has got the remove tag.
	if zone_has_remove_tag ${zone}; then
		error "Cannot bring up any zone which is to be removed."
		return ${EXIT_ERROR}
	fi

	local hook=$(config_get_hook $(zone_dir ${zone})/settings)

	if [ -z "${hook}" ]; then
		error "Config file did not provide any hook."
		return ${EXIT_ERROR}
	fi

	if ! hook_zone_exists ${hook}; then
		error "Hook '${hook}' does not exist."
		return ${EXIT_ERROR}
	fi

	zone_db ${zone} starting

	hook_zone_exec ${hook} up ${zone} $@

	zone_db ${zone} started
}

function zone_down() {
	local zone=${1}
	shift

	if ! zone_exists ${zone}; then
		error "Zone '${zone}' does not exist."
		return ${EXIT_ERROR}
	fi

	local hook=$(config_get_hook $(zone_dir ${zone})/settings)

	if [ -z "${hook}" ]; then
		error "Config file did not provide any hook."
		return ${EXIT_ERROR}
	fi

	if ! hook_zone_exists ${hook}; then
		error "Hook '${hook}' does not exist."
		return ${EXIT_ERROR}
	fi

	zone_db ${zone} stopping

	hook_zone_exec ${hook} down ${zone} $@

	zone_db ${zone} stopped

	# Remove the zone, if it has got a remove tag.
	if zone_has_remove_tag ${zone}; then
		zone_remove_now ${zone}
	fi
}

function zone_status() {
	local zone=${1}
	shift

	if ! zone_exists ${zone}; then
		error "Zone '${zone}' does not exist."
		return ${EXIT_ERROR}
	fi

	local hook=$(config_get_hook $(zone_dir ${zone})/settings)

	if [ -z "${hook}" ]; then
		error "Config file did not provide any hook."
		return ${EXIT_ERROR}
	fi

	if ! hook_zone_exists ${hook}; then
		error "Hook '${hook}' does not exist."
		return ${EXIT_ERROR}
	fi

	hook_zone_exec ${hook} status ${zone} $@

	# Show that the zone it to be removed soon.
	if zone_has_remove_tag ${zone}; then
		warning "This zone is tagged for removal."
	fi
}

function zone_port() {
	local zone=${1}
	local action=${2}
	shift 2

	assert isset zone
	assert isset action
	assert zone_exists ${zone}

	# Aliases
	case "${action}" in
		del|delete|remove)
			action="rem"
			;;
	esac

	case "${action}" in
		add|edit|rem)
			zone_port_${action} ${zone} $@
			;;
		*)
			error "Unrecognized argument: ${action}"
			cli_usage root-zone-port-subcommands
			exit ${EXIT_ERROR}
			;;		
	esac
}

function zone_port_add() {
	local zone=${1}
	shift

	assert isset zone

	local hook=$(zone_get_hook ${zone})

	assert isset hook

	hook_zone_exec ${hook} port_add ${zone} $@
}

function zone_port_edit() {
	zone_port_cmd edit $@
}

function zone_port_rem() {
	zone_port_cmd rem $@
}

function zone_port_cmd() {
	local cmd=${1}
	local zone=${2}
	local port=${3}
	shift 3

	assert isset zone
	assert isset port

	local hook_zone=$(zone_get_hook ${zone})
	local hook_port=$(port_get_hook ${port})

	assert isset hook_zone
	assert isset hook_port

	hook_zone_port_exec ${hook_zone} ${hook_port} ${cmd} ${zone} ${port} $@
}

function zone_port_up() {
	zone_port_cmd up $@
}

function zone_port_down() {
	zone_port_cmd down $@
}

function zone_get_ports() {
	local zone=${1}

	assert isset zone

	local port
	for port in $(zone_dir ${zone})/ports/*; do
		port=$(basename ${port})

		if port_exists ${port}; then
			echo "${port}"
		fi
	done
}

function zone_has_port() {
	# Check, if the given port is configured
	# in this zone.

	local zone=${1}
	local port=${2}
	shift 2

	assert isset zone
	assert isset port

	[ -e "$(zone_dir ${zone})/ports/${port}" ]
}

# XXX overwritten some lines below
function zone_config() {
	local zone=${1}
	shift

	if ! zone_exists ${zone}; then
		error "Zone '${zone}' does not exist."
		return ${EXIT_ERROR}
	fi

	local hook=$(config_get_hook $(zone_dir ${zone})/settings)

	if [ -z "${hook}" ]; then
		error "Config file did not provide any hook."
		return ${EXIT_ERROR}
	fi

	if ! hook_zone_exists ${hook}; then
		error "Hook '${hook}' does not exist."
		return ${EXIT_ERROR}
	fi

	hook_zone_exec ${hook} config ${zone} $@
}

function zone_config() {
	local zone=${1}
	local action=${2}
	shift 2

	assert isset zone
	assert isset action
	assert zone_exists ${zone}

	# Aliases
	case "${action}" in
		del|delete|remove)
			action="rem"
			;;
	esac

	case "${action}" in
		create|edit|rem)
			zone_config_${action} ${zone} $@
			;;
		*)
			error "Unrecognized argument: ${action}"
			cli_usage root-zone-config-subcommands
			exit ${EXIT_ERROR}
			;;
	esac
}

function zone_config_option() {
	local zone=${1}
	local option=${2}
	local default=${3}
	shift 2

	assert isset zone
	assert isset option

	(
		VALUE="${default}"
		zone_config_read ${zone}

		VALUE="${!option}"
		echo "${VALUE}"
	)
}

function zone_config_create() {
	local zone=${1}
	shift

	assert isset zone

	local hook=$(zone_get_hook ${zone})

	assert isset hook

	hook_zone_exec ${hook} config_create ${zone} $@
}

function zone_show() {
	local zone=${1}

	echo "${zone}"
	echo "  Type: $(zone_get_hook ${zone})"
	echo
}

function zones_show() {
	local zone

	for zone in $(zones_get $@); do
		zone_show ${zone}
	done
}

function zones_get_all() {
	local zone
	for zone in $(zone_dir)/*; do
		zone=$(basename ${zone})
		zone_exists ${zone} || continue

		echo "${zone}"
	done
}

function zones_get_local() {
	local zone
	for zone in $(zones_get_all); do
		zone_is_local ${zone} && echo "${zone}"
	done
}

function zones_get_nonlocal() {
	local zone
	for zone in $(zones_get_all); do
		zone_is_nonlocal ${zone} && echo "${zone}"
	done
}

function zones_get() {
	local local=1
	local remote=1

	local zones

	while [ $# -gt 0 ]; do
		case "${1}" in
			--local-only)
				local=1
				remote=0
				;;
			--remote-only)
				local=0
				remote=1
				;;
			--all)
				local=1
				remote=1
				;;
			*)
				if zone_name_is_valid ${1}; then
					zones="${zones} ${1}"
				else			
					warning "Unrecognized argument '${1}'"
				fi
				;;
		esac
		shift
	done

	if [ -n "${zones}" ]; then
		local zone
		for zone in ${zones}; do
			zone_exists ${zone} && echo "${zone}"
		done
		exit ${EXIT_OK}
	fi

	if [ ${local} -eq 1 ] && [ ${remote} -eq 1 ]; then
		zones_get_all
	elif [ ${local} -eq 1 ]; then
		zones_get_local
	elif [ ${remote} -eq 1 ]; then
		zones_get_nonlocal
	fi
}

function zone_ports_list() {
	local zone=${1}

	local port
	for port in $(zone_dir ${zone})/ports/*; do
		[ -e "${port}" ] || continue

		echo $(basename ${port})
	done
}

function zone_ports_cmd() {
	local cmd=${1}
	local zone=${2}
	shift 2

	assert isset cmd
	assert isset zone

	assert zone_exists ${zone}

	local hook=$(zone_get_hook ${zone})

	local port
	for port in $(zone_get_ports ${zone}); do
		hook_zone_exec ${hook} ${cmd} ${zone} ${port} $@
	done
}

function zone_ports_up() {
	zone_ports_cmd port_up $@
}

function zone_ports_down() {
	zone_ports_cmd port_down $@
}

function zone_ports_status() {
	zone_ports_cmd port_status $@
}

function zone_configs_list() {
	local zone=${1}

	local config
	for config in $(zone_dir ${zone})/configs/*; do
		[ -e "${config}" ] || continue

		basename ${config}
	done
}

function zone_configs_cmd() {
	local cmd=${1}
	local zone=${2}
	shift 2

	local hook_zone=$(config_get_hook $(zone_dir ${zone})/settings)

	local hook_config
	local config
	for config in $(zone_configs_list ${zone}); do
		hook_config=$(config_get_hook $(zone_dir ${zone})/configs/${config})

		hook_zone_config_exec ${hook_zone} ${hook_config} ${cmd} ${zone} ${config} $@
	done
}

function zone_configs_up() {
	zone_configs_cmd up $@
}

function zone_configs_down() {
	zone_configs_cmd down $@
}

function zone_configs_status() {
	zone_configs_cmd config_status $@
}

function zone_has_ip() {
	device_has_ip $@
}

function zone_db() {
	local zone=${1}
	local action=${2}
	shift 2

	case "${action}" in
		starting|started|stopping|stopped)
			db_connection_update ${zone} ${action}
			;;
	esac
}

function zone_is_up() {
	local zone=${1}

	device_is_up ${zone}
}

function zone_is_down() {
	! zone_is_up $@
}

function zone_get_supported_port_hooks() {
	local zone=${1}

	local hook=$(zone_get_hook ${zone})

	hook_zone_ports_get_all ${hook}
}

function zone_get_supported_config_hooks() {
	local zone=${1}

	local hook=$(zone_get_hook ${zone})

	hook_zone_configs_get_all ${hook}
}

function zone_file() {
	local zone=${1}

	assert isset zone

	echo "$(zone_dir ${zone})/settings"
}

function zone_config_read() {
	local zone=${1}

	assert isset zone

	# Save the HOOK variable.
	local hook="${HOOK}"

	config_read $(zone_file ${zone})

	# Restore hook.
	HOOK="${hook}"
}

function zone_config_write() {
	local zone=${1}

	assert isset zone

	config_write $(zone_file ${zone}) ${HOOK_SETTINGS}
}

function zone_config_set() {
	local zone=${1}
	shift
	local args="$@"

	assert isset zone

	(
		zone_config_read ${zone}

		for arg in ${args}; do
			eval "${arg}"
		done
	
		zone_config_write ${zone}
	)
}

function zone_config_get() {
	local zone=${1}
	local key=${2}

	assert isset zone
	assert isset key

	(
		zone_config_read ${zone}

		echo "${!key}"
	)
}
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
	22	function zone_dir() {
	23	local zone=${1}
	24
d2a21d01	25	echo "${NETWORK_ZONE_DIR}/zones/${zone}"
1848564d MT	26	}
	27
	28	function zone_exists() {
	29	local zone=${1}
711ffac1 MT	30	assert isset zone
711ffac1 MT	31
1848564d MT	32	[ -d "$(zone_dir ${zone})" ]
	33	}
	34
	35	function zone_match() {
	36	local match
	37
	38	local i
	39	for i in ${VALID_ZONES}; do
	40	match="${match}\|${i}[0-9]{1,5}"
	41	done
	42
	43	echo "${match:1:${#match}}"
	44	}
	45
	46	function zone_name_is_valid() {
	47	local zone=${1}
4fedddef MT	48
	49	# Don't accept empty strings.
	50	[ -z "${zone}" ] && return ${EXIT_FALSE}
711ffac1	51
1848564d MT	52	[[ ${zone} =~ $(zone_match) ]]
	53	}
	54
	55	function zone_is_local() {
	56	local zone=${1}
	57
7de0637a	58	[[ "${zone:0:${#ZONE_LOCAL}}" = "${ZONE_LOCAL}" ]]
5e42d659 MT	59	}
	60
	61	function zone_is_nonlocal() {
	62	local zone=${1}
	63
7de0637a	64	[[ "${zone:0:${#ZONE_NONLOCAL}}" = "${ZONE_NONLOCAL}" ]]
1848564d MT	65	}
	66
	67	function zone_get_hook() {
	68	local zone=${1}
711ffac1 MT	69	assert isset zone
711ffac1 MT	70
1848564d MT	71	config_get_hook $(zone_dir ${zone})/settings
	72	}
	73
5bb2429a MT	74	function zone_start() {
	75	# This function will bring up the zone
	76	# 'asynchronously' with help of systemd.
	77
	78	local zone=${1}
	79	assert zone_exists ${zone}
	80
1d08b9b3	81	service_start "network@${zone}.service"
5bb2429a MT	82	}
	83
	84	function zone_stop() {
	85	# This function will bring down the zone
	86	# 'asynchronously' with help of systemd.
	87
	88	local zone=${1}
	89	assert zone_exists ${zone}
	90
1d08b9b3	91	service_stop "network@${zone}.service"
5bb2429a MT	92	}
5bb2429a MT	93
5c5b8e36 SS	94	function zone_enable() {
	95	# This function will enable the zone
	96	# with help of systemd.
	97
	98	local zone="${1}"
	99	assert zone_exists "${zone}"
	100
	101	# Enable service for the zone
	102	service_enable "network@${zone}.service"
	103	local ret=$?
	104
	105	if [ ${ret} -eq ${EXIT_OK} ]; then
	106	log INFO "Auto-start enabled for zone ${zone}"
	107	return ${EXIT_OK}
	108	fi
	109
	110	log ERROR "Could not enable zone ${zone}: ${ret}"
	111	return ${ret}
	112	}
	113
	114	function zone_disable() {
	115	# This function will disable the zone
	116	# with help of systemd.
	117
	118	local zone="${1}"
	119	assert zone_exists "${zone}"
	120
	121	# Disable service for the zone
	122	service_disable "network@${zone}.service"
	123	local ret=$?
	124
	125	if [ ${ret} -eq ${EXIT_OK} ]; then
	126	log INFO "Auto-start disabled for zone ${zone}"
	127	return ${EXIT_OK}
	128	fi
	129
	130	log ERROR "Could not disable zone ${zone}: ${ret}"
	131	return ${ret}
	132	}
	133
	134	function zone_is_enabled() {
	135	local zone="${1}"
	136	assert isset zone
	137
	138	# Ask systemd if the zone is enabled.
	139	if service_is_enabled "network@${zone}.service"; then
	140	return ${EXIT_TRUE}
	141	fi
	142
	143	return ${EXIT_FALSE}
	144	}
	145
1848564d MT	146	function zone_create() {
	147	local zone=${1}
	148	local hook=${2}
	149	shift 2
	150
	151	if ! zone_name_is_valid ${zone}; then
	152	error "Zone name '${zone}' is not valid."
	153	return ${EXIT_ERROR}
	154	fi
	155
	156	if zone_exists ${zone}; then
	157	error "Zone '${zone}' does already exist."
	158	return ${EXIT_ERROR}
	159	fi
	160
d61a01d4	161	if ! hook_zone_exists ${hook}; then
1848564d MT	162	error "Hook '${hook}' does not exist."
	163	return ${EXIT_ERROR}
	164	fi
	165
	166	mkdir -p $(zone_dir ${zone})
	167
a5ebb169 MT	168	# Create directories for configs and ports
a5ebb169 MT	169	mkdir -p $(zone_dir ${zone})/{configs,ports}
943e3f7e	170
d61a01d4	171	hook_zone_exec ${hook} create ${zone} $@
1848564d MT	172	local ret=$?
	173
	174	# Maybe the zone create hook did not exit correctly.
	175	# If this is the case we remove the created zone immediately.
	176	if [ "${ret}" = "${EXIT_ERROR}" ]; then
69ace22b	177	zone_remove_now ${zone}
5c5b8e36	178	return ${EXIT_ERROR}
1848564d	179	fi
5c5b8e36 SS	180
	181	# Automatically enable zone.
	182	zone_enable "${zone}"
1848564d MT	183	}
	184
	185	function zone_edit() {
	186	local zone=${1}
	187	shift
	188
	189	if ! zone_exists ${zone}; then
	190	error "Zone '${zone}' does not exist."
	191	return ${EXIT_ERROR}
	192	fi
	193
69ace22b MT	194	# Check if the zone is tagged for removal.
	195	if zone_has_remove_tag ${zone}; then
	196	error "You cannot edit a zone that is tagged for removal."
	197	return ${EXIT_ERROR}
	198	fi
	199
1848564d MT	200	local hook=$(config_get_hook $(zone_dir ${zone})/settings)
	201
	202	if [ -z "${hook}" ]; then
	203	error "Config file did not provide any hook."
	204	return ${EXIT_ERROR}
	205	fi
	206
d61a01d4	207	if ! hook_zone_exists ${hook}; then
1848564d MT	208	error "Hook '${hook}' does not exist."
	209	return ${EXIT_ERROR}
	210	fi
	211
d61a01d4	212	hook_zone_exec ${hook} edit ${zone} $@
1848564d MT	213	}
1848564d MT	214
69ace22b	215
1848564d MT	216	function zone_remove() {
1848564d MT	217	local zone=${1}
69ace22b	218	assert zone_exists ${zone}
1848564d	219
69ace22b MT	220	# Make the zone for removal.
	221	touch $(zone_dir ${zone})/.remove
	222
	223	log INFO "Zone '${zone}' has been tagged for removal."
	224	}
	225
	226	function zone_has_remove_tag() {
	227	local zone=${1}
	228	assert zone_exists ${zone}
	229
	230	[ -e "$(zone_dir ${zone})/.remove" ]
	231	}
	232
	233	# This function will remove the given zone
	234	# RIGHT NOW. Use zone_remove to remove it
	235	# at the next status change.
	236	function zone_remove_now() {
	237	local zone=${1}
	238	assert zone_exists ${zone}
	239
	240	log INFO "Removing zone '${zone}' right now."
1848564d	241
69ace22b MT	242	# Force the zone down.
69ace22b MT	243	zone_is_up ${zone} && zone_set_down ${zone}
1848564d	244
5c5b8e36 SS	245	# Disable zone.
	246	zone_disable "${zone}"
	247
1848564d MT	248	rm -rf $(zone_dir ${zone})
	249	}
	250
	251	function zone_up() {
	252	local zone=${1}
	253	shift
	254
	255	if ! zone_exists ${zone}; then
	256	error "Zone '${zone}' does not exist."
	257	return ${EXIT_ERROR}
	258	fi
	259
69ace22b MT	260	# Check if a zone has got the remove tag.
	261	if zone_has_remove_tag ${zone}; then
	262	error "Cannot bring up any zone which is to be removed."
	263	return ${EXIT_ERROR}
	264	fi
	265
1848564d MT	266	local hook=$(config_get_hook $(zone_dir ${zone})/settings)
	267
	268	if [ -z "${hook}" ]; then
	269	error "Config file did not provide any hook."
	270	return ${EXIT_ERROR}
	271	fi
	272
d61a01d4	273	if ! hook_zone_exists ${hook}; then
1848564d MT	274	error "Hook '${hook}' does not exist."
	275	return ${EXIT_ERROR}
	276	fi
	277
059469a8 MT	278	zone_db ${zone} starting
059469a8 MT	279
d61a01d4 MT	280	hook_zone_exec ${hook} up ${zone} $@
d61a01d4 MT	281
059469a8	282	zone_db ${zone} started
1848564d MT	283	}
	284
	285	function zone_down() {
	286	local zone=${1}
	287	shift
	288
	289	if ! zone_exists ${zone}; then
	290	error "Zone '${zone}' does not exist."
	291	return ${EXIT_ERROR}
	292	fi
	293
	294	local hook=$(config_get_hook $(zone_dir ${zone})/settings)
	295
	296	if [ -z "${hook}" ]; then
	297	error "Config file did not provide any hook."
	298	return ${EXIT_ERROR}
	299	fi
	300
d61a01d4	301	if ! hook_zone_exists ${hook}; then
1848564d MT	302	error "Hook '${hook}' does not exist."
	303	return ${EXIT_ERROR}
	304	fi
	305
059469a8 MT	306	zone_db ${zone} stopping
059469a8 MT	307
d61a01d4	308	hook_zone_exec ${hook} down ${zone} $@
059469a8 MT	309
059469a8 MT	310	zone_db ${zone} stopped
69ace22b MT	311
	312	# Remove the zone, if it has got a remove tag.
	313	if zone_has_remove_tag ${zone}; then
	314	zone_remove_now ${zone}
	315	fi
1848564d MT	316	}
	317
	318	function zone_status() {
	319	local zone=${1}
	320	shift
	321
	322	if ! zone_exists ${zone}; then
	323	error "Zone '${zone}' does not exist."
	324	return ${EXIT_ERROR}
	325	fi
	326
	327	local hook=$(config_get_hook $(zone_dir ${zone})/settings)
	328
	329	if [ -z "${hook}" ]; then
	330	error "Config file did not provide any hook."
	331	return ${EXIT_ERROR}
	332	fi
	333
d61a01d4	334	if ! hook_zone_exists ${hook}; then
1848564d MT	335	error "Hook '${hook}' does not exist."
	336	return ${EXIT_ERROR}
	337	fi
	338
d61a01d4	339	hook_zone_exec ${hook} status ${zone} $@
69ace22b MT	340
	341	# Show that the zone it to be removed soon.
	342	if zone_has_remove_tag ${zone}; then
	343	warning "This zone is tagged for removal."
	344	fi
1848564d MT	345	}
1848564d MT	346
711ffac1 MT	347	function zone_port() {
	348	local zone=${1}
	349	local action=${2}
	350	shift 2
	351
	352	assert isset zone
	353	assert isset action
	354	assert zone_exists ${zone}
	355
943e3f7e	356	# Aliases
711ffac1	357	case "${action}" in
943e3f7e MT	358	del\|delete\|remove)
943e3f7e MT	359	action="rem"
711ffac1 MT	360	;;
711ffac1 MT	361	esac
711ffac1	362
943e3f7e MT	363	case "${action}" in
	364	add\|edit\|rem)
	365	zone_port_${action} ${zone} $@
	366	;;
	367	*)
	368	error "Unrecognized argument: ${action}"
	369	cli_usage root-zone-port-subcommands
	370	exit ${EXIT_ERROR}
	371	;;
	372	esac
711ffac1 MT	373	}
	374
	375	function zone_port_add() {
	376	local zone=${1}
	377	shift
	378
	379	assert isset zone
	380
	381	local hook=$(zone_get_hook ${zone})
	382
	383	assert isset hook
	384
	385	hook_zone_exec ${hook} port_add ${zone} $@
	386	}
	387
	388	function zone_port_edit() {
943e3f7e	389	zone_port_cmd edit $@
711ffac1 MT	390	}
711ffac1 MT	391
943e3f7e MT	392	function zone_port_rem() {
943e3f7e MT	393	zone_port_cmd rem $@
711ffac1 MT	394	}
	395
	396	function zone_port_cmd() {
	397	local cmd=${1}
	398	local zone=${2}
	399	local port=${3}
	400	shift 3
	401
	402	assert isset zone
	403	assert isset port
	404
	405	local hook_zone=$(zone_get_hook ${zone})
	406	local hook_port=$(port_get_hook ${port})
	407
	408	assert isset hook_zone
	409	assert isset hook_port
	410
711ffac1 MT	411	hook_zone_port_exec ${hook_zone} ${hook_port} ${cmd} ${zone} ${port} $@
	412	}
	413
711ffac1 MT	414	function zone_port_up() {
	415	zone_port_cmd up $@
	416	}
	417
	418	function zone_port_down() {
	419	zone_port_cmd down $@
	420	}
	421
	422	function zone_get_ports() {
	423	local zone=${1}
	424
	425	assert isset zone
	426
	427	local port
943e3f7e	428	for port in $(zone_dir ${zone})/ports/*; do
711ffac1	429	port=$(basename ${port})
711ffac1 MT	430
	431	if port_exists ${port}; then
	432	echo "${port}"
	433	fi
	434	done
	435	}
	436
3a7fef62 MT	437	function zone_has_port() {
	438	# Check, if the given port is configured
	439	# in this zone.
	440
	441	local zone=${1}
	442	local port=${2}
	443	shift 2
	444
	445	assert isset zone
	446	assert isset port
	447
	448	[ -e "$(zone_dir ${zone})/ports/${port}" ]
	449	}
	450
a5ebb169	451	# XXX overwritten some lines below
1848564d MT	452	function zone_config() {
	453	local zone=${1}
	454	shift
	455
	456	if ! zone_exists ${zone}; then
	457	error "Zone '${zone}' does not exist."
	458	return ${EXIT_ERROR}
	459	fi
	460
	461	local hook=$(config_get_hook $(zone_dir ${zone})/settings)
	462
	463	if [ -z "${hook}" ]; then
	464	error "Config file did not provide any hook."
	465	return ${EXIT_ERROR}
	466	fi
	467
d61a01d4	468	if ! hook_zone_exists ${hook}; then
1848564d MT	469	error "Hook '${hook}' does not exist."
	470	return ${EXIT_ERROR}
	471	fi
	472
d61a01d4	473	hook_zone_exec ${hook} config ${zone} $@
1848564d MT	474	}
1848564d MT	475
a5ebb169 MT	476	function zone_config() {
	477	local zone=${1}
	478	local action=${2}
	479	shift 2
	480
	481	assert isset zone
	482	assert isset action
	483	assert zone_exists ${zone}
	484
	485	# Aliases
	486	case "${action}" in
	487	del\|delete\|remove)
	488	action="rem"
	489	;;
	490	esac
	491
	492	case "${action}" in
	493	create\|edit\|rem)
	494	zone_config_${action} ${zone} $@
	495	;;
	496	*)
	497	error "Unrecognized argument: ${action}"
	498	cli_usage root-zone-config-subcommands
	499	exit ${EXIT_ERROR}
	500	;;
	501	esac
	502	}
	503
3a7fef62 MT	504	function zone_config_option() {
	505	local zone=${1}
	506	local option=${2}
	507	local default=${3}
	508	shift 2
	509
	510	assert isset zone
	511	assert isset option
	512
	513	(
	514	VALUE="${default}"
	515	zone_config_read ${zone}
	516
	517	VALUE="${!option}"
	518	echo "${VALUE}"
	519	)
	520	}
	521
a5ebb169 MT	522	function zone_config_create() {
	523	local zone=${1}
	524	shift
	525
	526	assert isset zone
	527
	528	local hook=$(zone_get_hook ${zone})
	529
	530	assert isset hook
	531
	532	hook_zone_exec ${hook} config_create ${zone} $@
	533	}
	534
1848564d MT	535	function zone_show() {
	536	local zone=${1}
	537
	538	echo "${zone}"
	539	echo " Type: $(zone_get_hook ${zone})"
	540	echo
	541	}
	542
	543	function zones_show() {
	544	local zone
	545
	546	for zone in $(zones_get $@); do
	547	zone_show ${zone}
	548	done
	549	}
	550
	551	function zones_get_all() {
	552	local zone
d61a01d4	553	for zone in $(zone_dir)/*; do
1848564d MT	554	zone=$(basename ${zone})
	555	zone_exists ${zone} \|\| continue
	556
	557	echo "${zone}"
03170817	558	done
1848564d MT	559	}
	560
	561	function zones_get_local() {
	562	local zone
	563	for zone in $(zones_get_all); do
	564	zone_is_local ${zone} && echo "${zone}"
	565	done
	566	}
	567
	568	function zones_get_nonlocal() {
	569	local zone
	570	for zone in $(zones_get_all); do
5e42d659	571	zone_is_nonlocal ${zone} && echo "${zone}"
1848564d MT	572	done
	573	}
	574
	575	function zones_get() {
	576	local local=1
	577	local remote=1
	578
	579	local zones
	580
	581	while [ $# -gt 0 ]; do
	582	case "${1}" in
	583	--local-only)
	584	local=1
	585	remote=0
	586	;;
	587	--remote-only)
	588	local=0
	589	remote=1
	590	;;
	591	--all)
	592	local=1
	593	remote=1
	594	;;
	595	*)
	596	if zone_name_is_valid ${1}; then
	597	zones="${zones} ${1}"
	598	else
	599	warning "Unrecognized argument '${1}'"
	600	fi
	601	;;
	602	esac
	603	shift
	604	done
	605
	606	if [ -n "${zones}" ]; then
	607	local zone
	608	for zone in ${zones}; do
	609	zone_exists ${zone} && echo "${zone}"
	610	done
	611	exit ${EXIT_OK}
	612	fi
	613
	614	if [ ${local} -eq 1 ] && [ ${remote} -eq 1 ]; then
	615	zones_get_all
	616	elif [ ${local} -eq 1 ]; then
	617	zones_get_local
	618	elif [ ${remote} -eq 1 ]; then
	619	zones_get_nonlocal
	620	fi
	621	}
	622
	623	function zone_ports_list() {
	624	local zone=${1}
	625
	626	local port
a5ebb169	627	for port in $(zone_dir ${zone})/ports/*; do
1848564d MT	628	[ -e "${port}" ] \|\| continue
	629
	630	echo $(basename ${port})
03170817	631	done
1848564d MT	632	}
	633
	634	function zone_ports_cmd() {
	635	local cmd=${1}
	636	local zone=${2}
	637	shift 2
	638
711ffac1 MT	639	assert isset cmd
711ffac1 MT	640	assert isset zone
1848564d	641
711ffac1	642	assert zone_exists ${zone}
1848564d	643
711ffac1 MT	644	local hook=$(zone_get_hook ${zone})
	645
	646	local port
	647	for port in $(zone_get_ports ${zone}); do
711ffac1	648	hook_zone_exec ${hook} ${cmd} ${zone} ${port} $@
1848564d MT	649	done
	650	}
	651
	652	function zone_ports_up() {
711ffac1	653	zone_ports_cmd port_up $@
1848564d MT	654	}
	655
	656	function zone_ports_down() {
711ffac1 MT	657	zone_ports_cmd port_down $@
	658	}
	659
	660	function zone_ports_status() {
	661	zone_ports_cmd port_status $@
1848564d MT	662	}
	663
	664	function zone_configs_list() {
	665	local zone=${1}
	666
	667	local config
a5ebb169	668	for config in $(zone_dir ${zone})/configs/*; do
1848564d MT	669	[ -e "${config}" ] \|\| continue
1848564d MT	670
f41fa3d7	671	basename ${config}
03170817	672	done
1848564d MT	673	}
	674
	675	function zone_configs_cmd() {
	676	local cmd=${1}
	677	local zone=${2}
	678	shift 2
	679
	680	local hook_zone=$(config_get_hook $(zone_dir ${zone})/settings)
	681
	682	local hook_config
	683	local config
	684	for config in $(zone_configs_list ${zone}); do
a5ebb169	685	hook_config=$(config_get_hook $(zone_dir ${zone})/configs/${config})
1848564d	686
d61a01d4	687	hook_zone_config_exec ${hook_zone} ${hook_config} ${cmd} ${zone} ${config} $@
1848564d MT	688	done
	689	}
	690
	691	function zone_configs_up() {
	692	zone_configs_cmd up $@
	693	}
	694
	695	function zone_configs_down() {
	696	zone_configs_cmd down $@
	697	}
	698
a5ebb169 MT	699	function zone_configs_status() {
	700	zone_configs_cmd config_status $@
	701	}
	702
38f61548 MT	703	function zone_has_ip() {
38f61548 MT	704	device_has_ip $@
4231f419 MT	705	}
4231f419 MT	706
059469a8 MT	707	function zone_db() {
	708	local zone=${1}
	709	local action=${2}
	710	shift 2
	711
	712	case "${action}" in
	713	starting\|started\|stopping\|stopped)
	714	db_connection_update ${zone} ${action}
	715	;;
	716	esac
	717	}
5e42d659 MT	718
	719	function zone_is_up() {
	720	local zone=${1}
	721
	722	device_is_up ${zone}
	723	}
	724
	725	function zone_is_down() {
	726	! zone_is_up $@
	727	}
711ffac1	728
a5ebb169	729	function zone_get_supported_port_hooks() {
711ffac1 MT	730	local zone=${1}
	731
	732	local hook=$(zone_get_hook ${zone})
	733
	734	hook_zone_ports_get_all ${hook}
	735	}
	736
a5ebb169 MT	737	function zone_get_supported_config_hooks() {
	738	local zone=${1}
	739
	740	local hook=$(zone_get_hook ${zone})
	741
	742	hook_zone_configs_get_all ${hook}
	743	}
	744
711ffac1 MT	745	function zone_file() {
	746	local zone=${1}
	747
	748	assert isset zone
	749
	750	echo "$(zone_dir ${zone})/settings"
	751	}
	752
	753	function zone_config_read() {
	754	local zone=${1}
	755
	756	assert isset zone
	757
bfd6c282 MT	758	# Save the HOOK variable.
	759	local hook="${HOOK}"
	760
711ffac1	761	config_read $(zone_file ${zone})
bfd6c282 MT	762
	763	# Restore hook.
	764	HOOK="${hook}"
711ffac1 MT	765	}
	766
	767	function zone_config_write() {
	768	local zone=${1}
	769
	770	assert isset zone
	771
	772	config_write $(zone_file ${zone}) ${HOOK_SETTINGS}
	773	}
	774
	775	function zone_config_set() {
	776	local zone=${1}
	777	shift
	778	local args="$@"
	779
	780	assert isset zone
	781
	782	(
	783	zone_config_read ${zone}
	784
	785	for arg in ${args}; do
	786	eval "${arg}"
	787	done
	788
	789	zone_config_write ${zone}
	790	)
	791	}
6b3f9c85 MT	792
	793	function zone_config_get() {
	794	local zone=${1}
	795	local key=${2}
	796
	797	assert isset zone
	798	assert isset key
	799
	800	(
	801	zone_config_read ${zone}
	802
	803	echo "${!key}"
	804	)
	805	}