Helpers.mk

# Various helper functions and definitions for use by Tock makefiles. Included
# by AppMakefile.mk and libtock's Makefile

# ensure that this file is only included once
ifndef HELPERS_MAKEFILE
HELPERS_MAKEFILE = 1

# http://stackoverflow.com/questions/10858261/abort-makefile-if-variable-not-set
# Check that given variables are set and all have non-empty values,
# die with an error otherwise.
#
# Params:
#   1. Variable name(s) to test.
#   2. (optional) Error message to print.
check_defined = \
    $(strip $(foreach 1,$1, \
        $(call __check_defined,$1,$(strip $(value 2)))))
__check_defined = \
    $(if $(value $1),, \
      $(error Undefined $1$(if $2, ($2))))

# Check for a ~/ at the beginning of a path variable (TOCK_USERLAND_BASE_DIR).
# Make will not properly expand this.
ifdef TOCK_USERLAND_BASE_DIR
    ifneq (,$(findstring BEGINNINGOFVARIABLE~/,BEGINNINGOFVARIABLE$(TOCK_USERLAND_BASE_DIR)))
        $(error Hi! Using "~" in Makefile variables is not supported. Use "$$(HOME)" instead)
    endif
endif

# # Validate the the toolchain is new enough (known not to work for gcc <= 5.1)
# CC_VERSION_MAJOR := $(shell $(CC) -dumpversion | cut -d '.' -f1)
# ifeq (1,$(shell expr $(CC_VERSION_MAJOR) \>= 6))
#   # Opportunistically turn on gcc 6.0+ warnings since we're already version checking:
#   override CPPFLAGS += -Wduplicated-cond #  if (p->q != NULL) { ... } else if (p->q != NULL) { ... }
#   override CPPFLAGS += -Wnull-dereference # deref of NULL (thought default if -fdelete-null-pointer-checks, in -Os, but no?)
# else
#   ifneq (5,$(CC_VERSION_MAJOR))
#     $(info CC=$(CC))
#     $(info $$(CC) -dumpversion: $(shell $(CC) -dumpversion))
#     $(error Your compiler is too old. Need gcc version > 5.1)
#   endif
#     CC_VERSION_MINOR := $(shell $(CC) -dumpversion | cut -d '.' -f2)
#   ifneq (1,$(shell expr $(CC_VERSION_MINOR) \> 1))
#     $(info CC=$(CC))
#     $(info $$(CC) -dumpversion: $(shell $(CC) -dumpversion))
#     $(error Your compiler is too old. Need gcc version > 5.1)
#   endif
# endif


# Format check rule
.PHONY: _format_check_unstaged
_format_check_unstaged:
	$(Q)$(TOCK_USERLAND_BASE_DIR)/tools/check_unstaged.sh

#########################################################################################
## Pretty-printing rules

# If environment variable V is non-empty, be verbose
ifneq ($(V),)
Q=
TRACE_DIR =
TRACE_BIN =
TRACE_DEP =
TRACE_CC  =
TRACE_CXX =
TRACE_LD  =
TRACE_AR  =
TRACE_AS  =
TRACE_LST =
ELF2TAB_ARGS += -v
else
Q=@
TRACE_DIR = @echo " DIR       " $@
TRACE_BIN = @echo " BIN       " $@
TRACE_DEP = @echo " DEP       " $<
TRACE_CC  = @echo "  CC       " $<
TRACE_CXX = @echo " CXX       " $<
TRACE_LD  = @echo "  LD       " $@
TRACE_AR  = @echo "  AR       " $@
TRACE_AS  = @echo "  AS       " $<
TRACE_LST = @echo " LST       " $<
endif

endif