source: mainline/uspace/Makefile.common@ 9317f45

#
# Copyright (c) 2005 Martin Decky
# Copyright (c) 2007 Jakub Jermar
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
#
# - Redistributions of source code must retain the above copyright
#   notice, this list of conditions and the following disclaimer.
# - Redistributions in binary form must reproduce the above copyright
#   notice, this list of conditions and the following disclaimer in the
#   documentation and/or other materials provided with the distribution.
# - The name of the author may not be used to endorse or promote products
#   derived from this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#

# Individual makefiles set:
#
#   USPACE_PREFIX  (*) relative path to uspace/ directory
#   SOURCES        (*) list of source files
#   LIBS               libraries to link with
#   DEFS               compiler defines
#   EXTRA_CFLAGS       additional flags to pass to C compiler
#   LINKER_SCRIPT      linker script
#   PRE_DEPEND         targets required for dependency check
#
#   BINARY         (/) binary output name (like appname)
#   LIBRARY        (/) library output name (like libname)
#
#   EXTRA_OUTPUT       additional output targets
#   EXTRA_CLEAN        additional cleanup targets
#
# Optionally, for a binary:
#   STATIC_NEEDED      set to 'y' for init binaries, will build statically
#                      linked version
#   STATIC_ONLY        set to 'y' if binary cannot be linked dynamically
#                      (e.g. uses thread-local variables)
#
# Optionally, for a library:
#   SOVERSION            shared library version (major.minor),
#                        if missing, no shared library is built
#
# (x) required variables
# (/) exactly one of the variables must be defined
#

ROOT_PATH = $(USPACE_PREFIX)/..

VERSION_DEF = $(ROOT_PATH)/version

COMMON_MAKEFILE = $(ROOT_PATH)/Makefile.common
COMMON_HEADER = $(ROOT_PATH)/common.h

CONFIG_MAKEFILE = $(ROOT_PATH)/Makefile.config
CONFIG_HEADER = $(ROOT_PATH)/config.h

-include $(VERSION_DEF)
-include $(COMMON_MAKEFILE)
-include $(CONFIG_MAKEFILE)

OUTPUTS = $(EXTRA_OUTPUT)

ifneq ($(BINARY),)
        JOB = $(BINARY).job
        TEST_BINARY = test-$(BINARY)
        OUTPUTS += $(BINARY) $(BINARY).disasm
        EXTRA_CLEAN += $(BINARY).map
endif

ifneq ($(LIBRARY),)
        JOB = $(LIBRARY).job
        TEST_BINARY = test-$(LIBRARY)
        OUTPUTS += $(LIBRARY).a
endif

ifeq ($(CONFIG_BUILD_SHARED_LIBS),y)
        ifneq ($(SOVERSION),)
                SLIBRARY = $(LIBRARY).so.$(SOVERSION)
                LSONAME = $(LIBRARY).so.$(basename $(SOVERSION))
                OUTPUTS += $(SLIBRARY) $(SLIBRARY).disasm $(LSONAME)
                EXTRA_CLEAN += $(LIBRARY).la $(SLIBRARY).map
        endif
endif

LIB_PREFIX = $(USPACE_PREFIX)/lib

LIBC_PREFIX = $(LIB_PREFIX)/c
LIBC_INCLUDES_FLAGS = \
        -I$(LIBC_PREFIX)/include \
        -I$(LIBC_PREFIX)/arch/$(UARCH)/include \
        -I$(ROOT_PATH)/abi/include

LIBCPP_PREFIX = $(LIB_PREFIX)/cpp
LIBCPP_INCLUDES_FLAGS = -I$(LIBCPP_PREFIX)/include

LIBSOFTFLOAT_PREFIX = $(LIB_PREFIX)/softfloat
LIBSOFTINT_PREFIX = $(LIB_PREFIX)/softint

