Flattened Makefile 1
Jump to navigation
Jump to search
Flattened Makefile 1
Using a pile of copy/paste, let's try to build a flat makefile from the many levels of other files including other files. This isn't just a simple copy/paste operation, because we also have to expand all the variable references for paths, but some variables are re-used. In doing this we have to realize that Make acts like a two-pass assembler, first building the symbol table (so forward reference is technically legal), then doing all the expansion of the symbols and handling the rules that have been invoked by the user. When invoking make you can supply a list of rules (actions) at the command line and make will dig through the makefiles to find the matching segments of actions corresponding to each rule. Nice idea but hard to work with if that means significant amounts of the code are never used because all the user ever does is say 'make' with no arguments.
This Wiki page traces through /global/devel/gretTop/9-22/dgsDrivers/Makefile.
1 Begin copying code from /global/devel/gretTop/9-22/dgsDrivers/Makefile.
There is some basic EPICS documentation found at https://epics.anl.gov/base/R3-14/12-docs/AppDevGuide/node5.html that hopefully will assist in understanding some of this makefile structure.
#Makefile at top of application tree TOP = . include $(TOP)/configure/CONFIG
1.1 Manual expansion of line include /global/devel/gretTop/9-22/dgsDrivers/configure/CONFIG is below.
#CONFIG include $(TOP)/configure/CONFIG_APP
1.1.1 Manual expansion of line include /global/devel/gretTop/9-22/dgsDrivers/configure/CONFIG_APP is below.
# CONFIG_APP include $(TOP)/configure/RELEASE
1.1.1.1 Manual expansion of line include /global/devel/gretTop/9-22/dgsDrivers/configure/RELEASE is below.
#RELEASE Location of external products # Run "gnumake clean uninstall install" in the application # top directory each time this file is changed. # # NOTE: The build does not check dependancies on files # external to this application. Thus you should run # "gnumake clean uninstall install" in the top directory # each time EPICS_BASE, SNCSEQ, or any other external # module defined in the RELEASE file is rebuilt. TEMPLATE_TOP=$(EPICS_BASE)/templates/makeBaseApp/top GRETVME=./../gretVME DATASERVER=./../gretClust #If using the sequencer, point SNCSEQ at its top directory: SNCSEQ=/global/develbuild/supTop/31410/sncseq-2.0.12 ASYN=/global/develbuild/synApps/asyn/asyn4-17 # EPICS_BASE usually appears last so other apps can override stuff: #EPICS_BASE=/global/develbuild/base/R3.14.10 EPICS_BASE=/global/develbuild/base/base-3.14.12.1 #Capfast users may need the following definitions #CAPFAST_TEMPLATES= #SCH2EDIF_PATH=
END 1.1.1.1 Manual expansion of included file. Back to level 1.1.1
-include ./configure/RELEASE.$(EPICS_HOST_ARCH) ##jta: forward definition -include ./configure/RELEASE.Common.$(T_A) ##jta: forward definition -include ./configure/RELEASE.$(EPICS_HOST_ARCH).$(T_A) ##jta: forward definition CONFIG=/global/develbuild/base/base-3.14.12.1/configure include $(CONFIG)/CONFIG
1.1.1.2 Expansion of line include /global/develbuild/base/base-3.14.12.1/configure/CONFIG is below.
#************************************************************************* # Copyright (c) 2002 The University of Chicago, as Operator of Argonne # National Laboratory. # Copyright (c) 2002 The Regents of the University of California, as # Operator of Los Alamos National Laboratory. # EPICS BASE Versions 3.13.7 # and higher are distributed subject to a Software License Agreement found # in file LICENSE that is included with this distribution. #************************************************************************* # # Revision-Id: [email protected] # # The developer may edit this file. # assume T_A is the host arch if not specified # # Common build definitions # ifneq ($(wildcard $(TOP)/configure/CONFIG_BASE_VERSION),) EPICS_BASE = $(INSTALL_LOCATION) CONFIG = $(TOP)/configure BASE_TOP=YES else CONFIG ?= $(EPICS_BASE)/configure endif # Provide a default if the user hasn't set EPICS_HOST_ARCH ifeq ($(origin EPICS_HOST_ARCH), undefined) # NB: Must use a simply expanded variable here for performance: EPICS_HOST_ARCH := $(shell $(CONFIG)/../startup/EpicsHostArch.pl) endif # -include $(CONFIG)/os/CONFIG_COMPAT -include $(CONFIG)/RELEASE -include $(CONFIG)/RELEASE.$(EPICS_HOST_ARCH) -include $(CONFIG)/RELEASE.$(EPICS_HOST_ARCH).Common ifdef T_A -include $(CONFIG)/RELEASE.Common.$(T_A) -include $(CONFIG)/RELEASE.$(EPICS_HOST_ARCH).$(T_A) endif include $(CONFIG)/CONFIG_COMMON
1.1.1.2.1 Expansion of line include /global/develbuild/base/base-3.14.12.1/configure/CONFIG_COMMON is below.
#************************************************************************* # Copyright (c) 2002 The University of Chicago, as Operator of Argonne # National Laboratory. # Copyright (c) 2002 The Regents of the University of California, as # Operator of Los Alamos National Laboratory. # EPICS BASE Versions 3.13.7 # and higher are distributed subject to a Software License Agreement found # in file LICENSE that is included with this distribution. #************************************************************************* # # Revision-Id: [email protected] # # CONFIG_COMMON # # This file is to be maintained by the community. # # Common Configuration Information #------------------------------------------------------- # POSIX is OS default POSIX=YES #------------------------------------------------------- # Divider symbol DIVIDER = . #------------------------------------------------------- # Build architectures # CROSS1 will be defined only when CROSS_COMPILER_HOST_ARCHS is NOT defined CROSS1 = $(CROSS_COMPILER_TARGET_ARCHS$(word 1,$(CROSS_COMPILER_HOST_ARCHS))) # CROSS2 will be defined only when CROSS_COMPILER_HOST_ARCHS is defined # and EPICS_HOST_ARCH is one of it's words CROSS2 = $(CROSS_COMPILER_TARGET_ARCHS$(filter-out 1,$(words $(filter $(EPICS_HOST_ARCH),$(CROSS_COMPILER_HOST_ARCHS))))) BUILD_ARCHS = $(EPICS_HOST_ARCH) $(CROSS1) $(CROSS2) #------------------------------------------------------- # Default for perl if it's on the PATH, # otherwise override this in os/CONFIG_SITE.<host_arch>.Common PERL=perl #------------------------------------------------------- # dbst based database optimization default DB_OPT = NO #------------------------------------------------------- # Check configure/RELEASE file for consistency CHECK_RELEASE_YES = checkRelease CHECK_RELEASE_NO = CHECK_RELEASE_WARN = warnRelease #------------------------------------------------------- # GNU directory # GNU_DIR definition is here because it is used to find # READLINE library even if GNU compiler is not used GNU_DIR = /usr #------------------------------------------------------- # Directories INSTALL_LOCATION = $(TOP) INSTALL_LOCATION_LIB = $(INSTALL_LOCATION)/lib INSTALL_LOCATION_BIN = $(INSTALL_LOCATION)/bin INSTALL_HOST_BIN = $(INSTALL_LOCATION_BIN)/$(EPICS_HOST_ARCH) INSTALL_HOST_LIB = $(INSTALL_LOCATION_LIB)/$(EPICS_HOST_ARCH) INSTALL_INCLUDE = $(INSTALL_LOCATION)/include INSTALL_DOC = $(INSTALL_LOCATION)/doc INSTALL_HTML = $(INSTALL_LOCATION)/html INSTALL_TEMPLATES = $(INSTALL_LOCATION)/templates INSTALL_DBD = $(INSTALL_LOCATION)/dbd INSTALL_DB = $(INSTALL_LOCATION)/db INSTALL_CONFIG = $(INSTALL_LOCATION)/configure INSTALL_JAVA = $(INSTALL_LOCATION)/javalib #Directory for OS independant build created files COMMON_DIR = ../O.Common #------------------------------------------------------- # Make echo output - suppress echoing if make's '-s' flag is set ECHO := $(if $(findstring s,$(MAKEFLAGS)),\#,@echo) #------------------------------------------------------- ifdef T_A INSTALL_LIB = $(INSTALL_LOCATION_LIB)/$(T_A) INSTALL_SHRLIB = $(INSTALL_LOCATION_LIB)/$(T_A) INSTALL_TCLLIB = $(INSTALL_LOCATION_LIB)/$(T_A) INSTALL_BIN = $(INSTALL_LOCATION_BIN)/$(T_A) #Directories for libraries SHRLIB_SEARCH_DIRS = $(INSTALL_LIB) #------------------------------------------------------- # Ext, app, and module configure dir targets CONFIG_INSTALLS += ../RULES_BUILD ../RELEASE* #------------------------------------------------------- # Cross compile default, HOST or CROSS, CONFIG.crossCommon will override BUILD_CLASS = HOST #------------------------------------------------------- # Build defaults, CONFIG_SITE, CONFIG, or os/CONFIG* will override STATIC_BUILD=NO SHARED_LIBRARIES=YES HOST_OPT=YES CROSS_OPT=YES HOST_WARN=YES CROSS_WARN=YES GNU=NO #------------------------------------------------------- # Run checkRelease in $(TOP)/configure/O.* CONFIG_TARGETS += $(CHECK_RELEASE_$(CHECK_RELEASE)) #------------------------------------------------------- # Prefix and suffix DEP=.d OBJ = . CMPLR_SUFFIX= CMPLR_PREFIX= LIB_PREFIX= SHRLIB_PREFIX= $(LIB_PREFIX) #-------------------------------------------------- # vpath directories POSIX_YES = os/posix GENERIC_SRC_DIRS = .. $(SRC_DIRS) OS_SRC_DIRS += . $(foreach dir, .. $(SRC_DIRS), \ $(addprefix $(dir)/, os/$(OS_CLASS) $(POSIX_$(POSIX)) os/default )) ALL_SRC_DIRS = $(OS_SRC_DIRS) $(GENERIC_SRC_DIRS) #-------------------------------------------------- # compile line include directories INSTALL_INCLUDES += \ -I$(INSTALL_INCLUDE)/os/$(OS_CLASS) \ -I$(INSTALL_INCLUDE) SRC_INCLUDES = -I$(COMMON_DIR) $(addprefix -I, $(wildcard $(ALL_SRC_DIRS))) #-------------------------------------------------- # Target filename definitions OBJSNAME = $(addsuffix $(OBJ),$(basename $(OBJS))) PRODNAME = $(addsuffix $(EXE),$(basename $(PROD))) TESTPRODNAME = $(addsuffix $(EXE),$(basename $(TESTPROD))) SHRLIBNAME = $(SHRLIBNAME_$(SHARED_LIBRARIES)) JAVA = JAR = #-------------------------------------------------- # obj files TARGET_OBJS = $($*_OBJLIBS) $($*_LDOBJS) $(addsuffix $(OBJ),$(basename $($*_OBJS) $($*_SRCS))) PRODUCT_OBJS = $(addsuffix $(OBJ),$(basename $(SRCS) $(USR_SRCS) $(PROD_SRCS) $(USR_OBJS) $(PROD_OBJS))) PROD_LD_OBJS = $(USR_OBJLIBS) $(PROD_OBJLIBS) $(TARGET_OBJS) $(PRODUCT_OBJS) LIBRARY_OBJS = $(addsuffix $(OBJ),$(basename $(SRCS) $(USR_SRCS) $(LIB_SRCS) $(LIBSRCS) $(USR_OBJS) $(LIB_OBJS))) LIBRARY_LD_OBJS = $(USR_OBJLIBS) $(LIB_OBJLIBS) $(TARGET_OBJS) $(LIBRARY_OBJS) #-------------------------------------------------- # WIN95/NT resource files TARGET_RESS = $(if $(RES),$(addsuffix $(RES),$(basename $($*_RCS))),) PROD_RESS = $(if $(RES),$(addsuffix $(RES),$(basename $(RCS) $(PROD_RCS))),) PROD_LD_RESS = $(TARGET_RESS) $(PROD_RESS) LIBRARY_RESS = $(if $(RES),$(addsuffix $(RES),$(basename $(RCS) $(LIB_RCS) $(LIBRARY_RCS))),) LIBRARY_LD_RESS = $(TARGET_RESS) $(LIBRARY_RESS) #-------------------------------------------------- # WIN95/NT source browser PROD_BAF = $(addsuffix $(BAF), $(basename $(PROD))) LIB_BAF=$(addsuffix $(BAF),$(basename $(LIBRARY))) #-------------------------------------------------- # C preprocessor, compiler, and linker flag defaults # Target architecture specific flags ARCH_DEP_CPPFLAGS = ARCH_DEP_CFLAGS = ARCH_DEP_CXXFLAGS = $(ARCH_DEP_CFLAGS) ARCH_DEP_LDFLAGS = ARCH_DEP_LDLIBS = # Target operating system specific flags OP_SYS_CPPFLAGS = OP_SYS_CFLAGS = OP_SYS_CXXFLAGS = $(OP_SYS_CFLAGS) OP_SYS_LDFLAGS = OP_SYS_INCLUDES = # Makefile specific flags USR_INCLUDES = USR_CFLAGS = USR_CXXFLAGS = USR_LDFLAGS = USR_LIBS = USR_CPPFLAGS = USR_DBDFLAGS = USR_ARFLAGS = # Debug specific options DEBUG_CPPFLAGS = DEBUG_CFLAGS = DEBUG_CXXFLAGS = $(DEBUG_CFLAGS) DEBUG_LDFLAGS = DEBUG_LDLIBS = # Target specific options TARGET_INCLUDES = $($(basename $@)_INCLUDES_$(T_A)) TARGET_CFLAGS = $($(basename $@)_CFLAGS_$(T_A)) TARGET_CXXFLAGS = $($(basename $@)_CXXFLAGS_$(T_A)) TARGET_CPPFLAGS = $($(basename $@)_CPPFLAGS_$(T_A)) TARGET_INCLUDES += $($(basename $@)_INCLUDES_$(OS_CLASS)) $($(basename $@)_INCLUDES) TARGET_CFLAGS += $($(basename $@)_CFLAGS_$(OS_CLASS)) $($(basename $@)_CFLAGS) TARGET_CXXFLAGS += $($(basename $@)_CXXFLAGS_$(OS_CLASS)) $($(basename $@)_CXXFLAGS) TARGET_CPPFLAGS += $($(basename $@)_CPPFLAGS_$(OS_CLASS)) $($(basename $@)_CPPFLAGS) TARGET_LDFLAGS = $($*_LDFLAGS) # Warnings flags WARN_CPPFLAGS = $(WARN_CPPFLAGS_$($(BUILD_CLASS)_WARN)) WARN_CFLAGS = $(WARN_CFLAGS_$($(BUILD_CLASS)_WARN)) WARN_CXXFLAGS = $(WARN_CXXFLAGS_$($(BUILD_CLASS)_WARN)) # Optimization flags OPT_CPPFLAGS = $(OPT_CPPFLAGS_$($(BUILD_CLASS)_OPT)) OPT_CFLAGS = $(OPT_CFLAGS_$($(BUILD_CLASS)_OPT)) OPT_CXXFLAGS = $(OPT_CXXFLAGS_$($(BUILD_CLASS)_OPT)) # Static build flags STATIC_CFLAGS = $(STATIC_CFLAGS_$(STATIC_BUILD)) STATIC_CXXCFLAGS = $(STATIC_CXXFLAGS_$(STATIC_BUILD)) STATIC_LDFLAGS = $(STATIC_LDFLAGS_$(STATIC_BUILD)) STATIC_LDLIBS = $(STATIC_LDLIBS_$(STATIC_BUILD)) #-------------------------------------------------- # cflags for shared library src files (from SHRLIB_CFLAGS) LIBRARY_SRCS=$(basename $(foreach lib,$(LIBRARY) $(LOADABLE_LIBRARY),$($(lib)_OBJSNAME) $(LIBRARY_OBJS))) LIBRARY_SRC_CFLAGS=$($(patsubst $*,SHRLIB,$(findstring $*,$(LIBRARY_SRCS)))_CFLAGS) #-------------------------------------------------- # prefix, suffix, and ldflags for loadable shared libraries TARGET_LIB_LDFLAGS=$($(patsubst $*,LOADABLE_,$(findstring $*,$(LOADABLE_LIBRARY)))SHRLIB_LDFLAGS) LOADABLE_SHRLIB_PREFIX=$(SHRLIB_PREFIX) LOADABLE_SHRLIB_SUFFIX=$(SHRLIB_SUFFIX) #-------------------------------------------------- # Command-line input support default COMMANDLINE_LIBRARY = EPICS OP_SYS_LDLIBS += $(LDLIBS_$(COMMANDLINE_LIBRARY)) OP_SYS_LDFLAGS += $(LDFLAGS_$(COMMANDLINE_LIBRARY)) RUNTIME_LDFLAGS += $(RUNTIME_LDFLAGS_$(COMMANDLINE_LIBRARY)) #-------------------------------------------------- # Flags INCLUDES = -I. $(SRC_INCLUDES) $(INSTALL_INCLUDES) $(RELEASE_INCLUDES)\ $(TARGET_INCLUDES) $(USR_INCLUDES) $(OP_SYS_INCLUDES) $($(BUILD_CLASS)_INCLUDES) CFLAGS = $($(BUILD_CLASS)_CFLAGS) $(POSIX_CFLAGS) $(OPT_CFLAGS) $(DEBUG_CFLAGS)\ $(PIPE_CFLAGS) $(WARN_CFLAGS) $(TARGET_CFLAGS) $(USR_CFLAGS) $(ARCH_DEP_CFLAGS)\ $(CODE_CFLAGS) $(STATIC_CFLAGS) $(OP_SYS_CFLAGS) $(LIBRARY_SRC_CFLAGS) $(HDEPENDS_CFLAGS) CXXFLAGS = $($(BUILD_CLASS)_CXXFLAGS) $(POSIX_CXXFLAGS) $(OPT_CXXFLAGS) $(DEBUG_CXXFLAGS)\ $(PIPE_CFLAGS) $(WARN_CXXFLAGS) $(TARGET_CXXFLAGS) $(USR_CXXFLAGS) $(ARCH_DEP_CXXFLAGS)\ $(CODE_CXXFLAGS) $(STATIC_CXXCFLAGS) $(OP_SYS_CXXFLAGS) $(LIBRARY_SRC_CFLAGS) $(HDEPENDS_CFLAGS) LDFLAGS = $(OPT_LDFLAGS) $(TARGET_LDFLAGS) $(USR_LDFLAGS) $(POSIX_LDFLAGS) \ $(ARCH_DEP_LDFLAGS) $(DEBUG_LDFLAGS) $(OP_SYS_LDFLAGS) $($(BUILD_CLASS)_LDFLAGS)\ $(RUNTIME_LDFLAGS) $(CODE_LDFLAGS) LDLIBS = \ $(POSIX_LDLIBS) $(ARCH_DEP_LDLIBS) $(DEBUG_LDLIBS) $(OP_SYS_LDLIBS) $(GNU_LDLIBS_$(GNU)) CPPFLAGS += $($(BUILD_CLASS)_CPPFLAGS) $(POSIX_CPPFLAGS)\ $(OPT_CPPFLAGS) $(DEBUG_CPPFLAGS) $(WARN_CPPFLAGS)\ $(BASE_CPPFLAGS) $(TARGET_CPPFLAGS) $(USR_CPPFLAGS) $(ARCH_DEP_CPPFLAGS)\ $(OP_SYS_CPPFLAGS) $(OP_SYS_INCLUDE_CPPFLAGS) $(CODE_CPPFLAGS) #-------------------------------------------------- # ar definition default ARFLAGS = ARCMD = $(AR) $(ARFLAGS) $(USR_ARFLAGS) $@ $(LIBRARY_LD_OBJS) #-------------------------------------------------- # 'Munch' link-edit MUNCH_CMD = $(LD) $(MUNCH_LDFLAGS) -o $@ $^ #-------------------------------------------------- # LEX default options # # Allow 8-bit characters LEXOPT += -8 # Generate an "interactive" scanner, solves problems at EOF. LEXOPT += -I #-------------------------------------------------- # Build compile line here PATH_FILTER = $(1) COMPILE.c = $(CC) -c $(CPPFLAGS) $(CFLAGS) $(call PATH_FILTER,$(INCLUDES)) COMPILE.cpp = $(CCC) -c $(CPPFLAGS) $(CXXFLAGS) $(call PATH_FILTER,$(INCLUDES)) #-------------------------------------------------- # C preprocessor command PREPROCESS.cpp = $(CPP) $(CPPFLAGS) $(INCLUDES) $< > $@ #-------------------------------------------------- # Header dependency file generation HDEPENDS = YES HDEPENDS_METHOD = CMD HDEPENDS_INCLUDES = $(subst -I,,$(INCLUDES)) HDEPENDSFLAGS = -m $*$(DEP) $(HDEPENDS_INCLUDES) $@ $< HDEPENDSCMD = -$(MKMF) $(HDEPENDS_FLAGS) $(HDEPENDSFLAGS) HDEPENDS_CMD_NO = $(ECHO) "" HDEPENDS_CMD_YES = $(if $(filter CMD,$(HDEPENDS_METHOD)),$(HDEPENDSCMD),$(HDEPENDS_CMD_NO)) HDEPENDS_CMD = $(HDEPENDS_CMD_$(HDEPENDS)) HDEPENDSCFLAGS = -MMD HDEPENDS_CFLAGS_YES = $(if $(filter CFLAGS,$(HDEPENDS_METHOD)),$(HDEPENDSCFLAGS)) HDEPENDS_CFLAGS = $(HDEPENDS_CFLAGS_$(HDEPENDS)) #-------------------------------------------------- # depends definition TARGET_SRCS = $(foreach name, $(TESTPROD) $(PROD) $(LIBRARY), $($(name)_SRCS)) SRC_FILES = $(LIB_SRCS) $(LIBSRCS) $(SRCS) $(USR_SRCS) $(PROD_SRCS) $(TARGET_SRCS) HDEPENDS_FILES_YES = $(addsuffix $(DEP),$(notdir $(basename $(SRC_FILES)))) HDEPENDS_FILES = $(if $(filter NO,$(HDEPENDS)),,$(HDEPENDS_FILES_YES)) #--------------------------------------------------------------- # Names of installed items # # each list starts with the destination directory name(s) # to make sure it's there INSTALL_PROD= $(PRODNAME:%= $(INSTALL_BIN)/%) INSTALL_LIBS= $(LIBNAME:%=$(INSTALL_LIB)/%) INSTALL_MUNCHS= $(MUNCHNAME:%=$(INSTALL_BIN)/%) INSTALL_SHRLIBS= $(SHRLIBNAME:%=$(INSTALL_SHRLIB)/%) INSTALL_LOADABLE_SHRLIBS= $(LOADABLE_SHRLIBNAME:%=$(INSTALL_SHRLIB)/%) INSTALL_DLL_LINK_LIBS=$(DLL_LINK_LIBNAME:%=$(INSTALL_LIB)/%) INSTALL_TCLLIBS=$(TCLLIBNAME:%=$(INSTALL_TCLLIB)/%) INSTALL_TCLINDEX=$(TCLINDEX:%=$(INSTALL_TCLLIB)/%) INSTALL_SCRIPTS = $(SCRIPTS:%= $(INSTALL_BIN)/%) INSTALL_OBJS = $(OBJSNAME:%= $(INSTALL_BIN)/%) INSTALL_DOCS = $(DOCS:%= $(INSTALL_DOC)/%) INSTALL_HTMLS = $(HTMLS:%= $(INSTALL_HTML)/$(HTMLS_DIR)/%) INSTALL_TEMPLATE = $(addprefix $(INSTALL_TEMPLATES_SUBDIR)/, \ $(subst $(CONFIG),top/configure,$(TEMPLATES))) INSTALL_CONFIGS = $(CONFIGS:%= $(INSTALL_CONFIG)/%) INSTALL_BIN_INSTALLS = $(addprefix $(INSTALL_BIN)/,$(notdir $(BIN_INSTALLS))) INSTALL_LIB_INSTALLS = $(addprefix $(INSTALL_LIB)/,$(notdir $(LIB_INSTALLS))) #--------------------------------------------------------------- # Installed file permissions BIN_PERMISSIONS = 555 LIB_PERMISSIONS = 444 INSTALL_PERMISSIONS = 444 #--------------------------------------------------------------- # # auto determine the directory paths that things are installed to # RULES: # 1) found in any one of several os specific area # => install to $(INSTALL_INCLUDE)/os/$(OS_CLASS) # 2) not foundin (1) and found in generic area # => install to $(INSTALL_INCLUDE) # 3) not found in (1) or (2) then may be (not yet) computer generated # => install into $(INSTALL_INCLUDE)/os/$(OS_CLASS) and let # build rules work on vpath # # These rules guarantee that the users include from # no more than two directories # INSTALL_INC += $(foreach inc, $(INC), \ $(firstword \ $(OS_INSTALL_INC) \ $(GENERIC_INSTALL_INC) \ $(GENERATED_INSTALL_INC) ) ) INSTALL_INC += $(addprefix $(INSTALL_INCLUDE)/os/$(OS_CLASS)/, $(INC_$(OS_CLASS)) ) # # Rule 1 # OS_INSTALL_INC = $(addprefix $(INSTALL_INCLUDE)/os/$(OS_CLASS)/, $(INSTALL_INC_ggg) ) INSTALL_INC_ggg = $(foreach dir, $(OS_SRC_DIRS), $(INSTALL_INC_fff) ) INSTALL_INC_fff = $(subst $(dir)/, , $(INSTALL_INC_eee) ) INSTALL_INC_eee = $(wildcard $(addsuffix /$(inc), $(dir)) ) # # Rule 2 # GENERIC_INSTALL_INC = $(addprefix $(INSTALL_INCLUDE)/, $(INSTALL_INC_ccc) ) INSTALL_INC_ccc = $(foreach dir, .. $(SRC_DIRS), $(INSTALL_INC_bbb) ) INSTALL_INC_bbb = $(subst $(dir)/, , $(INSTALL_INC_aaa) ) INSTALL_INC_aaa = $(wildcard $(addsuffix /$(inc), $(dir)) ) # # Rule 3 # GENERATED_INSTALL_INC = $(INSTALL_INCLUDE)/$(inc) COMMON_INC += $(filter $(COMMON_DIR)/%, $(foreach file, $(INC), \ $(firstword $(SOURCE_INC) $(COMMON_DIR)/$(file) ) ) ) SOURCE_INC = $(wildcard $(file) $(SOURCE_INC_bbb) ) SOURCE_INC_bbb = $(foreach dir, $(ALL_SRC_DIRS), $(SOURCE_INC_aaa) ) SOURCE_INC_aaa = $(addsuffix /$(file), $(dir) ) endif
END 1.1.1.2.1 Back to 1.1.1.2
include $(CONFIG)/CONFIG_FILE_TYPE
1.1.1.2.2 Expansion of line include /global/develbuild/base/base-3.14.12.1/configure/CONFIG_FILE_TYPE is below.
#************************************************************************* # Copyright (c) 2006 UChicago Argonne LLC, as Operator of Argonne # National Laboratory. # Copyright (c) 2002 The Regents of the University of California, as # Operator of Los Alamos National Laboratory. # EPICS BASE is distributed subject to a Software License Agreement found # in the file LICENSE that is included with this distribution. #************************************************************************* # Revision-Id: [email protected] # # Macros and rules to create a new installation file type # # -------------------------------------------------------------- # Module developers can now define a new type of file, e.g. ABC, # so that files of type ABC will be installed into a directory # defined by INSTALL_ABC. This is done by creating a new CONFIG<name> # file, e.g. CONFIG_ABC, with the following lines: # # FILE_TYPE += ABC # INSTALL_ABC = $(INSTALL_LOCATION)/abc # # The INSTALL_ABC directory should be be a subdirectory of # $(INSTALL_LOCATION). The file type ABC should be target # architecture independent (alh files, medm files, edm files). # # Optional rules necessary for files of type ABC should be put in # a RULES_ABC file. # # The module developer installs new CONFIG* or RULES* files # into the directory $(INSTALL_LOCATION)/cfg by including the # following Makefile line: # # CFG += CONFIG_ABC RULES_ABC # # Files of type ABC are installed into INSTALL_ABC directory # by adding a line like the following to a Makefile. # # ABC += <filename1> <filename2> <filename3> # # Files in $(INSTALL_LOCATION)/cfg directory are now included by # the base config files so the definitions and rules are available # for use by later src directory Makefiles in the same module or # by other modules with a RELEASE line pointing to the TOP of # the module with RULES_ABC. FILE_TYPE += ADL INSTALL_ADL = $(INSTALL_LOCATION)/adl FILE_TYPE += ALH INSTALL_ALH = $(INSTALL_LOCATION)/alh FILE_TYPE += CFG INSTALL_CFG = $(INSTALL_LOCATION)/cfg FILE_TYPE += EDL INSTALL_EDL = $(INSTALL_LOCATION)/edl FILE_TYPE += PERL_MODULES INSTALL_PERL_MODULES = $(INSTALL_LOCATION_LIB)/perl INSTALLS_CFG= $(CFG:%= $(INSTALL_CFG)/%) DIRECTORY_TARGETS += $(foreach type, $(FILE_TYPE),$(INSTALL_$(type)))
END 1.1.1.2.2 Back to 1.1.1.2
# Base-specific build options # include $(CONFIG)/CONFIG_BASE
1.1.1.2.3 expansion of include $(CONFIG)/CONFIG_BASE
#************************************************************************* # Copyright (c) 2002 The University of Chicago, as Operator of Argonne # National Laboratory. # Copyright (c) 2002 The Regents of the University of California, as # Operator of Los Alamos National Laboratory. # EPICS BASE Versions 3.13.7 # and higher are distributed subject to a Software License Agreement found # in file LICENSE that is included with this distribution. #************************************************************************* #--------------------------------------------------------------- # Epics base directories EPICS_BASE_HOST_BIN = $(EPICS_BASE)/bin/$(EPICS_HOST_ARCH) EPICS_BASE_HOST_LIB = $(EPICS_BASE)/lib/$(EPICS_HOST_ARCH) ifdef T_A EPICS_BASE_LIB = $(EPICS_BASE)/lib/$(T_A) EPICS_BASE_BIN = $(EPICS_BASE)/bin/$(T_A) endif #--------------------------------------------------------------- # Epics base Ioc libraries EPICS_BASE_IOC_LIBS += recIoc softDevIoc EPICS_BASE_IOC_LIBS += miscIoc rsrvIoc dbtoolsIoc asIoc EPICS_BASE_IOC_LIBS += dbIoc registryIoc dbStaticIoc ca Com #--------------------------------------------------------------- # Epics base Host libraries EPICS_BASE_HOST_LIBS += cas gdd asHost dbStaticHost registryIoc EPICS_BASE_HOST_LIBS += ca Com #--------------------------------------------------------------- # Version number for base shared libraries (and win32 products) ifdef BASE_TOP SHRLIB_VERSION = $(EPICS_VERSION).$(EPICS_REVISION) PROD_VERSION = $(EPICS_VERSION).$(EPICS_REVISION) endif # BASE_TOP #--------------------------------------------------------------- # Base c preprocessor flags BASE_CPPFLAGS = # osithread default stack OSITHREAD_USE_DEFAULT_STACK = NO OSITHREAD_DEFAULT_STACK_FLAGS_YES = -DOSITHREAD_USE_DEFAULT_STACK OSITHREAD_DEFAULT_STACK_FLAGS_NO = BASE_CPPFLAGS += $(OSITHREAD_DEFAULT_STACK_FLAGS_$(OSITHREAD_USE_DEFAULT_STACK)) #--------------------------------------------------------------- # Where to find the installed build tools TOOLS = $(EPICS_BASE_HOST_BIN) #--------------------------------------------------------------- # Epics base build tools and tool flags MAKEBPT = $(call PATH_FILTER, $(TOOLS)/makeBpt$(HOSTEXE)) DBEXPAND = $(call PATH_FILTER, $(TOOLS)/dbExpand$(HOSTEXE)) DBTORECORDTYPEH = $(call PATH_FILTER, $(TOOLS)/dbToRecordtypeH$(HOSTEXE)) DBTOMENUH = $(call PATH_FILTER, $(TOOLS)/dbToMenuH$(HOSTEXE)) REGISTERRECORDDEVICEDRIVER = $(PERL) $(TOOLS)/registerRecordDeviceDriver.pl CONVERTRELEASE=$(PERL) $(TOOLS)/convertRelease.pl #------------------------------------------------------- # tools for installing libraries and products INSTALL = $(PERL) $(TOOLS)/installEpics.pl INSTALL_PRODUCT = $(INSTALL) INSTALL_LIBRARY = $(INSTALL) #--------------------------------------------------------------- # tools for making header dependancies and variable replacement MKMF = $(PERL) $(TOOLS)/mkmf.pl REPLACEVAR = $(PERL) $(TOOLS)/replaceVAR.pl #--------------------------------------------------------------- # private versions of lex/yacc from EPICS EYACC = $(call PATH_FILTER, $(TOOLS)/antelope$(HOSTEXE)) ELEX = $(call PATH_FILTER, $(TOOLS)/e_flex$(HOSTEXE)) -S$(EPICS_BASE)/include/flex.skel.static YACC = $(EYACC) LEX = $(ELEX) #--------------------------------------------------------------- # External tools and tool flags - must be in path or defined in application ifndef ADL2DL ADL2DL = adl2dl endif # sch2edif compiler and flags SCH2EDIF = sch2edif SCH2EDIF_PATH = SCH2EDIF_SYSFLAGS = -n -ap -p.+..+$(SCH2EDIF_PATH)+$(CAPFAST_TEMPLATES)/sym+ SCH2EDIF_FLAGS = # e2db and flags # - again there is an assumption where edb.def is installed. ifndef E2DB E2DB = e2db endif E2DB_SYSFLAGS = -ate -d $(CAPFAST_TEMPLATES)/edb.def E2DB_FLAGS = ifndef DBST DBST = dbst endif ifndef MSI MSI = msi endif
END 1.1.1.2.3; return to 1.1.1.2
# Site-specific build options # include $(CONFIG)/CONFIG_SITE
1.1.1.2.4; expansion of include $(CONFIG)/CONFIG_SITE
#************************************************************************* # Copyright (c) 2006 UChicago Argonne LLC, as Operator of Argonne # National Laboratory. # Copyright (c) 2002 The Regents of the University of California, as # Operator of Los Alamos National Laboratory. # EPICS BASE is distributed subject to a Software License Agreement found # in the file LICENSE that is included with this distribution. #************************************************************************* # # Revision-Id: [email protected] # # CONFIG_SITE - Global site configuration file # # The host architecture performing the build, in the form # <operating system>-<architecture>[-<toolset>] # # Currently Supporting: # aix-ppc (IBM compiler used for host builds) # aix-ppc-gnu (GNU compiler used for host builds) # cygwin-x86 (cygwin compiler used for host builds) # darwin-ppc (PowerPC based Apple running OSX) # darwin-ppcx86 (Universal binaries for both CPUs) # darwin-x86 (Intel based Apple running OSX) # freebsd-x86 (GNU compiler used for host builds) # freebsd-x86_64 (GNU compiler used for host builds) # linux-ppc (GNU compiler used for host builds) # linux-ppc64 (GNU compiler used for host builds) # linux-x86 (GNU compiler used for host builds) # linux-x86_64 (GNU compiler used for host builds) # linux-x86-borland (Borland C++ compiler used for host builds) # solaris-sparc (Sun compiler used for host builds) # solaris-sparc-gnu (GNU compiler used for host builds) # solaris-sparc64 (Sun compiler used for host builds) # solaris-sparc64-gnu (GNU compiler used for host builds) # solaris-x86 (Sun compiler used for host builds) # solaris-x86-gnu (GNU compiler used for host builds) # solaris-x86_64 (Sun compiler used for host builds) # solaris-x86_64-gnu (GNU compiler used for host builds) # win32-x86 (MS Visual C++ compiler used for host builds) # win32-x86-cygwin (WIN32 API with cygwin GNU compiler used for host builds) # win32-x86-mingw (MinGW compiler used for host builds) # windows-x64 (MS Visual C++ compiler used for host builds) # Debugging builds # linux-x86-debug (GNU compiler with -g option for host builds) # linux-x86_64-debug (GNU compiler with -g option for host builds) # solaris-sparc-debug (sun compiler no optimization,-g for debugging info) # win32-x86-debug (MS Visual C++ compiler with debug option for host builds) # windows-x64-debug (MS Visual C++ compiler with debug option for host builds) # EPICS_HOST_ARCH is a required environment variable # Do not set EPICS_HOST_ARCH in this file. # Use base/startup files to set EPICS_HOST_ARCH or # provide EPICS_HOST_ARCH on the GNU make command line. # The cross-compiler architectures to build EPICS for # # Currently Supporting: # ios-arm # ios-386 # linux-386 (linux-x86 host) # linux-486 (linux-x86 host) # linux-586 (linux-x86 host) # linux-686 (linux-x86 host) # linux-arm (linux-x86 host) # linux-arm_eb (linux-x86 host) # linux-arm_el (linux-x86 host) # linux-athlon (linux-x86 host) # linux-cris (Axis GNU crosscompiler on linux-x86 host) # linux-cris_v10 (Axis GNU crosscompiler on linux-x86 host) # linux-cris_v32 (Axis GNU crosscompiler on linux-x86 host) # linux-xscale_be # vxWorks-486 # vxWorks-68040 # vxWorks-68040lc # vxWorks-68060 # vxWorks-pentium # vxWorks-ppc32 (32-bit PowerPC CPUs with full FPU) # vxWorks-ppc32sf (32-bit PowerPC CPUs without FPU) # vxWorks-ppc603 # vxWorks-ppc603_long # vxWorks-ppc604 # vxWorks-ppc604_long # vxWorks-ppc604_altivec # vxWorks-mpc8540 # vxWorks-mpc8548 # RTEMS-at91rm9200ek # RTEMS-beatnik # RTEMS-gen68360 # RTEMS-mcp750 # RTEMS-mvme167 # RTEMS-mvme2100 # RTEMS-mvme2700 # RTEMS-mvme3100 # RTEMS-mvme5500 # RTEMS-pc386 # RTEMS-psim # RTEMS-uC5282 # # Definitions of CROSS_COMPILER_TARGET_ARCHS in # configure/os/CONFIG_SITE.<host>.Common files will # override # CROSS_COMPILER_TARGET_ARCHS=vxWorks-ppc604_long #CROSS_COMPILER_TARGET_ARCHS=vxWorks-ppc32 # If only a subset of the host architectures perform # the build for the CROSS_COMPILER_TARGET_ARCHS # uncomment the following line and specify them. # CROSS_COMPILER_HOST_ARCHS=solaris-sparc-gnu # Build shared libraries? # must be either YES or NO # NOTE: os/CONFIG.$(EPICS_HOST_ARCH).$(EPICS_HOST_ARCH) files and # os/CONFIG_SITE.$(EPICS_HOST_ARCH).$(EPICS_HOST_ARCH) files may override # # NOTE WIN32: YES results in a DLL. Valid settings are # SHARED_LIBRARIES=YES and STATIC_BUILD=NO # SHARED_LIBRARIES=NO and STATIC_BUILD=YES # SHARED_LIBRARIES=YES # Build client objects statically ? # must be either YES or NO # STATIC_BUILD=NO # Should header dependancy files be automatically generated # for each C/C++ created object file? # must be either YES or NO HDEPENDS=YES # Host build optimization # must be either YES or NO HOST_OPT=YES # Cross build optimization # must be either YES or NO CROSS_OPT=YES # Generate Verbose Compiler Warnings for Host builds # must be either YES or NO HOST_WARN=YES # Generate Verbose Compiler Warnings for cross compile builds # must be either YES or NO CROSS_WARN=YES # Create and/or install perl build tools for R3.13 extension builds? # must be either YES or NO # # NOTE: Set to YES only if you have existing R3.13 extensions to be # built with this base # #COMPAT_TOOLS_313=YES # Create and/or install files for R3.13 ioc application and extension builds? # must be either YES or NO # # NOTE: Set to YES only if you have existing R3.13 ioc applications # and extensions to be built with this base # COMPAT_313=NO # Installation directory # If you don't want to install into $(TOP) dir then # define INSTALL_LOCATION here #INSTALL_LOCATION=<fullpathname> # Use POSIX thread priority scheduling (YES or NO) USE_POSIX_THREAD_PRIORITY_SCHEDULING = NO # Site version number, if set will append '-' and this string to the # EPICS version number string that is reported by many tools EPICS_SITE_VERSION = # For GNU compiler, use pipes rather than temporary files for communication # between the various stages of compilation. GCC_PIPE = NO # Include RPATH when linking executables and libraries. # must be either YES or NO LINKER_USE_RPATH=YES
END 1.1.1.2.4; return to 1.1.1.2
# Version numbering # include $(CONFIG)/CONFIG_BASE_VERSION # Host architecture specific definitions # include $(CONFIG)/os/CONFIG.$(EPICS_HOST_ARCH).Common -include $(CONFIG)/os/CONFIG_SITE.$(EPICS_HOST_ARCH).Common ifdef T_A # Cross compile specific definitions # ifneq ($(EPICS_HOST_ARCH),$(T_A)) include $(CONFIG)/CONFIG.CrossCommon endif # Target architecture specific definitions # -include $(CONFIG)/os/CONFIG.Common.$(T_A) # Host-Target architecture specific definitions # -include $(CONFIG)/os/CONFIG.$(EPICS_HOST_ARCH).$(T_A) # RELEASE file specific definitions # ifneq ($(CONFIG),$(TOP)/configure) -include $(CONFIG)/CONFIG_APP_INCLUDE endif # Site specific target and host-target definitions # -include $(CONFIG)/os/CONFIG_SITE.Common.$(T_A) -include $(CONFIG)/os/CONFIG_SITE.$(EPICS_HOST_ARCH).$(T_A) endif # Include <top>/cfg/CONFIG* definitions from tops defined in RELEASE* files # ifneq ($(CONFIG),$(TOP)/configure) RELEASE_TOPS := $(shell $(CONVERTRELEASE) -T $(TOP) releaseTops) RELEASE_CFG_CONFIGS = $(foreach top, $(RELEASE_TOPS), $(wildcard $($(top))/cfg/CONFIG*)) ifneq ($(RELEASE_CFG_CONFIGS),) include $(RELEASE_CFG_CONFIGS) endif endif # Include $(INSTALL_CFG)/CONFIG* definitions # ifndef T_A TOP_CFG_CONFIGS = $(wildcard $(INSTALL_CFG)/CONFIG*) ifneq ($(TOP_CFG_CONFIGS),) include $(TOP_CFG_CONFIGS) endif endif # User specific definitions # -include $(HOME)/configure/CONFIG_USER -include $(HOME)/configure/CONFIG_USER.$(EPICS_HOST_ARCH) ifdef T_A -include $(HOME)/configure/CONFIG_USER.Common.$(T_A) -include $(HOME)/configure/CONFIG_USER.$(EPICS_HOST_ARCH).$(T_A) endif # All options # may be overridden here. # # EXAMPLES # -------- # Build client objects statically ? must be either YES or NO #STATIC_BUILD=NO # Host build optimization, must be either YES or NO #HOST_OPT=YES # Cross build optimization, must be either YES or NO #CROSS_OPT=YES # Generate Verbose Compiler Warnings for host build, must be either YES or NO #HOST_WARN=YES # Generate Verbose Compiler Warnings for cross compile builds, must be either YES or NO #CROSS_WARN=YES #etc. #CROSS_COMPILER_TARGET_ARCHS=vxWorks-68040
END 1.1.1.2 Manual expansion of included file. Back to level 1.1.1
INSTALL_LOCATION = $(TOP) ifdef INSTALL_LOCATION_APP INSTALL_LOCATION = $(INSTALL_LOCATION_APP) endif ifdef T_A -include $(TOP)/configure/O.$(T_A)/CONFIG_APP_INCLUDE endif # dbst based database optimization (default: NO) DB_OPT = NO
END 1.1.1 Manual expansion of included file. Back to level 1.1
# Add any changes to make definitions here #CROSS_COMPILER_TARGET_ARCHS = vxWorks-68040 # Use this when your IOC and the host use different paths # to access the application. Typically this will be # used with the Microsoft FTP server or with NFS mounts. Use # is indicated by failure of the cdCommands script on # vxWorks. You must rebuild in the iocBoot directory # before this takes effect. #IOCS_APPL_TOP = <the top of the application as seen by the IOC>
END 1.1 Manual expansion of included file. Back to level 1
DIRS := $(DIRS) $(filter-out $(DIRS), configure) DIRS := $(DIRS) $(filter-out $(DIRS), $(wildcard *App)) DIRS := $(DIRS) $(filter-out $(DIRS), $(wildcard *app)) DIRS := $(DIRS) $(filter-out $(DIRS), $(wildcard iocBoot)) DIRS := $(DIRS) $(filter-out $(DIRS), $(wildcard iocboot)) include $(TOP)/configure/RULES_TOP
1.2 Manual expansion of line include $(TOP)/configure/RULES_TOP
#RULES_TOP include $(EPICS_BASE)/configure/RULES_TOP
1.2.1 Manual expansion of line include $(EPICS_BASE)/configure/RULES_TOP
#************************************************************************* # Copyright (c) 2002 The University of Chicago, as Operator of Argonne # National Laboratory. # Copyright (c) 2002 The Regents of the University of California, as # Operator of Los Alamos National Laboratory. # EPICS BASE Versions 3.13.7 # and higher are distributed subject to a Software License Agreement found # in file LICENSE that is included with this distribution. #************************************************************************* # # Revision-Id: [email protected] # include $(CONFIG)/RULES_DIRS UNINSTALL_DIRS += $(INSTALL_DBD) $(INSTALL_INCLUDE) $(INSTALL_DOC)\ $(INSTALL_HTML) $(INSTALL_JAVA) $(INSTALL_TEMPLATES) \ $(INSTALL_DB) UNINSTALL_DIRS += $(DIRECTORY_TARGETS) uninstallArchTargets = $(foreach arch,$(BUILD_ARCHS), uninstall$(DIVIDER)$(arch)) archPart = $(word 2, $(subst $(DIVIDER), ,$@)) $(uninstallArchTargets): uninstallDirs @$(RMDIR) $(INSTALL_LOCATION_BIN)/$(archPart) $(INSTALL_LOCATION_LIB)/$(archPart) cleandirs: ifeq ($(wildcard $(INSTALL_LOCATION_BIN)/*),) @$(RMDIR) $(INSTALL_LOCATION_BIN) endif ifeq ($(wildcard $(INSTALL_LOCATION_LIB)/*),) @$(RMDIR) $(INSTALL_LOCATION_LIB) endif @echo # The echo above stops a "nothing to be done for cleandirs" message distclean: realclean realuninstall CVSCLEAN=$(firstword $(wildcard $(TOOLS)/cvsclean.pl $(TOP)/src/tools/cvsclean.pl)) cvsclean: @$(PERL) $(CVSCLEAN) realuninstall: @$(RMDIR) $(INSTALL_LOCATION_BIN) $(INSTALL_LOCATION_LIB) @$(RMDIR) $(UNINSTALL_DIRS) uninstall: $(addprefix uninstall$(DIVIDER),$(BUILD_ARCHS)) @$(MAKE) -f Makefile cleandirs uninstallDirs: @$(RMDIR) $(UNINSTALL_DIRS) help: @echo "Usage: gnumake [options] [target] ..." @echo "Targets supported by all Makefiles:" @echo " install - Builds and installs all targets (default rule)" @echo " all - Same as install" @echo " buildInstall - Same as install" @echo " clean - Removes the O.<arch> dirs created by running make" @echo " In O.<arch> dir, clean removes build created files" @echo " realclean - Removes ALL O.<arch> dirs" @echo " Cannot be used within an O.<arch> dir" @echo " rebuild - Same as clean install" @echo " inc - Installs header files" @echo " build - Builds all targets" @echo " archclean - Removes O.<arch> dirs but not O.Common dir" @echo "\"Partial\" build targets supported by Makefiles:" @echo " inc.<arch> - Installs <arch> only header files." @echo " install.<arch> - Builds and installs <arch> only." @echo " clean.<arch> - Cleans <arch> binaries in O.<arch> dirs only." @echo " build.<arch> - Builds <arch> only." @echo "Targets supported by top level Makefile:" @echo " uninstall - Cleans directories created by the install." @echo " realuninstall - Removes ALL install dirs" @echo " distclean - Same as realclean realuninstall." @echo " cvsclean - Removes cvs .#* files in all dirs of directory tree" @echo " help - Prints this list of valid make targets " @echo "Indiv. object targets are supported by O.<arch> level Makefile .e.g" @echo " xxxRecord.o" .PHONY : $(uninstallArchTargets) .PHONY : uninstall help cleandirs distclean uninstallDirs realuninstall .PHONY : cvsclean
END 1.2.1 Manual expansion of included file. Back to level 1.2
END 1.2 Manual expansion of included file. Back to level 1
<nowiki>