Makefile.tc.in

#
# Toolchain sub-Makefile
#
# Copyright (C) 2020-2026 Gabriele Galeotti
#
# This work is licensed under the terms of the MIT License.
# Please consult the LICENSE.txt file located in the top-level directory.
#

#
# Environment variables:
# OSTYPE
# PATH
# EXEEXT
# SCREXT
# VERBOSE
# PLATFORM_GOALS
# MAKECMDGOALS
# INFOCONFIG_GOALS
# SWEETADA_PATH
# TOOLCHAIN_PREFIX
# TOOLCHAIN_NAME
# RTS_DIRECTORY
# RTS
# ADA_MODE
# STACK_LIMIT
# BUILD_MODE
# OPTIMIZATION_LEVEL
# OBJECT_DIRECTORY
# KERNEL_BASENAME
# ENABLE_SPLIT_DWARF
# CONFIGURE_DEPS
#

################################################################################
#                                                                              #
# Toolchain initialization.                                                    #
#                                                                              #
################################################################################

ifneq ($(TOOLCHAIN_NAME),)

TOOLCHAIN_PROGRAM_PREFIX := $(TOOLCHAIN_NAME)-
# raw compiler executable used for 1) retrieve informations, and 2) back-end
# in the GNATMAKE wrapper
# NOTE: this is not the same as TOOLCHAIN_CC, which is possibly used to
# compile C source files
TOOLCHAIN_GCC := $(TOOLCHAIN_PROGRAM_PREFIX)gcc$(EXEEXT)

# detect GCC compiler
ifeq ($(OSTYPE),cmd)
GCC_VERSION := $(shell SET "PATH=$(PATH)" && $(TOOLCHAIN_GCC) -dumpversion 2>nul)
else
GCC_VERSION := $(shell PATH="$(PATH)" $(TOOLCHAIN_GCC) -dumpversion 2> /dev/null)
endif
ifneq ($(filter rts $(PLATFORM_GOALS),$(MAKECMDGOALS)),)
ifeq ($(GCC_VERSION),)
# no valid toolchain found, output a warning message
$(warning *** Warning: no valid toolchain.)
endif
endif

# these must be computed after configuration variables are set; different
# options could lead to different multilib library directories
# GCC_MULTIDIR is the multilib directory inside the library search directory
# NOTE: this is different from "-print-multi-lib", which prints all multilibs
ifeq ($(OSTYPE),cmd)
GCC_MULTILIBS   := $(shell                       \
                     SET "PATH=$(PATH)"       && \
                     $(TOOLCHAIN_GCC)            \
                       -print-multi-lib 2>nul    \
                     )
GCC_MULTIDIR    := $(shell                             \
                     SET "PATH=$(PATH)"             && \
                     $(TOOLCHAIN_GCC)                  \
                       $(GCC_SWITCHES_PLATFORM)        \
                       -print-multi-directory 2>nul    \
                     )
LIBGCC_FILENAME := $(shell                              \
                     SET "PATH=$(PATH)"              && \
                     $(TOOLCHAIN_GCC)                   \
                       $(GCC_SWITCHES_PLATFORM)         \
                       -print-libgcc-file-name 2>nul    \
                     )
else
GCC_MULTILIBS   := $(shell                           \
                     PATH="$(PATH)"                  \
                     $(TOOLCHAIN_GCC)                \
                       -print-multi-lib 2> /dev/null \
                     )
GCC_MULTIDIR    := $(shell                                 \
                     PATH="$(PATH)"                        \
                     $(TOOLCHAIN_GCC)                      \
                       $(GCC_SWITCHES_PLATFORM)            \
                       -print-multi-directory 2> /dev/null \
                     )
LIBGCC_FILENAME := $(shell                                  \
                     PATH="$(PATH)"                         \
                     $(TOOLCHAIN_GCC)                       \
                       $(GCC_SWITCHES_PLATFORM)             \
                       -print-libgcc-file-name 2> /dev/null \
                     )
endif

# libm
LIBM_FILENAME := $(TOOLCHAIN_PREFIX)/$(TOOLCHAIN_NAME)/lib/$(GCC_MULTIDIR)/libm.a

endif

################################################################################
#                                                                              #
# Define toolchain components.                                                 #
#                                                                              #
################################################################################