LIBMATH_PREFIX = $(LIB_PREFIX)/math
LIBMATH_INCLUDES_FLAGS = \
        -I$(LIBMATH_PREFIX)/include \
        -I$(LIBMATH_PREFIX)/arch/$(UARCH)/include

LIBPOSIX_PREFIX = $(LIB_PREFIX)/posix
LIBDLTEST_PREFIX = $(LIB_PREFIX)/dltest

AFLAGS = --fatal-warnings
LDFLAGS = -Wl,--fatal-warnings,--warn-common

ifeq ($(STATIC_NEEDED),y)
        STATIC_BUILD = y
else
        ifeq ($(STATIC_ONLY),y)
                STATIC_BUILD = y
        else
                ifeq ($(CONFIG_USE_SHARED_LIBS),y)
                        STATIC_BUILD = n
                else
                        STATIC_BUILD = y
                endif
        endif
endif

ifeq ($(STATIC_BUILD),y)
        BASE_LIBS = $(LIBC_PREFIX)/libc.a
else
        BASE_LIBS = $(LIBC_PREFIX)/libc.so.0
        LINK_DYNAMIC = y
endif

BASE_LIBS += $(LIBSOFTFLOAT_PREFIX)/libsoftfloat.a $(LIBSOFTINT_PREFIX)/libsoftint.a

ifeq ($(LINK_DYNAMIC),y)
        LINKER_SCRIPT ?= $(LIBC_PREFIX)/arch/$(UARCH)/_link-dlexe.ld
else
        LDFLAGS += -static
        LINKER_SCRIPT ?= $(LIBC_PREFIX)/arch/$(UARCH)/_link.ld
endif

LIB_LINKER_SCRIPT = $(LIBC_PREFIX)/arch/$(UARCH)/_link-shlib.ld

INCLUDES_FLAGS = $(LIBC_INCLUDES_FLAGS)

ifneq ($(LIBRARY),)
        INCLUDES_FLAGS += -Iinclude -I.
endif

INCLUDES_FLAGS += $(foreach lib,$(LIBS), -I$(LIB_PREFIX)/$(lib) -I$(LIB_PREFIX)/$(lib)/include)

# TODO: get rid of this special case
ifneq ($(filter math, $(LIBS)),)
        INCLUDES_FLAGS += $(LIBMATH_INCLUDES_FLAGS)
endif

# PCUT-based unit tests
ifneq ($(TEST_SOURCES),)
        TEST_OUTPUTS = $(TEST_BINARY) $(TEST_BINARY).disasm
        TEST_CFLAGS = -I$(LIB_PREFIX)/pcut/include -D__helenos__ $(EXTRA_TEST_CFLAGS)
        TEST_BINARY_LIBS = $(LIB_PREFIX)/pcut/libpcut.a
        EXTRA_CLEAN += $(TEST_OUTPUTS) $(TEST_BINARY).map
ifneq ($(LIBRARY),)
        TEST_BINARY_LIBS += $(LIBRARY).a
endif
        TEST_BINARY_LIBS += $(TEST_LIBS)
endif

# Flags that are not necessary, and can be overriden, but are used by default.
DEFAULT_CFLAGS = \
        -O$(OPTIMIZATION) \
        -ffunction-sections \
        -pipe \
        -Wall \
        -Wextra \
        -Wno-unused-parameter \
        -Wmissing-prototypes \
        -Wwrite-strings \
        -Werror-implicit-function-declaration

ifeq ($(CONFIG_DEBUG),y)
        DEFAULT_CFLAGS += -Werror
endif

ifeq ($(CONFIG_UBSAN),y)
        DEFAULT_CFLAGS += -fsanitize=undefined
endif

ifeq ($(COMPILER),clang)
        DEFAULT_CFLAGS += \
                -Wno-missing-field-initializers \
                -Wno-typedef-redefinition \
                -Wno-unused-command-line-argument
else
        DEFAULT_CFLAGS += \
                -Wno-clobbered
endif

