Codebase list live-build / master functions / stagefile.sh
master

Tree @master (Download .tar.gz)

stagefile.sh @masterraw · history · blame

#!/bin/sh

## live-build(7) - System Build Scripts
## Copyright (C) 2016-2020 The Debian Live team
## Copyright (C) 2006-2015 Daniel Baumann <[email protected]>
##
## This program comes with ABSOLUTELY NO WARRANTY; for details see COPYING.
## This is free software, and you are welcome to redistribute it
## under certain conditions; see COPYING for details.


Stagefiles_dir ()
{
	echo ".build"
}

# Get the default filename for a script's stagefile (the name of the script
# file itself). A suffix can be appended via providing as a param.
Stagefile_name ()
{
	local SUFFIX="${1}"
	local FILENAME
	FILENAME="$(basename $0)"
	echo ${FILENAME}${SUFFIX:+.$SUFFIX}
}

Stagefile_exists ()
{
	if [ -f ".build/${1:-$(Stagefile_name)}" ]; then
		return 0
	fi
	return 1
}

Check_stagefile ()
{
	local FILE
	local NAME
	FILE=".build/${1:-$(Stagefile_name)}"
	NAME="$(basename ${FILE})"

	# Checking stage file
	if [ -f "${FILE}" ]; then
		if [ "${_FORCE}" != "true" ]; then
			# Skip execution
			Echo_warning "Skipping %s, already done" "${NAME}"
			exit 0
		else
			# Force execution
			Echo_message "Forcing %s" "${NAME}"
			rm -f "${FILE}"
		fi
	fi
}

# Used by chroot preparation scripts in removal mode
Ensure_stagefile_exists ()
{
	local FILE
	local NAME
	FILE=".build/${1:-$(Stagefile_name)}"
	NAME="$(basename ${FILE})"

	# Checking stage file
	if [ ! -f "${FILE}" ]; then
		if [ "${_FORCE}" != "true" ]; then
			# Skip execution
			Echo_warning "Skipping removal of %s, it is not applied" "${NAME}"
			exit 0
		else
			# Force execution
			Echo_message "Forcing %s" "${NAME}"
		fi
	fi
}

Create_stagefile ()
{
	local FILE
	local DIRECTORY
	FILE=".build/${1:-$(Stagefile_name)}"
	DIRECTORY="$(dirname ${FILE})"

	# Creating stage directory
	mkdir -p "${DIRECTORY}"

	# Creating stage file
	touch "${FILE}"
}

Remove_stagefile ()
{
	local FILE
	FILE=".build/${1:-$(Stagefile_name)}"
	rm -f "${FILE}"
}

# Ensure that all specified stagefiles exist (and thus that all associated stages are complete)
Require_stagefiles ()
{
	if [ $# -eq 0 ]; then
		Echo_warning "Bad 'Require_stagefiles' usage, no params were supplied"
		return 0
	fi

	local FILE
	local MISSING=""
	local MISSING_COUNT=0
	for FILE in "${@}"; do
		if [ ! -f ".build/${FILE}" ]; then
			MISSING_COUNT=$(( $MISSING_COUNT + 1 ))
			MISSING="${MISSING:+$MISSING }${FILE}"
		fi
	done
	if [ $MISSING_COUNT -eq 0 ]; then
		return 0
	elif [ $MISSING_COUNT -eq 1 ]; then
		Echo_error "the following stage is required to be done first: %s" "${MISSING}"
	else
		Echo_error "the following stages are required to be completed first: %s" "${MISSING}"
	fi

	exit 1
}