# basic toolchain executables
TOOLCHAIN_AS       := $(TOOLCHAIN_PROGRAM_PREFIX)as$(EXEEXT)
TOOLCHAIN_ADAC     := $(TOOLCHAIN_PROGRAM_PREFIX)gcc$(EXEEXT)
TOOLCHAIN_CC       := $(TOOLCHAIN_PROGRAM_PREFIX)gcc$(EXEEXT)
TOOLCHAIN_CPP      := $(TOOLCHAIN_PROGRAM_PREFIX)cpp$(EXEEXT)
TOOLCHAIN_GNATCHOP := $(TOOLCHAIN_PROGRAM_PREFIX)gnatchop$(EXEEXT)
TOOLCHAIN_GNATBIND := $(TOOLCHAIN_PROGRAM_PREFIX)gnatbind$(EXEEXT)
TOOLCHAIN_GNATLINK := $(TOOLCHAIN_PROGRAM_PREFIX)gnatlink$(EXEEXT)
TOOLCHAIN_GNATLS   := $(TOOLCHAIN_PROGRAM_PREFIX)gnatls$(EXEEXT)
TOOLCHAIN_GNATPREP := $(TOOLCHAIN_PROGRAM_PREFIX)gnatprep$(EXEEXT)
TOOLCHAIN_GNATXREF := $(TOOLCHAIN_PROGRAM_PREFIX)gnatxref$(EXEEXT)
TOOLCHAIN_AR       := $(TOOLCHAIN_PROGRAM_PREFIX)ar$(EXEEXT)
TOOLCHAIN_GDB      := $(TOOLCHAIN_PROGRAM_PREFIX)gdb$(EXEEXT)
TOOLCHAIN_LD       := $(TOOLCHAIN_PROGRAM_PREFIX)ld$(EXEEXT)
TOOLCHAIN_NM       := $(TOOLCHAIN_PROGRAM_PREFIX)nm$(EXEEXT)
TOOLCHAIN_OBJCOPY  := $(TOOLCHAIN_PROGRAM_PREFIX)objcopy$(EXEEXT)
TOOLCHAIN_OBJDUMP  := $(TOOLCHAIN_PROGRAM_PREFIX)objdump$(EXEEXT)
TOOLCHAIN_RANLIB   := $(TOOLCHAIN_PROGRAM_PREFIX)ranlib$(EXEEXT)
TOOLCHAIN_READELF  := $(TOOLCHAIN_PROGRAM_PREFIX)readelf$(EXEEXT)
TOOLCHAIN_SIZE     := $(TOOLCHAIN_PROGRAM_PREFIX)size$(EXEEXT)
TOOLCHAIN_STRIP    := $(TOOLCHAIN_PROGRAM_PREFIX)strip$(EXEEXT)

ifneq ($(filter $(INFOCONFIG_GOALS),$(MAKECMDGOALS)),)
ifeq ($(OSTYPE),cmd)
AS_VERSION := $(shell                                                \
                SET "PATH=$(PATH)"                                && \
                SET "SWEETADA_PATH=$(SWEETADA_PATH)"              && \
                SET "LIBUTILS_DIRECTORY=$(LIBUTILS_DIRECTORY)"    && \
                $(TOOLCHAIN_AS) --version 2>nul| $(FILEHEAD) -n 1    \
                )
LD_VERSION := $(shell                                                \
                SET "PATH=$(PATH)"                                && \
                SET "SWEETADA_PATH=$(SWEETADA_PATH)"              && \
                SET "LIBUTILS_DIRECTORY=$(LIBUTILS_DIRECTORY)"    && \
                $(TOOLCHAIN_LD) --version 2>nul| $(FILEHEAD) -n 1    \
                )
else
AS_VERSION := $(shell                                                     \
                PATH="$(PATH)"                                            \
                $(TOOLCHAIN_AS) --version 2> /dev/null | $(FILEHEAD) -n 1 \
                )
LD_VERSION := $(shell                                                     \
                PATH="$(PATH)"                                            \
                $(TOOLCHAIN_LD) --version 2> /dev/null | $(FILEHEAD) -n 1 \
                )
endif
endif

# nature of compilers
TOOLCHAIN_ADAC += -x ada

# C compiler has no system libraries
TOOLCHAIN_CC += -ffreestanding