ifeq ($(CONFIG_LINE_DEBUG),y)
        DEFAULT_CFLAGS += -ggdb
endif

# Flags that should always be used, even for third-party software.
COMMON_CPPFLAGS = \
        -nostdinc \
        -D__$(ENDIANESS)__

COMMON_CFLAGS = \
        -ffreestanding \
        -nostdlib

# Flags that are always used for HelenOS code, but not for third-party.
HELENOS_CFLAGS = \
        -std=gnu99 \
        $(INCLUDES_FLAGS) \
        -imacros $(CONFIG_HEADER) \
        -D_HELENOS_SOURCE \
        -fexec-charset=UTF-8 \
        -finput-charset=UTF-8 \
        -fno-common \
        -fdebug-prefix-map=$(realpath $(ROOT_PATH))=.

# TODO: Use a different name.
# CFLAGS variable is traditionally used for overridable flags.
CFLAGS = $(COMMON_CPPFLAGS) $(COMMON_CFLAGS) $(HELENOS_CFLAGS) $(DEFAULT_CFLAGS)

# Flags for the compilation of C++ code.
CPPFLAGS = $(LIBCPP_INCLUDES_FLAGS) $(INCLUDES_FLAGS) -O$(OPTIMIZATION) -imacros $(CONFIG_HEADER) \
        -fexec-charset=UTF-8 -fwide-exec-charset=UTF-32$(ENDIANESS) \
        -finput-charset=UTF-8 -ffreestanding -fno-builtin -ffunction-sections \
        -nostdlib -nostdinc -Wall -Wextra -Wno-clobbered -Wno-unused-parameter \
        -std=c++17 -Werror-implicit-function-declaration \
        -Wwrite-strings -pipe -ggdb -D__$(ENDIANESS)__

## Setup platform configuration
#

-include $(LIBC_PREFIX)/arch/$(UARCH)/Makefile.common

## Compilation options
#

ifeq ($(PRECHECK),y)
        JOBFILE = $(LIBC_PREFIX)/../../../tools/jobfile.py
        # XXX: Do not change the order of arguments.
        CC_JOB = $(JOBFILE) $(JOB) $(CC) $< -o $@
else
        CC_JOB = $(CC) $< -o $@
endif

ifeq ($(CONFIG_STRIP_BINARIES),y)
        LDFLAGS += -s
endif

LIB_CFLAGS = $(CFLAGS) -fPIC
LIB_LDFLAGS = $(LDFLAGS) -shared -Wl,-soname,$(LSONAME)

AS_CFLAGS := $(addprefix -Xassembler ,$(AFLAGS))

OBJECTS := $(addsuffix .o,$(basename $(SOURCES)))
LOBJECTS := $(addsuffix .lo,$(basename $(SOURCES)))
TEST_OBJECTS := $(addsuffix .test.o,$(basename $(TEST_SOURCES)))
DEPENDS := $(addsuffix .d,$(basename $(SOURCES))) $(addsuffix .test.d,$(basename $(TEST_SOURCES)))

LIBTAGS := $(foreach lib,$(LIBS), $(USPACE_PREFIX)/lib/$(lib)/tag)
LIBARGS := $(addprefix -L$(USPACE_PREFIX)/lib/, $(LIBS)) $(addprefix -l, $(LIBS))

.PHONY: all all-test clean fasterclean depend

all: tag $(OUTPUTS)

all-test: $(TEST_OUTPUTS)

clean: fasterclean
        find . -name '*.o' -follow -exec rm \{\} \;
        find . -name '*.lo' -follow -exec rm \{\} \;
        find . -name '*.d' -follow -exec rm \{\} \;

fasterclean:
        rm -rf $(JOB) $(OUTPUTS) $(EXTRA_CLEAN) tag deps.mk

depend: $(PRE_DEPEND)

# "Tag" files are used to force relink of binaries when dependencies get rebuilt,
# regardless of whether the dependency was linked statically or dynamically,
# or which version of a dynamic library was used. Prerequisites for this file
# are defined further down.
tag:
        touch tag

