toolchain/external-toolchain/ext-tool.mk - buildroot - Git at Google

 #
 # This file implements the support for external toolchains, i.e
 # toolchains that have not been produced by Buildroot itself and that
 # are already available on the system on which Buildroot runs.
 #
 # The basic principle is the following
 #
 #  1. Perform some checks on the conformity between the toolchain
 #  configuration described in the Buildroot menuconfig system, and the
 #  real configuration of the external toolchain. This is for example
 #  important to make sure that the Buildroot configuration system
 #  knows whether the toolchain supports RPC, IPv6, locales, large
 #  files, etc. Unfortunately, these things cannot be detected
 #  automatically, since the value of these options (such as
 #  BR2_INET_RPC) are needed at configuration time because these
 #  options are used as dependencies for other options. And at
 #  configuration time, we are not able to retrieve the external
 #  toolchain configuration.
 #
 #  2. Copy the libraries needed at runtime to the target directory,
 #  $(TARGET_DIR). Obviously, things such as the C library, the dynamic
 #  loader and a few other utility libraries are needed if dynamic
 #  applications are to be executed on the target system.
 #
 #  3. Copy the libraries and headers to the staging directory. This
 #  will allow all further calls to gcc to be made using --sysroot
 #  $(STAGING_DIR), which greatly simplifies the compilation of the
 #  packages when using external toolchains. So in the end, only the
 #  cross-compiler binaries remains external, all libraries and headers
 #  are imported into the Buildroot tree.

 #
 # Copy a toolchain library and its symbolic links from the sysroot
 # directory to the target directory. Also optionaly strips the
 # library.
 #
 # $1: sysroot directory
 # $2: library name
 # $3: destination directory
 # $4: strip (y|n), default is to strip
 #
 copy_toolchain_lib_root = \
 	SYSROOT_DIR="$(strip $1)"; \
 	LIB="$(strip $2)"; \
 	DST="$(strip $3)"; \
 	STRIP="$(strip $4)"; \
  \
 	LIB_DIR="$${SYSROOT_DIR}/lib" ; \
 	for FILE in `find $${LIB_DIR} -maxdepth 1 -name "$${LIB}.*"`; do \
 		LIB=`basename $${FILE}`; \
 		while test \! -z "$${LIB}"; do \
 			rm -fr $(TARGET_DIR)$${DST}/$${LIB}; \
 			mkdir -p $(TARGET_DIR)$${DST}; \
 			if test -h $${LIB_DIR}/$${LIB}; then \
 				cp -d $${LIB_DIR}/$${LIB} $(TARGET_DIR)$${DST}/; \
 			elif test -f $${LIB_DIR}/$${LIB}; then \
 				$(INSTALL) -D -m0755 $${LIB_DIR}/$${LIB} $(TARGET_DIR)$${DST}/$${LIB}; \
 				case "$${STRIP}" in \
 				(0 | n | no) \
 ;; \
 				(*) \
 					$(TARGET_CROSS)strip "$(TARGET_DIR)$${DST}/$${LIB}"; \
 ;; \
 				esac; \
 			else \
 				exit -1; \
 			fi; \
 			LIB="`readlink $${LIB_DIR}/$${LIB}`"; \
 		done; \
 	done; \
  \
 	echo -n

 #
 # Copy the full external toolchain sysroot directory to the staging
 # dir
 #
 # $1: sysroot directory
 #
 copy_toolchain_sysroot = \
 	SYSROOT_DIR="$(strip $1)"; \
 	cp -a $${SYSROOT_DIR}/* $(STAGING_DIR)/ ; \
 	find $(STAGING_DIR) -type d | xargs chmod 755

 #
 # Check the availability of a particular glibc feature. We assume that
 # all Buildroot toolchain options are supported by glibc, so we just
 # check that they are enabled.
 #
 # $1: Buildroot option name
 # $2: feature description
 #
 check_glibc_feature = \
 	if [ x$($(1)) != x"y" ] ; then \
 		echo "$(2) available in C library, please enable $(1)" ; \
 		exit 1 ; \
 	fi

 #
 # Check the correctness of a glibc external toolchain configuration.
 #  1. Check that the C library selected in Buildroot matches the one
 #     of the external toolchain
 #  2. Check that all the C library-related features are enabled in the
 #     config, since glibc always supports all of them
 #
 # $1: sysroot directory
 #
 check_glibc = \
 	SYSROOT_DIR="$(strip $1)"; \
 	if ! test -f $${SYSROOT_DIR}/lib/ld-linux.so.* ; then \
 		echo "Incorrect selection of the C library"; \
 		exit -1; \
 	fi; \
 	$(call check_glibc_feature,BR2_LARGEFILE,Large file support) ;\
 	$(call check_glibc_feature,BR2_INET_IPV6,IPv6 support) ;\
 	$(call check_glibc_feature,BR2_INET_RPC,RPC support) ;\
 	$(call check_glibc_feature,BR2_ENABLE_LOCALE,Locale support) ;\
 	$(call check_glibc_feature,BR2_USE_WCHAR,Wide char support) ;\
 	$(call check_glibc_feature,BR2_PROGRAM_INVOCATION,Program invocation support)

 #
 # Check the conformity of Buildroot configuration with regard to the
 # uClibc configuration of the external toolchain, for a particular
 # feature.
 #
 # $1: uClibc macro name
 # $2: Buildroot option name
 # $3: uClibc config file
 # $4: feature description
 #
 check_uclibc_feature = \
 	IS_IN_LIBC=`grep -q "\#define $(1) 1" $(3) && echo y` ; \
 	if [ x$($(2)) != x"y" -a x$${IS_IN_LIBC} == x"y" ] ; then \
 		echo "$(4) available in C library, please enable $(2)" ; \
 		exit 1 ; \
 	fi ; \
 	if [ x$($(2)) == x"y" -a x$${IS_IN_LIBC} != x"y" ] ; then \
 		echo "$(4) not available in C library, please disable $(2)" ; \
 		exit 1 ; \
 	fi

 #
 # Check the correctness of a uclibc external toolchain configuration
 #  1. Check that the C library selected in Buildroot matches the one
 #     of the external toolchain
 #  2. Check that the features enabled in the Buildroot configuration
 #     match the features available in the uClibc of the external
 #     toolchain
 #
 # $1: sysroot directory
 #
 check_uclibc = \
 	SYSROOT_DIR="$(strip $1)"; \
 	if ! test -f $${SYSROOT_DIR}/lib/ld-uClibc.so.* ; then \
 		echo "Incorrect selection of the C library"; \
 		exit -1; \
 	fi; \
 	UCLIBC_CONFIG_FILE=$${SYSROOT_DIR}/usr/include/bits/uClibc_config.h ; \
 	$(call check_uclibc_feature,__UCLIBC_HAS_LFS__,BR2_LARGEFILE,$${UCLIBC_CONFIG_FILE},Large file support) ;\
 	$(call check_uclibc_feature,__UCLIBC_HAS_IPV6__,BR2_INET_IPV6,$${UCLIBC_CONFIG_FILE},IPv6 support) ;\
 	$(call check_uclibc_feature,__UCLIBC_HAS_RPC__,BR2_INET_RPC,$${UCLIBC_CONFIG_FILE},RPC support) ;\
 	$(call check_uclibc_feature,__UCLIBC_HAS_LOCALE__,BR2_ENABLE_LOCALE,$${UCLIBC_CONFIG_FILE},Locale support) ;\
 	$(call check_uclibc_feature,__UCLIBC_HAS_WCHAR__,BR2_USE_WCHAR,$${UCLIBC_CONFIG_FILE},Wide char support) ;\
 	$(call check_uclibc_feature,__UCLIBC_HAS_PROGRAM_INVOCATION_NAME__,BR2_PROGRAM_INVOCATION,$${UCLIBC_CONFIG_FILE},Program invocation support) ;\

 #
 # Check that the Buildroot configuration of the ABI matches the
 # configuration of the external toolchain.
 #
 check_arm_abi = \
 	EXT_TOOLCHAIN_TARGET=$(shell LANG=C $(TARGET_CC) -v 2>&1 | grep ^Target | cut -f2 -d ' ') ; \
 	if echo $${EXT_TOOLCHAIN_TARGET} | grep -q 'eabi$$' ; then \
 		EXT_TOOLCHAIN_ABI="eabi" ; \
 	else \
 		EXT_TOOLCHAIN_ABI="oabi" ; \
 	fi ; \
 	if [ x$(BR2_ARM_OABI) == x"y" -a $${EXT_TOOLCHAIN_ABI} == "eabi" ] ; then \
 		echo "Incorrect ABI setting" ; \
 		exit 1 ; \
 	fi ; \
 	if [ x$(BR2_ARM_EABI) == x"y" -a $${EXT_TOOLCHAIN_ABI} == "oabi" ] ; then \
 		echo "Incorrect ABI setting" ; \
 		exit 1 ; \
 	fi ; \

 #
 # Check that the cross-compiler given in the configuration exists
 #
 check_cross_compiler_exists = \
 	if ! test -x $(TARGET_CC) ; then \
 		echo "Cannot find cross-compiler $(TARGET_CC)" ; \
 		exit 1 ; \
 	fi ; \

 uclibc: dependencies $(STAMP_DIR)/ext-toolchain-installed

 EXTERNAL_LIBS=libc.so libcrypt.so libdl.so libgcc_s.so libm.so libnsl.so libpthread.so libresolv.so librt.so libutil.so
 ifeq ($(BR2_TOOLCHAIN_EXTERNAL_UCLIBC),y)
 EXTERNAL_LIBS+=ld-uClibc.so
 else
 EXTERNAL_LIBS+=ld-linux.so libnss_files.so
 endif

 ifeq ($(BR2_INSTALL_LIBSTDCPP),y)
 EXTERNAL_LIBS+=libstdc++.so
 endif

 SYSROOT_DIR=$(shell LANG=C $(TARGET_CC) -v 2>&1 | grep ^Configured | tr " " "\n" | grep -- "--with-sysroot" | cut -f2 -d=)

 $(STAMP_DIR)/ext-toolchain-installed:
 	@echo "Checking external toolchain settings"
 	$(Q)$(call check_cross_compiler_exists)
 ifeq ($(strip $(SYSROOT_DIR)),)
 	@echo "External toolchain doesn't support --sysroot. Cannot use."
 	exit 1
 endif
 ifeq ($(BR2_arm),y)
 	$(Q)$(call check_arm_abi)
 endif
 ifeq ($(BR2_TOOLCHAIN_EXTERNAL_UCLIBC),y)
 	$(Q)$(call check_uclibc,$(SYSROOT_DIR))
 else
 	$(Q)$(call check_glibc,$(SYSROOT_DIR))
 endif
 	mkdir -p $(TARGET_DIR)/lib
 	@echo "Copy external toolchain libraries to target..."
 	$(Q)for libs in $(EXTERNAL_LIBS); do \
 		$(call copy_toolchain_lib_root,$(SYSROOT_DIR),$$libs,/lib,$(BR2_TOOLCHAIN_EXTERNAL_STRIP)); \
 	done
 	@echo "Copy external toolchain sysroot to staging..."
 	$(Q)$(call copy_toolchain_sysroot,$(SYSROOT_DIR))
 	@touch $@
	#
	# This file implements the support for external toolchains, i.e
	# toolchains that have not been produced by Buildroot itself and that
	# are already available on the system on which Buildroot runs.
	#
	# The basic principle is the following
	#
	# 1. Perform some checks on the conformity between the toolchain
	# configuration described in the Buildroot menuconfig system, and the
	# real configuration of the external toolchain. This is for example
	# important to make sure that the Buildroot configuration system
	# knows whether the toolchain supports RPC, IPv6, locales, large
	# files, etc. Unfortunately, these things cannot be detected
	# automatically, since the value of these options (such as
	# BR2_INET_RPC) are needed at configuration time because these
	# options are used as dependencies for other options. And at
	# configuration time, we are not able to retrieve the external
	# toolchain configuration.
	#
	# 2. Copy the libraries needed at runtime to the target directory,
	# $(TARGET_DIR). Obviously, things such as the C library, the dynamic
	# loader and a few other utility libraries are needed if dynamic
	# applications are to be executed on the target system.
	#
	# 3. Copy the libraries and headers to the staging directory. This
	# will allow all further calls to gcc to be made using --sysroot
	# $(STAGING_DIR), which greatly simplifies the compilation of the
	# packages when using external toolchains. So in the end, only the
	# cross-compiler binaries remains external, all libraries and headers
	# are imported into the Buildroot tree.

	#
	# Copy a toolchain library and its symbolic links from the sysroot
	# directory to the target directory. Also optionaly strips the
	# library.
	#
	# $1: sysroot directory
	# $2: library name
	# $3: destination directory
	# $4: strip (y\|n), default is to strip
	#
	copy_toolchain_lib_root = \
	SYSROOT_DIR="$(strip $1)"; \
	LIB="$(strip $2)"; \
	DST="$(strip $3)"; \
	STRIP="$(strip $4)"; \
	\
	LIB_DIR="$${SYSROOT_DIR}/lib" ; \
	for FILE in `find $${LIB_DIR} -maxdepth 1 -name "$${LIB}.*"`; do \
	LIB=`basename $${FILE}`; \
	while test \! -z "$${LIB}"; do \
	rm -fr $(TARGET_DIR)$${DST}/$${LIB}; \
	mkdir -p $(TARGET_DIR)$${DST}; \
	if test -h $${LIB_DIR}/$${LIB}; then \
	cp -d $${LIB_DIR}/$${LIB} $(TARGET_DIR)$${DST}/; \
	elif test -f $${LIB_DIR}/$${LIB}; then \
	$(INSTALL) -D -m0755 $${LIB_DIR}/$${LIB} $(TARGET_DIR)$${DST}/$${LIB}; \
	case "$${STRIP}" in \
	(0 \| n \| no) \
	;; \
	(*) \
	$(TARGET_CROSS)strip "$(TARGET_DIR)$${DST}/$${LIB}"; \
	;; \
	esac; \
	else \
	exit -1; \
	fi; \
	LIB="`readlink $${LIB_DIR}/$${LIB}`"; \
	done; \
	done; \
	\
	echo -n

	#
	# Copy the full external toolchain sysroot directory to the staging
	# dir
	#
	# $1: sysroot directory
	#
	copy_toolchain_sysroot = \
	SYSROOT_DIR="$(strip $1)"; \
	cp -a $${SYSROOT_DIR}/* $(STAGING_DIR)/ ; \
	find $(STAGING_DIR) -type d \| xargs chmod 755

	#
	# Check the availability of a particular glibc feature. We assume that
	# all Buildroot toolchain options are supported by glibc, so we just
	# check that they are enabled.
	#
	# $1: Buildroot option name
	# $2: feature description
	#
	check_glibc_feature = \
	if [ x$($(1)) != x"y" ] ; then \
	echo "$(2) available in C library, please enable $(1)" ; \
	exit 1 ; \
	fi

	#
	# Check the correctness of a glibc external toolchain configuration.
	# 1. Check that the C library selected in Buildroot matches the one
	# of the external toolchain
	# 2. Check that all the C library-related features are enabled in the
	# config, since glibc always supports all of them
	#
	# $1: sysroot directory
	#
	check_glibc = \
	SYSROOT_DIR="$(strip $1)"; \
	if ! test -f $${SYSROOT_DIR}/lib/ld-linux.so.* ; then \
	echo "Incorrect selection of the C library"; \
	exit -1; \
	fi; \
	$(call check_glibc_feature,BR2_LARGEFILE,Large file support) ;\
	$(call check_glibc_feature,BR2_INET_IPV6,IPv6 support) ;\
	$(call check_glibc_feature,BR2_INET_RPC,RPC support) ;\
	$(call check_glibc_feature,BR2_ENABLE_LOCALE,Locale support) ;\
	$(call check_glibc_feature,BR2_USE_WCHAR,Wide char support) ;\
	$(call check_glibc_feature,BR2_PROGRAM_INVOCATION,Program invocation support)

	#
	# Check the conformity of Buildroot configuration with regard to the
	# uClibc configuration of the external toolchain, for a particular
	# feature.
	#
	# $1: uClibc macro name
	# $2: Buildroot option name
	# $3: uClibc config file
	# $4: feature description
	#
	check_uclibc_feature = \
	IS_IN_LIBC=`grep -q "\#define $(1) 1" $(3) && echo y` ; \
	if [ x$($(2)) != x"y" -a x$${IS_IN_LIBC} == x"y" ] ; then \
	echo "$(4) available in C library, please enable $(2)" ; \
	exit 1 ; \
	fi ; \
	if [ x$($(2)) == x"y" -a x$${IS_IN_LIBC} != x"y" ] ; then \
	echo "$(4) not available in C library, please disable $(2)" ; \
	exit 1 ; \
	fi

	#
	# Check the correctness of a uclibc external toolchain configuration
	# 1. Check that the C library selected in Buildroot matches the one
	# of the external toolchain
	# 2. Check that the features enabled in the Buildroot configuration
	# match the features available in the uClibc of the external
	# toolchain
	#
	# $1: sysroot directory
	#
	check_uclibc = \
	SYSROOT_DIR="$(strip $1)"; \
	if ! test -f $${SYSROOT_DIR}/lib/ld-uClibc.so.* ; then \
	echo "Incorrect selection of the C library"; \
	exit -1; \
	fi; \
	UCLIBC_CONFIG_FILE=$${SYSROOT_DIR}/usr/include/bits/uClibc_config.h ; \
	$(call check_uclibc_feature,__UCLIBC_HAS_LFS__,BR2_LARGEFILE,$${UCLIBC_CONFIG_FILE},Large file support) ;\
	$(call check_uclibc_feature,__UCLIBC_HAS_IPV6__,BR2_INET_IPV6,$${UCLIBC_CONFIG_FILE},IPv6 support) ;\
	$(call check_uclibc_feature,__UCLIBC_HAS_RPC__,BR2_INET_RPC,$${UCLIBC_CONFIG_FILE},RPC support) ;\
	$(call check_uclibc_feature,__UCLIBC_HAS_LOCALE__,BR2_ENABLE_LOCALE,$${UCLIBC_CONFIG_FILE},Locale support) ;\
	$(call check_uclibc_feature,__UCLIBC_HAS_WCHAR__,BR2_USE_WCHAR,$${UCLIBC_CONFIG_FILE},Wide char support) ;\
	$(call check_uclibc_feature,__UCLIBC_HAS_PROGRAM_INVOCATION_NAME__,BR2_PROGRAM_INVOCATION,$${UCLIBC_CONFIG_FILE},Program invocation support) ;\

	#
	# Check that the Buildroot configuration of the ABI matches the
	# configuration of the external toolchain.
	#
	check_arm_abi = \
	EXT_TOOLCHAIN_TARGET=$(shell LANG=C $(TARGET_CC) -v 2>&1 \| grep ^Target \| cut -f2 -d ' ') ; \
	if echo $${EXT_TOOLCHAIN_TARGET} \| grep -q 'eabi$$' ; then \
	EXT_TOOLCHAIN_ABI="eabi" ; \
	else \
	EXT_TOOLCHAIN_ABI="oabi" ; \
	fi ; \
	if [ x$(BR2_ARM_OABI) == x"y" -a $${EXT_TOOLCHAIN_ABI} == "eabi" ] ; then \
	echo "Incorrect ABI setting" ; \
	exit 1 ; \
	fi ; \
	if [ x$(BR2_ARM_EABI) == x"y" -a $${EXT_TOOLCHAIN_ABI} == "oabi" ] ; then \
	echo "Incorrect ABI setting" ; \
	exit 1 ; \
	fi ; \

	#
	# Check that the cross-compiler given in the configuration exists
	#
	check_cross_compiler_exists = \
	if ! test -x $(TARGET_CC) ; then \
	echo "Cannot find cross-compiler $(TARGET_CC)" ; \
	exit 1 ; \
	fi ; \

	uclibc: dependencies $(STAMP_DIR)/ext-toolchain-installed

	EXTERNAL_LIBS=libc.so libcrypt.so libdl.so libgcc_s.so libm.so libnsl.so libpthread.so libresolv.so librt.so libutil.so
	ifeq ($(BR2_TOOLCHAIN_EXTERNAL_UCLIBC),y)
	EXTERNAL_LIBS+=ld-uClibc.so
	else
	EXTERNAL_LIBS+=ld-linux.so libnss_files.so
	endif

	ifeq ($(BR2_INSTALL_LIBSTDCPP),y)
	EXTERNAL_LIBS+=libstdc++.so
	endif

	SYSROOT_DIR=$(shell LANG=C $(TARGET_CC) -v 2>&1 \| grep ^Configured \| tr " " "\n" \| grep -- "--with-sysroot" \| cut -f2 -d=)

	$(STAMP_DIR)/ext-toolchain-installed:
	@echo "Checking external toolchain settings"
	$(Q)$(call check_cross_compiler_exists)
	ifeq ($(strip $(SYSROOT_DIR)),)
	@echo "External toolchain doesn't support --sysroot. Cannot use."
	exit 1
	endif
	ifeq ($(BR2_arm),y)
	$(Q)$(call check_arm_abi)
	endif
	ifeq ($(BR2_TOOLCHAIN_EXTERNAL_UCLIBC),y)
	$(Q)$(call check_uclibc,$(SYSROOT_DIR))
	else
	$(Q)$(call check_glibc,$(SYSROOT_DIR))
	endif
	mkdir -p $(TARGET_DIR)/lib
	@echo "Copy external toolchain libraries to target..."
	$(Q)for libs in $(EXTERNAL_LIBS); do \
	$(call copy_toolchain_lib_root,$(SYSROOT_DIR),$$libs,/lib,$(BR2_TOOLCHAIN_EXTERNAL_STRIP)); \
	done
	@echo "Copy external toolchain sysroot to staging..."
	$(Q)$(call copy_toolchain_sysroot,$(SYSROOT_DIR))
	@touch $@