ifeq      ($(ADA_MODE),ADA95)
TOOLCHAIN_ADAC += -gnat95
else ifeq ($(ADA_MODE),ADA05)
TOOLCHAIN_ADAC += -gnat2005
else ifeq ($(ADA_MODE),ADA12)
TOOLCHAIN_ADAC += -gnat2012
else ifeq ($(ADA_MODE),ADA22)
TOOLCHAIN_ADAC += -gnat2022
else
$(warning *** Warning: no valid ADA_MODE.)
endif

################################################################################
#                                                                              #
# Basic toolchain commands and default switches.                               #
#                                                                              #
################################################################################

AS       := $(TOOLCHAIN_AS)
ADAC     := $(TOOLCHAIN_ADAC)
CC       := $(TOOLCHAIN_CC)
CPP      := $(TOOLCHAIN_CPP)
GNATBIND := $(TOOLCHAIN_GNATBIND)
GNATCHOP := $(TOOLCHAIN_GNATCHOP)
GNATLINK := $(TOOLCHAIN_GNATLINK)
GNATLS   := $(TOOLCHAIN_GNATLS)
GNATPREP := $(TOOLCHAIN_GNATPREP)
GNATXREF := $(TOOLCHAIN_GNATXREF)
AR       := $(TOOLCHAIN_AR)
GDB      := $(TOOLCHAIN_GDB)
LD       := $(TOOLCHAIN_LD)
NM       := $(TOOLCHAIN_NM)
OBJCOPY  := $(TOOLCHAIN_OBJCOPY)
OBJDUMP  := $(TOOLCHAIN_OBJDUMP)
RANLIB   := $(TOOLCHAIN_RANLIB)
READELF  := $(TOOLCHAIN_READELF)
SIZE     := $(TOOLCHAIN_SIZE)
STRIP    := $(TOOLCHAIN_STRIP)

################################################################################
#                                                                              #
# RTS.                                                                         #
#                                                                              #
################################################################################

ifeq ($(OSTYPE),cmd)
$(foreach s,                                                 \
  $(subst |,$(SPACE),$(subst $(SPACE),$(DEL),$(shell         \
    SET "VERBOSE="                                        && \
    SET "PATH=$(PATH)"                                    && \
    SET "KERNEL_PARENT_PATH=.."                           && \
    SET "CPU=$(CPU)"                                      && \
    SET "RTS=$(RTS)"                                      && \
    SET "TOOLCHAIN_NAME=$(TOOLCHAIN_NAME)"                && \
    SET "MULTILIB=$(GCC_MULTIDIR)"                        && \
    "$(MAKE)"                                                \
      --debug=n                                              \
      --no-print-directory                                   \
      -C $(RTS_DIRECTORY)                                    \
      PROBEVARIABLES="                                       \
        RTS_PATH                                             \
        RTS_INSTALLED                                        \
        ADAC_SWITCHES_RTS                                    \
        CC_SWITCHES_RTS                                      \
        SUPPRESS_STANDARD_LIBRARY                            \
        LIBGNAT                                              \
        LIBGNARL                                             \
        "                                                    \
      probevariables                                         \
    2>nul))),$(eval $(strip $(subst $(DEL),$(SPACE),$(s)))))
else
$(foreach s,                                                        \
  $(subst |,$(SPACE),$(subst $(SPACE),$(DEL),$(shell                \
    VERBOSE=                                                        \
    PATH="$(PATH)"                                                  \
    KERNEL_PARENT_PATH=..                                           \
    CPU=$(CPU)                                                      \
    RTS=$(RTS)                                                      \
    TOOLCHAIN_NAME=$(TOOLCHAIN_NAME)                                \
    MULTILIB=$(GCC_MULTIDIR)                                        \
    "$(MAKE)"                                                       \
      --debug=n                                                     \
      --no-print-directory                                          \
      -C $(RTS_DIRECTORY)                                           \
      PROBEVARIABLES="                                              \
        RTS_PATH                                                    \
        RTS_INSTALLED                                               \
        ADAC_SWITCHES_RTS                                           \
        CC_SWITCHES_RTS                                             \
        SUPPRESS_STANDARD_LIBRARY                                   \
        LIBGNAT                                                     \
        LIBGNARL                                                    \
        "                                                           \
      probevariables                                                \
    2> /dev/null))),$(eval $(strip $(subst $(DEL),$(SPACE),$(s)))))