# Generate inter-module make dependencies.
# This is needed to ensure correct build order of libraries and code depending on them.
deps.mk: Makefile
        echo > $@.new
        for lib in $(LIBS); do \
                echo "$(SELF_TARGET): lib/$$lib.build" >> $@.new; \
        done
        mv -f $@.new $@

%.disasm: %
ifeq ($(CONFIG_LINE_DEBUG),y)
        $(OBJDUMP) -d -S $< > $@
else
        $(OBJDUMP) -d $< > $@
endif

ifneq ($(BINARY),)
$(BINARY): $(LINKER_SCRIPT) $(OBJECTS) $(LIBTAGS) $(BASE_LIBS)
        $(CC) $(CFLAGS) $(LDFLAGS) $(EXTRA_LDFLAGS) -T $(LINKER_SCRIPT) -Wl,-Map,$@.map -o $@ $(OBJECTS) $(LIBARGS) $(BASE_LIBS)
endif

ifneq ($(TEST_BINARY),)
$(TEST_BINARY): $(LINKER_SCRIPT) $(TEST_OBJECTS) $(TEST_BINARY_LIBS) $(LIBTAGS) $(BASE_LIBS)
        $(CC) $(CFLAGS) $(LDFLAGS) $(EXTRA_LDFLAGS) -T $(LINKER_SCRIPT) -Wl,-Map,$@.map -o $@ $(TEST_OBJECTS) $(TEST_BINARY_LIBS) $(LIBARGS) $(BASE_LIBS)
endif

ifneq ($(LIBRARY),)
tag: $(LIBRARY).a

$(LIBRARY).a: $(OBJECTS)
        $(AR) rc $@ $(OBJECTS)
endif

ifneq ($(SLIBRARY),)
tag: $(SLIBRARY)

$(LIBRARY).la: $(LOBJECTS)
        $(AR) rc $@ $(LOBJECTS)

$(SLIBRARY): $(LIB_LINKER_SCRIPT) $(LIBRARY).la
        $(CC) $(CFLAGS) $(LIB_LDFLAGS) $(EXTRA_LDFLAGS) -T $(LIB_LINKER_SCRIPT) -Wl,-Map,$@.map -o $@ -Wl,--whole-archive $(LIBRARY).la -Wl,--no-whole-archive

$(LSONAME):
        ln -s $(SLIBRARY) $@
endif

%.o: %.S | depend
        $(CC_JOB) -c -MD -MP $(DEFS) $(CFLAGS) $(EXTRA_CFLAGS) $(AS_CFLAGS)

%.o: %.s | depend
        $(CC_JOB) -c -MD -MP $(DEFS) $(CFLAGS) $(EXTRA_CFLAGS) $(AS_CFLAGS)

%.o: %.c | depend
        $(CC_JOB) -c -MD -MP $(DEFS) $(CFLAGS) $(EXTRA_CFLAGS)

%.o: %.cpp | depend
        $(CPP) $(CPPFLAGS) $(EXTRA_CPPFLAGS) -c $< -o $@

%.test.o: %.c | depend
        $(CC_JOB) -c -MD -MP $(DEFS) $(CFLAGS) $(EXTRA_CFLAGS) $(TEST_CFLAGS)

%.lo: %.S | depend
        $(CC_JOB) -c -MD -MP $(DEFS) $(LIB_CFLAGS) $(EXTRA_CFLAGS) $(AS_CFLAGS)

%.lo: %.s | depend
        $(CC_JOB) -c -MD -MP $(DEFS) $(LIB_CFLAGS) $(EXTRA_CFLAGS) $(AS_CFLAGS)

%.lo: %.c | depend
        $(CC_JOB) -c -MD -MP $(DEFS) $(LIB_CFLAGS) $(EXTRA_CFLAGS)

-include $(DEPENDS)