mirror of
https://github.com/brain-hackers/u-boot-brain
synced 2024-06-09 23:36:03 +09:00
eca3aeb352
Like many other projects, U-Boot has a tradition of including big
blocks of License headers in all files. This not only blows up the
source code with mostly redundant information, but also makes it very
difficult to generate License Clearing Reports. An additional problem
is that even the same lincenses are referred to by a number of
slightly varying text blocks (full, abbreviated, different
indentation, line wrapping and/or white space, with obsolete address
information, ...) which makes automatic processing a nightmare.
To make this easier, such license headers in the source files will be
replaced with a single line reference to Unique Lincense Identifiers
as defined by the Linux Foundation's SPDX project [1]. For example,
in a source file the full "GPL v2.0 or later" header text will be
replaced by a single line:
SPDX-License-Identifier: GPL-2.0+
We use the SPDX Unique Lincense Identifiers here; these are available
at [2].
Note: From the legal point of view, this patch is supposed to be only
a change to the textual representation of the license information,
but in no way any change to the actual license terms. With this patch
applied, all files will still be licensed under the same terms they
were before.
Note 2: The apparent difference between the old "COPYING" and the new
"Licenses/gpl-2.0.txt" only results from switching to the upstream
version of the license which is differently formatted; there are not
any actual changes to the content.
Note 3: There are some recurring questions about linense issues, such
as:
- Is a "All Rights Reserved" clause a problem in GPL code?
- Are files without any license header a problem?
- Do we need license headers at all?
The following excerpt from an e-mail by Daniel B. Ravicher should help
with these:
| Message-ID: <4ADF8CAA.5030808@softwarefreedom.org>
| Date: Wed, 21 Oct 2009 18:35:22 -0400
| From: "Daniel B. Ravicher" <ravicher@softwarefreedom.org>
| To: Wolfgang Denk <wd@denx.de>
| Subject: Re: GPL and license cleanup questions
|
| Mr. Denk,
|
| Wolfgang Denk wrote:
| > - There are a number of files which do not include any specific
| > license information at all. Is it correct to assume that these files
| > are automatically covered by the "GPL v2 or later" clause as
| > specified by the COPYING file in the top level directory of the
| > U-Boot source tree?
|
| That is a very fact specific analysis and could be different across the
| various files. However, if the contributor could reasonably be expected
| to have known that the project was licensed GPLv2 or later at the time
| she made her contribution, then a reasonably implication is that she
| consented to her contributions being distributed under those terms.
|
| > - Do such files need any clean up, for example should we add GPL
| > headers to them, or is this not needed?
|
| If the project as a whole is licensed under clear terms, you need not
| identify those same terms in each file, although there is no harm in
| doing so.
|
| > - There are other files, which include both a GPL license header
| > _plus_ some copyright note with an "All Rights Reserved" clause. It
| > has been my understanding that this is a conflict, and me must ask
| > the copyright holders to remove such "All Rights Reserved" clauses.
| > But then, some people claim that "All Rights Reserved" is a no-op
| > nowadays. License checking tools (like OSLC) seem to indicate this is
| > a problem, but then we see quite a lot of "All rights reserved" in
| > BSD-licensed files in gcc and glibc. So what is the correct way to
| > deal with such files?
|
| It is not a conflict to grant a license and also reserve all rights, as
| implicit in that language is that you are reserving all "other" rights
| not granted in the license. Thus, a file with "Licensed under GPL, All
| Rights Reserved" would mean that it is licensed under the GPL, but no
| other rights are given to copy, modify or redistribute it.
|
| Warm regards,
| --Dan
|
| Daniel B. Ravicher, Legal Director
| Software Freedom Law Center (SFLC) and Moglen Ravicher LLC
| 1995 Broadway, 17th Fl., New York, NY 10023
| (212) 461-1902 direct (212) 580-0800 main (212) 580-0898 fax
| ravicher@softwarefreedom.org www.softwarefreedom.org
[1] http://spdx.org/
[2] http://spdx.org/licenses/
Signed-off-by: Wolfgang Denk <wd@denx.de>
366 lines
11 KiB
Makefile
366 lines
11 KiB
Makefile
#
|
|
# (C) Copyright 2000-2013
|
|
# Wolfgang Denk, DENX Software Engineering, wd@denx.de.
|
|
#
|
|
# SPDX-License-Identifier: GPL-2.0+
|
|
#
|
|
#########################################################################
|
|
|
|
# Set shell to bash if possible, otherwise fall back to sh
|
|
SHELL := $(shell if [ -x "$$BASH" ]; then echo $$BASH; \
|
|
else if [ -x /bin/bash ]; then echo /bin/bash; \
|
|
else echo sh; fi; fi)
|
|
|
|
export SHELL
|
|
|
|
ifeq ($(CURDIR),$(SRCTREE))
|
|
dir :=
|
|
else
|
|
dir := $(subst $(SRCTREE)/,,$(CURDIR))
|
|
endif
|
|
|
|
ifneq ($(OBJTREE),$(SRCTREE))
|
|
# Create object files for SPL in a separate directory
|
|
ifeq ($(CONFIG_SPL_BUILD),y)
|
|
obj := $(if $(dir),$(SPLTREE)/$(dir)/,$(SPLTREE)/)
|
|
else
|
|
obj := $(if $(dir),$(OBJTREE)/$(dir)/,$(OBJTREE)/)
|
|
endif
|
|
src := $(if $(dir),$(SRCTREE)/$(dir)/,$(SRCTREE)/)
|
|
|
|
$(shell mkdir -p $(obj))
|
|
else
|
|
# Create object files for SPL in a separate directory
|
|
ifeq ($(CONFIG_SPL_BUILD),y)
|
|
obj := $(if $(dir),$(SPLTREE)/$(dir)/,$(SPLTREE)/)
|
|
|
|
$(shell mkdir -p $(obj))
|
|
else
|
|
obj :=
|
|
endif
|
|
src :=
|
|
endif
|
|
|
|
# clean the slate ...
|
|
PLATFORM_RELFLAGS =
|
|
PLATFORM_CPPFLAGS =
|
|
PLATFORM_LDFLAGS =
|
|
|
|
#########################################################################
|
|
|
|
HOSTCFLAGS = -Wall -Wstrict-prototypes -O2 -fomit-frame-pointer \
|
|
$(HOSTCPPFLAGS)
|
|
HOSTSTRIP = strip
|
|
|
|
#
|
|
# Mac OS X / Darwin's C preprocessor is Apple specific. It
|
|
# generates numerous errors and warnings. We want to bypass it
|
|
# and use GNU C's cpp. To do this we pass the -traditional-cpp
|
|
# option to the compiler. Note that the -traditional-cpp flag
|
|
# DOES NOT have the same semantics as GNU C's flag, all it does
|
|
# is invoke the GNU preprocessor in stock ANSI/ISO C fashion.
|
|
#
|
|
# Apple's linker is similar, thanks to the new 2 stage linking
|
|
# multiple symbol definitions are treated as errors, hence the
|
|
# -multiply_defined suppress option to turn off this error.
|
|
#
|
|
|
|
ifeq ($(HOSTOS),darwin)
|
|
# get major and minor product version (e.g. '10' and '6' for Snow Leopard)
|
|
DARWIN_MAJOR_VERSION = $(shell sw_vers -productVersion | cut -f 1 -d '.')
|
|
DARWIN_MINOR_VERSION = $(shell sw_vers -productVersion | cut -f 2 -d '.')
|
|
|
|
os_x_before = $(shell if [ $(DARWIN_MAJOR_VERSION) -le $(1) -a \
|
|
$(DARWIN_MINOR_VERSION) -le $(2) ] ; then echo "$(3)"; else echo "$(4)"; fi ;)
|
|
|
|
# Snow Leopards build environment has no longer restrictions as described above
|
|
HOSTCC = $(call os_x_before, 10, 5, "cc", "gcc")
|
|
HOSTCFLAGS += $(call os_x_before, 10, 4, "-traditional-cpp")
|
|
HOSTLDFLAGS += $(call os_x_before, 10, 5, "-multiply_defined suppress")
|
|
else
|
|
HOSTCC = gcc
|
|
endif
|
|
|
|
ifeq ($(HOSTOS),cygwin)
|
|
HOSTCFLAGS += -ansi
|
|
endif
|
|
|
|
# We build some files with extra pedantic flags to try to minimize things
|
|
# that won't build on some weird host compiler -- though there are lots of
|
|
# exceptions for files that aren't complaint.
|
|
|
|
HOSTCFLAGS_NOPED = $(filter-out -pedantic,$(HOSTCFLAGS))
|
|
HOSTCFLAGS += -pedantic
|
|
|
|
#########################################################################
|
|
#
|
|
# Option checker, gcc version (courtesy linux kernel) to ensure
|
|
# only supported compiler options are used
|
|
#
|
|
CC_OPTIONS_CACHE_FILE := $(OBJTREE)/include/generated/cc_options.mk
|
|
CC_TEST_OFILE := $(OBJTREE)/include/generated/cc_test_file.o
|
|
|
|
-include $(CC_OPTIONS_CACHE_FILE)
|
|
|
|
cc-option-sys = $(shell mkdir -p $(dir $(CC_TEST_OFILE)); \
|
|
if $(CC) $(CFLAGS) $(1) -S -xc /dev/null -o $(CC_TEST_OFILE) \
|
|
> /dev/null 2>&1; then \
|
|
echo 'CC_OPTIONS += $(strip $1)' >> $(CC_OPTIONS_CACHE_FILE); \
|
|
echo "$(1)"; fi)
|
|
|
|
ifeq ($(CONFIG_CC_OPT_CACHE_DISABLE),y)
|
|
cc-option = $(strip $(if $(call cc-option-sys,$1),$1,$2))
|
|
else
|
|
cc-option = $(strip $(if $(findstring $1,$(CC_OPTIONS)),$1,\
|
|
$(if $(call cc-option-sys,$1),$1,$2)))
|
|
endif
|
|
|
|
# cc-version
|
|
# Usage gcc-ver := $(call cc-version)
|
|
cc-version = $(shell $(SHELL) $(SRCTREE)/tools/gcc-version.sh $(CC))
|
|
binutils-version = $(shell $(SHELL) $(SRCTREE)/tools/binutils-version.sh $(AS))
|
|
|
|
#
|
|
# Include the make variables (CC, etc...)
|
|
#
|
|
AS = $(CROSS_COMPILE)as
|
|
|
|
# Always use GNU ld
|
|
LD = $(shell if $(CROSS_COMPILE)ld.bfd -v > /dev/null 2>&1; \
|
|
then echo "$(CROSS_COMPILE)ld.bfd"; else echo "$(CROSS_COMPILE)ld"; fi;)
|
|
|
|
CC = $(CROSS_COMPILE)gcc
|
|
CPP = $(CC) -E
|
|
AR = $(CROSS_COMPILE)ar
|
|
NM = $(CROSS_COMPILE)nm
|
|
LDR = $(CROSS_COMPILE)ldr
|
|
STRIP = $(CROSS_COMPILE)strip
|
|
OBJCOPY = $(CROSS_COMPILE)objcopy
|
|
OBJDUMP = $(CROSS_COMPILE)objdump
|
|
RANLIB = $(CROSS_COMPILE)RANLIB
|
|
DTC = dtc
|
|
CHECK = sparse
|
|
|
|
#########################################################################
|
|
|
|
# Load generated board configuration
|
|
sinclude $(OBJTREE)/include/autoconf.mk
|
|
sinclude $(OBJTREE)/include/config.mk
|
|
|
|
# Some architecture config.mk files need to know what CPUDIR is set to,
|
|
# so calculate CPUDIR before including ARCH/SOC/CPU config.mk files.
|
|
# Check if arch/$ARCH/cpu/$CPU exists, otherwise assume arch/$ARCH/cpu contains
|
|
# CPU-specific code.
|
|
CPUDIR=arch/$(ARCH)/cpu/$(CPU)
|
|
ifneq ($(SRCTREE)/$(CPUDIR),$(wildcard $(SRCTREE)/$(CPUDIR)))
|
|
CPUDIR=arch/$(ARCH)/cpu
|
|
endif
|
|
|
|
sinclude $(TOPDIR)/arch/$(ARCH)/config.mk # include architecture dependend rules
|
|
sinclude $(TOPDIR)/$(CPUDIR)/config.mk # include CPU specific rules
|
|
|
|
ifdef SOC
|
|
sinclude $(TOPDIR)/$(CPUDIR)/$(SOC)/config.mk # include SoC specific rules
|
|
endif
|
|
ifdef VENDOR
|
|
BOARDDIR = $(VENDOR)/$(BOARD)
|
|
else
|
|
BOARDDIR = $(BOARD)
|
|
endif
|
|
ifdef BOARD
|
|
sinclude $(TOPDIR)/board/$(BOARDDIR)/config.mk # include board specific rules
|
|
endif
|
|
|
|
#########################################################################
|
|
|
|
# We don't actually use $(ARFLAGS) anywhere anymore, so catch people
|
|
# who are porting old code to latest mainline but not updating $(AR).
|
|
ARFLAGS = $(error update your Makefile to use cmd_link_o_target and not AR)
|
|
RELFLAGS= $(PLATFORM_RELFLAGS)
|
|
DBGFLAGS= -g # -DDEBUG
|
|
OPTFLAGS= -Os #-fomit-frame-pointer
|
|
|
|
OBJCFLAGS += --gap-fill=0xff
|
|
|
|
gccincdir := $(shell $(CC) -print-file-name=include)
|
|
|
|
CPPFLAGS := $(DBGFLAGS) $(OPTFLAGS) $(RELFLAGS) \
|
|
-D__KERNEL__
|
|
|
|
# Enable garbage collection of un-used sections for SPL
|
|
ifeq ($(CONFIG_SPL_BUILD),y)
|
|
CPPFLAGS += -ffunction-sections -fdata-sections
|
|
LDFLAGS_FINAL += --gc-sections
|
|
endif
|
|
|
|
# TODO(sjg@chromium.org): Is this correct on Mac OS?
|
|
ifdef CONFIG_FIT_SIGNATURE
|
|
HOSTLIBS += -lssl -lcrypto
|
|
|
|
# This affects include/image.h, but including the board config file
|
|
# is tricky, so manually define this options here.
|
|
HOSTCFLAGS += -DCONFIG_FIT_SIGNATURE
|
|
endif
|
|
|
|
ifneq ($(CONFIG_SYS_TEXT_BASE),)
|
|
CPPFLAGS += -DCONFIG_SYS_TEXT_BASE=$(CONFIG_SYS_TEXT_BASE)
|
|
endif
|
|
|
|
ifneq ($(CONFIG_SPL_TEXT_BASE),)
|
|
CPPFLAGS += -DCONFIG_SPL_TEXT_BASE=$(CONFIG_SPL_TEXT_BASE)
|
|
endif
|
|
|
|
ifneq ($(CONFIG_SPL_PAD_TO),)
|
|
CPPFLAGS += -DCONFIG_SPL_PAD_TO=$(CONFIG_SPL_PAD_TO)
|
|
endif
|
|
|
|
ifneq ($(CONFIG_UBOOT_PAD_TO),)
|
|
CPPFLAGS += -DCONFIG_UBOOT_PAD_TO=$(CONFIG_UBOOT_PAD_TO)
|
|
endif
|
|
|
|
ifeq ($(CONFIG_SPL_BUILD),y)
|
|
CPPFLAGS += -DCONFIG_SPL_BUILD
|
|
endif
|
|
|
|
# Does this architecture support generic board init?
|
|
ifeq ($(__HAVE_ARCH_GENERIC_BOARD),)
|
|
ifneq ($(CONFIG_SYS_GENERIC_BOARD),)
|
|
CHECK_GENERIC_BOARD = $(error Your architecture does not support generic board. \
|
|
Please undefined CONFIG_SYS_GENERIC_BOARD in your board config file)
|
|
endif
|
|
endif
|
|
|
|
ifneq ($(RESET_VECTOR_ADDRESS),)
|
|
CPPFLAGS += -DRESET_VECTOR_ADDRESS=$(RESET_VECTOR_ADDRESS)
|
|
endif
|
|
|
|
ifneq ($(OBJTREE),$(SRCTREE))
|
|
CPPFLAGS += -I$(OBJTREE)/include2 -I$(OBJTREE)/include
|
|
endif
|
|
|
|
CPPFLAGS += -I$(TOPDIR)/include
|
|
CPPFLAGS += -fno-builtin -ffreestanding -nostdinc \
|
|
-isystem $(gccincdir) -pipe $(PLATFORM_CPPFLAGS)
|
|
|
|
CFLAGS := $(CPPFLAGS) -Wall -Wstrict-prototypes
|
|
|
|
ifdef BUILD_TAG
|
|
CFLAGS += -DBUILD_TAG='"$(BUILD_TAG)"'
|
|
endif
|
|
|
|
CFLAGS_SSP := $(call cc-option,-fno-stack-protector)
|
|
CFLAGS += $(CFLAGS_SSP)
|
|
# Some toolchains enable security related warning flags by default,
|
|
# but they don't make much sense in the u-boot world, so disable them.
|
|
CFLAGS_WARN := $(call cc-option,-Wno-format-nonliteral) \
|
|
$(call cc-option,-Wno-format-security)
|
|
CFLAGS += $(CFLAGS_WARN)
|
|
|
|
# Report stack usage if supported
|
|
CFLAGS_STACK := $(call cc-option,-fstack-usage)
|
|
CFLAGS += $(CFLAGS_STACK)
|
|
|
|
BCURDIR = $(subst $(SRCTREE)/,,$(CURDIR:$(obj)%=%))
|
|
|
|
ifeq ($(findstring examples/,$(BCURDIR)),)
|
|
ifeq ($(CONFIG_SPL_BUILD),)
|
|
ifdef FTRACE
|
|
CFLAGS += -finstrument-functions -DFTRACE
|
|
endif
|
|
endif
|
|
endif
|
|
|
|
# $(CPPFLAGS) sets -g, which causes gcc to pass a suitable -g<format>
|
|
# option to the assembler.
|
|
AFLAGS_DEBUG :=
|
|
|
|
# turn jbsr into jsr for m68k
|
|
ifeq ($(ARCH),m68k)
|
|
ifeq ($(findstring 3.4,$(shell $(CC) --version)),3.4)
|
|
AFLAGS_DEBUG := -Wa,-gstabs,-S
|
|
endif
|
|
endif
|
|
|
|
AFLAGS := $(AFLAGS_DEBUG) -D__ASSEMBLY__ $(CPPFLAGS)
|
|
|
|
LDFLAGS += $(PLATFORM_LDFLAGS)
|
|
LDFLAGS_FINAL += -Bstatic
|
|
|
|
LDFLAGS_u-boot += -T $(obj)u-boot.lds $(LDFLAGS_FINAL)
|
|
ifneq ($(CONFIG_SYS_TEXT_BASE),)
|
|
LDFLAGS_u-boot += -Ttext $(CONFIG_SYS_TEXT_BASE)
|
|
endif
|
|
|
|
LDFLAGS_u-boot-spl += -T $(obj)u-boot-spl.lds $(LDFLAGS_FINAL)
|
|
ifneq ($(CONFIG_SPL_TEXT_BASE),)
|
|
LDFLAGS_u-boot-spl += -Ttext $(CONFIG_SPL_TEXT_BASE)
|
|
endif
|
|
|
|
# Linus' kernel sanity checking tool
|
|
CHECKFLAGS := -D__linux__ -Dlinux -D__STDC__ -Dunix -D__unix__ \
|
|
-Wbitwise -Wno-return-void -D__CHECK_ENDIAN__ $(CF)
|
|
|
|
# Location of a usable BFD library, where we define "usable" as
|
|
# "built for ${HOST}, supports ${TARGET}". Sensible values are
|
|
# - When cross-compiling: the root of the cross-environment
|
|
# - Linux/ppc (native): /usr
|
|
# - NetBSD/ppc (native): you lose ... (must extract these from the
|
|
# binutils build directory, plus the native and U-Boot include
|
|
# files don't like each other)
|
|
#
|
|
# So far, this is used only by tools/gdb/Makefile.
|
|
|
|
ifeq ($(HOSTOS),darwin)
|
|
BFD_ROOT_DIR = /usr/local/tools
|
|
else
|
|
ifeq ($(HOSTARCH),$(ARCH))
|
|
# native
|
|
BFD_ROOT_DIR = /usr
|
|
else
|
|
#BFD_ROOT_DIR = /LinuxPPC/CDK # Linux/i386
|
|
#BFD_ROOT_DIR = /usr/pkg/cross # NetBSD/i386
|
|
BFD_ROOT_DIR = /opt/powerpc
|
|
endif
|
|
endif
|
|
|
|
#########################################################################
|
|
|
|
export HOSTCC HOSTCFLAGS HOSTLDFLAGS PEDCFLAGS HOSTSTRIP CROSS_COMPILE \
|
|
AS LD CC CPP AR NM STRIP OBJCOPY OBJDUMP MAKE
|
|
export CONFIG_SYS_TEXT_BASE PLATFORM_CPPFLAGS PLATFORM_RELFLAGS CPPFLAGS CFLAGS AFLAGS
|
|
|
|
#########################################################################
|
|
|
|
# Allow boards to use custom optimize flags on a per dir/file basis
|
|
ALL_AFLAGS = $(AFLAGS) $(AFLAGS_$(BCURDIR)/$(@F)) $(AFLAGS_$(BCURDIR))
|
|
ALL_CFLAGS = $(CFLAGS) $(CFLAGS_$(BCURDIR)/$(@F)) $(CFLAGS_$(BCURDIR))
|
|
EXTRA_CPPFLAGS = $(CPPFLAGS_$(BCURDIR)/$(@F)) $(CPPFLAGS_$(BCURDIR))
|
|
ALL_CFLAGS += $(EXTRA_CPPFLAGS)
|
|
|
|
# The _DEP version uses the $< file target (for dependency generation)
|
|
# See rules.mk
|
|
EXTRA_CPPFLAGS_DEP = $(CPPFLAGS_$(BCURDIR)/$(addsuffix .o,$(basename $<))) \
|
|
$(CPPFLAGS_$(BCURDIR))
|
|
$(obj)%.s: %.S
|
|
$(CPP) $(ALL_AFLAGS) -o $@ $<
|
|
$(obj)%.o: %.S
|
|
$(CC) $(ALL_AFLAGS) -o $@ $< -c
|
|
$(obj)%.o: %.c
|
|
ifneq ($(CHECKSRC),0)
|
|
$(CHECK) $(CHECKFLAGS) $(ALL_CFLAGS) $<
|
|
endif
|
|
$(CC) $(ALL_CFLAGS) -o $@ $< -c
|
|
$(obj)%.i: %.c
|
|
$(CPP) $(ALL_CFLAGS) -o $@ $< -c
|
|
$(obj)%.s: %.c
|
|
$(CC) $(ALL_CFLAGS) -o $@ $< -c -S
|
|
|
|
#########################################################################
|
|
|
|
# If the list of objects to link is empty, just create an empty built-in.o
|
|
cmd_link_o_target = $(if $(strip $1),\
|
|
$(LD) $(LDFLAGS) -r -o $@ $1,\
|
|
rm -f $@; $(AR) rcs $@ )
|
|
|
|
#########################################################################
|