endif

RTS_PATH := $(SWEETADA_PATH)/$(RTS_DIRECTORY)/$(RTS_PATH)

# add RTS and import switches
ADAC     += --RTS="$(RTS_PATH)"
GNATLS   += --RTS="$(RTS_PATH)"
GNATBIND += --RTS="$(RTS_PATH)"

################################################################################
#                                                                              #
# Basic switches.                                                              #
#                                                                              #
################################################################################

# AS
AS_SWITCHES_DEFAULT       +=

# ADAC
ADAC_SWITCHES_DEFAULT     += $(ADAC_SWITCHES_RTS)

# CC
CC_SWITCHES_DEFAULT       += $(CC_SWITCHES_RTS)

# CPP
CPP_SWITCHES_DEFAULT      +=

# GNATBIND
GNATBIND_SWITCHES_DEFAULT += -nostdinc
GNATBIND_SWITCHES_DEFAULT += -nostdlib

# GNATCHOP
GNATCHOP_SWITCHES_DEFAULT +=

# GNATLINK
GNATLINK_SWITCHES_DEFAULT +=

# GNATLS
GNATLS_SWITCHES_DEFAULT   +=

# GNATPREP
# Use LF as line terminators when writing files.
GNATPREP_SWITCHES_DEFAULT += -T
# Causes both preprocessor lines and the lines deleted by preprocessing to be
# retained in the output source as comments marked with the special string "--! ".
GNATPREP_SWITCHES_DEFAULT += -c

# GNATXREF
GNATXREF_SWITCHES_DEFAULT +=

# AR
AR_SWITCHES_DEFAULT       +=

# LD
LD_SWITCHES_DEFAULT       += -Map $(KERNEL_BASENAME).map
LD_SWITCHES_DEFAULT       += --cref
LD_SWITCHES_DEFAULT       += --warn-common
LD_SWITCHES_DEFAULT       += --warn-section-align
#LD_SWITCHES_DEFAULT       += --no-warn-rwx-segments
LD_SWITCHES_DEFAULT       += --print-memory-usage
LD_SWITCHES_DEFAULT       += --gc-sections
LD_SWITCHES_DEFAULT       += -g

# NM
NM_SWITCHES_DEFAULT       +=

# OBJCOPY
OBJCOPY_SWITCHES_DEFAULT  +=

# OBJDUMP
OBJDUMP_SWITCHES_DEFAULT  += --demangle=gnat

# RANLIB
RANLIB_SWITCHES_DEFAULT   +=

# READELF
# Equivalent to specifying --file-header, --program-headers, --sections,
# --symbols, --relocs, --dynamic, --notes, --version-info, --arch-specific,
# --unwind, --section-groups and --histogram.
READELF_SWITCHES_DEFAULT  += --all
# Displays the detailed section information.
#READELF_SWITCHES_DEFAULT  += -t
# Don't break output lines to fit into 80 columns.
READELF_SWITCHES_DEFAULT  += --wide

# SIZE
SIZE_SWITCHES_DEFAULT     += --format=sysv
SIZE_SWITCHES_DEFAULT     += --radix=16

# STRIP
STRIP_SWITCHES_DEFAULT    +=

################################################################################
#                                                                              #
# GNATMAKE mode: import all settings.                                          #
# GPRbuild mode: only define the executable to build the system.               #
#                                                                              #
################################################################################

ifeq      ($(BUILD_MODE),GNATMAKE)
include gnatmake.tc.in
CONFIGURE_DEPS += gnatmake.tc.in
ifneq ($(filter $(INFOCONFIG_GOALS),$(MAKECMDGOALS)),)
ifeq ($(OSTYPE),cmd)
GNATMAKE_VERSION := $(shell                                                      \
                      SET "PATH=$(PATH)"                                      && \
                      SET "SWEETADA_PATH=$(SWEETADA_PATH)"                    && \
                      SET "LIBUTILS_DIRECTORY=$(LIBUTILS_DIRECTORY)"          && \
                      $(TOOLCHAIN_GNATMAKE) --version 2>nul| $(FILEHEAD) -n 1    \
                      )
else
GNATMAKE_VERSION := $(shell                                       \
                      PATH="$(PATH)"                              \
                      $(TOOLCHAIN_GNATMAKE)                       \
                        --version 2> /dev/null | $(FILEHEAD) -n 1 \
                      )
endif
endif
else ifeq ($(BUILD_MODE),GPRbuild)
GPRBUILD := gprbuild$(EXEEXT)
ifneq ($(filter $(INFOCONFIG_GOALS),$(MAKECMDGOALS)),)
ifeq ($(OSTYPE),cmd)
GPRBUILD_VERSION := $(shell                                             \
                      SET "PATH=$(PATH)"                             && \
                      SET "SWEETADA_PATH=$(SWEETADA_PATH)"           && \
                      SET "LIBUTILS_DIRECTORY=$(LIBUTILS_DIRECTORY)" && \
                      $(GPRBUILD) --version 2>nul| $(FILEHEAD) -n 1     \
                      )
else
GPRBUILD_VERSION := $(shell                                       \
                      PATH="$(PATH)"                              \
                      $(GPRBUILD)                                 \
                        --version 2> /dev/null | $(FILEHEAD) -n 1 \
                      )
endif
endif
GPRCLEAN := gprclean$(EXEEXT)
endif

################################################################################
#                                                                              #
# Synthesize toolchain command lines with theirs own options/switches.         #
#                                                                              #
################################################################################

ADAC     += $(ADAC_SWITCHES_DEFAULT) $(GCC_SWITCHES_PLATFORM)

AR       += $(AR_SWITCHES_DEFAULT)

AS       += $(AS_SWITCHES_DEFAULT) $(AS_SWITCHES_PLATFORM)

CC       += $(CC_SWITCHES_DEFAULT) $(GCC_SWITCHES_PLATFORM)

CPP      += $(CPP_SWITCHES_DEFAULT) $(GCC_SWITCHES_PLATFORM)

GNATBIND += $(GNATBIND_SWITCHES_DEFAULT)

GNATCHOP += $(GNATCHOP_SWITCHES_DEFAULT)

GNATLINK += $(GNATLINK_SWITCHES_DEFAULT)

GNATLS   += $(GNATLS_SWITCHES_DEFAULT)

ifeq ($(BUILD_MODE),GNATMAKE)
GNATMAKE += $(ADAC_SWITCHES_DEFAULT)
GNATMAKE += $(GNATMAKE_SWITCHES_DEFAULT) $(GCC_SWITCHES_PLATFORM)
endif

GNATPREP += $(GNATPREP_SWITCHES_DEFAULT)

GNATXREF += $(GNATXREF_SWITCHES_DEFAULT)

LD       += $(LD_SWITCHES_DEFAULT) $(LD_SWITCHES_PLATFORM)

NM       += $(NM_SWITCHES_DEFAULT)

OBJCOPY  += $(OBJCOPY_SWITCHES_DEFAULT) $(OBJCOPY_SWITCHES_PLATFORM)

OBJDUMP  += $(OBJDUMP_SWITCHES_DEFAULT) $(OBJDUMP_SWITCHES_PLATFORM)

RANLIB   += $(RANLIB_SWITCHES_DEFAULT)

READELF  += $(READELF_SWITCHES_DEFAULT)

SIZE     += $(SIZE_SWITCHES_DEFAULT) $(SIZE_SWITCHES_PLATFORM)

STRIP    += $(STRIP_SWITCHES_DEFAULT)

################################################################################
#                                                                              #
# Final toolchain setup.                                                       #
#                                                                              #
################################################################################

# beautify compiler command lines
ADAC     := $(filter-out ,$(ADAC))
CC       := $(filter-out ,$(CC))
ifeq ($(BUILD_MODE),GNATMAKE)
GNATMAKE := $(filter-out ,$(GNATMAKE))
endif

# special back-end compiler for GNATBIND-generated Ada files without output of
# spurious warnings
ADAC_GNATBIND := $(filter-out $(ADAC_SWITCHES_STYLE),$(ADAC))

# avoid extraneous informations in .d files during VERBOSE mode
ifeq ($(BUILD_MODE),GNATMAKE)
GNATMAKE_DEPEND := $(filter-out -v,$(GNATMAKE))
endif