Makefile.common

   1 #===-- Makefile.common - Common make rules for LLVM -------*- makefile -*--====
   2 #
   3 # This file is included by all of the LLVM makefiles.  This file defines common
   4 # rules to do things like compile a .cpp file or generate dependancy info.
   5 # These are platform dependant, so this is the file used to specify these
   6 # system dependant operations.
   7 #
   8 # The following functionality can be set by setting incoming variables.
   9 # The variable $(LEVEL) *must* be set:
  10 #
  11 # 1. LEVEL - The level of the current subdirectory from the top of the
  12 #    MagicStats view.  This level should be expressed as a path, for
  13 #    example, ../.. for two levels deep.
  14 #
  15 # 2. DIRS - A list of subdirectories to be built.  Fake targets are set up
  16 #    so that each of the targets "all", "install", and "clean" each build.
  17 #    the subdirectories before the local target.
  18 #
  19 # 3. Source - If specified, this sets the source code filenames.  If this
  20 #    is not set, it defaults to be all of the .cpp, .c, .y, and .l files
  21 #    in the current directory.  Also, if you want to build files in addition
  22 #    to the local files, you can use the ExtraSource variable
  23 #
  24 #===-----------------------------------------------------------------------====
  25
  26 # Configuration file to set paths specific to local installation of LLVM
  27 #
  28 include $(LEVEL)/Makefile.config
  29
  30 # These are options that can either be enabled here, or can be enabled on the
  31 # make command line (ie, make ENABLE_PROFILING=1)
  32 #
  33
  34 # When ENABLE_PROFILING is enabled, the llvm source base is built with profile
  35 # information to allow gprof to be used to get execution frequencies.
  36 #
  37 #ENABLE_PROFILING = 1
  38
  39 # When ENABLE_PURIFY is enabled, the LLVM tools are linked with purify (which
  40 # must be locally installed) to allow for some automated memory error debugging.
  41 #
  42 #ENABLE_PURIFY    = 1
  43
  44 # When ENABLE_OPTIMIZED is enabled, Release builds of all of the LLVM code are
  45 # turned on, and Debug builds are turned off.
  46 #
  47 #ENABLE_OPTIMIZED = 1
  48
  49 ifdef SHARED_LIBRARY
  50 # if SHARED_LIBRARY is specified, the default is to build the dynamic lib
  51 dynamic ::
  52 endif
  53
  54 # Default Rule:  Make sure it's also a :: rule
  55 all ::
  56
  57 # Default for install is to at least build everything...
  58 install ::
  59
  60
  61 # Figure out which directory to build stuff into.  We want to build into the
  62 # /shared directory by default because it is guaranteed to be local to the
  63 # current machine.
  64 #
  65 ifeq ($(LLVM_OBJ_DIR),.)
  66 BUILD_ROOT     = $(LLVM_OBJ_DIR)
  67 BUILD_ROOT_TOP = $(LEVEL)
  68 else
  69
  70 BUILD_ROOT := $(LLVM_OBJ_DIR)$(patsubst $(HOME)%,%,$(shell pwd))
  71
  72 # Calculate the BUILD_ROOT_TOP variable, which is the top of the llvm/ tree.
  73 # Note that although this is just equal to $(BUILD_ROOT)/$(LEVEL), we cannot use
  74 # this expression because some of the directories on the source tree may not
  75 # exist in the build tree (for example the test/ heirarchy).  Thus we evaluate
  76 # the directory to eliminate the ../'s
  77 #
  78 TOP_DIRECTORY := $(shell cd $(LEVEL); pwd)
  79 BUILD_ROOT_TOP := $(LLVM_OBJ_DIR)$(patsubst $(HOME)%,%,$(TOP_DIRECTORY))
  80 endif
  81
  82 #--------------------------------------------------------------------
  83 # Variables derived from configuration options...
  84 #--------------------------------------------------------------------
  85
  86 #BinInstDir=/usr/local/bin
  87 #LibInstDir=/usrl/local/lib/xxx
  88 #DocInstDir=/usr/doc/xxx
  89
  90 BURG_OPTS = -I
  91
  92 PURIFY := $(PURIFY) -cache-dir="$(BUILD_ROOT_TOP)/../purifycache" -chain-length="30" -messages=all
  93
  94 # Shorthand for commonly accessed directories
  95 LIBDEBUG    := $(BUILD_ROOT_TOP)/lib/Debug
  96 LIBRELEASE  := $(BUILD_ROOT_TOP)/lib/Release
  97 TOOLDEBUG   := $(BUILD_ROOT_TOP)/tools/Debug
  98 TOOLRELEASE := $(BUILD_ROOT_TOP)/tools/Release
  99
 100 # Verbosity levels
 101 ifdef VERBOSE
 102 VERB :=
 103 else
 104 VERB := @
 105 endif
 106
 107 #---------------------------------------------------------
 108 # Compilation options...
 109 #---------------------------------------------------------
 110
 111 # Special tools used while building
 112 RunBurg  := $(BURG) $(BURG_OPTS)
 113
 114 # Enable this for profiling support with 'gprof'
 115 ifdef ENABLE_PROFILING
 116 PROFILE = -pg
 117 else
 118 PROFILE =
 119 endif
 120
 121 # Allow gnu extensions...
 122 CPPFLAGS += -D_GNU_SOURCE
 123
 124 # -Wno-unused-parameter
 125 CompileCommonOpts := $(PROFILE) -Wall -W  -Wwrite-strings -Wno-unused -I$(LEVEL)/include
 126
 127 # Compile a file, don't link...
 128 Compile  := $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $(CompileCommonOpts)
 129 CompileG := $(Compile) -g  -D_DEBUG
 130 CompileO := $(Compile) -O3 -DNDEBUG -finline-functions -felide-constructors -fnonnull-objects -freg-struct-return -fshort-enums
 131
 132 # Link final executable
 133
 134 ifdef ENABLE_PURIFY # To enable purify, build with 'gmake ENABLE_PURIFY=1'
 135 Link     := $(PURIFY) $(CXX) $(PROFILE) -static
 136 else
 137 Link     := $(CXX) $(PROFILE)
 138 endif
 139 LinkG    := $(Link) -g  -L $(LIBDEBUG)
 140 LinkO    := $(Link) -O3 -L $(LIBRELEASE)
 141
 142 # Create one .o file from a bunch of .o files...
 143 Relink = ld -r
 144
 145 # Create dependancy file from CPP file, send to stdout.
 146 Depend   := $(CXX) -MM -I$(LEVEL)/include $(CPPFLAGS)
 147
 148 # Archive a bunch of .o files into a .a file...
 149 AR       = ar cq
 150
 151 #----------------------------------------------------------
 152
 153 # Source includes all of the cpp files, and objects are derived from the
 154 # source files...
 155 # The local Makefile can list other Source files via ExtraSource = ...
 156 #
 157 Source  := $(ExtraSource) $(wildcard *.cpp *.c *.y *.l)
 158
 159 Objs := $(sort $(patsubst Debug/%.o, %.o, $(addsuffix .o,$(basename $(Source)))))
 160 ObjectsO = $(addprefix $(BUILD_ROOT)/Release/,$(Objs)))
 161 ObjectsG = $(addprefix $(BUILD_ROOT)/Debug/,$(Objs))
 162
 163
 164 #---------------------------------------------------------
 165 # Handle the DIRS option
 166 #---------------------------------------------------------
 167
 168 ifdef DIRS  # Only do this if we're using DIRS!
 169
 170 all     :: $(addsuffix /.makeall    , $(DIRS))
 171 install :: $(addsuffix /.makeinstall, $(DIRS))
 172 clean   :: $(addsuffix /.makeclean  , $(DIRS))
 173
 174 %/.makeall %/.makeclean %/.makeinstall:
 175         $(VERB) cd $(@D); $(MAKE) $(subst $(@D)/.make,,$@)
 176 endif
 177
 178 #---------------------------------------------------------
 179 # Handle the LIBRARYNAME option - used when building libs...
 180 #---------------------------------------------------------
 181 #
 182 #  When libraries are built, they are allowed to optionally define the
 183 #  DONT_BUILD_RELINKED make variable, which, when defined, prevents a .o file
 184 #  from being built for the library. This .o files may then be linked to by a
 185 #  tool if the tool does not need (or want) the semantics a .a file provides
 186 #  (linking in only object files that are "needed").  If a library is never to
 187 #  be used in this way, it is better to define DONT_BUILD_RELINKED, and define
 188 #  BUILD_ARCHIVE instead.
 189 #
 190 #  Some libraries must be built as .a files (libscalar for example) because if
 191 #  it's built as a .o file, then all of the constituent .o files in it will be
 192 #  linked into tools (for example gccas) even if they only use one of the parts
 193 #  of it.  For this reason, sometimes it's useful to use libraries as .a files.
 194
 195 ifdef LIBRARYNAME
 196
 197 # Figure out how to make a .so file on this platform.  This is really gross and
 198 # should be autoconfiscated (automake actually), but should hopefully work on
 199 # linux and solaris.
 200 #
 201
 202 # Create a .so file from a .o files...
 203 UNAME := $(shell uname)
 204
 205 ifeq ($(UNAME), SunOS)
 206 MakeSO   := $(CXX) -G $(PROFILE)
 207 else
 208 MakeSO   := $(CXX) -shared $(PROFILE)
 209 endif
 210
 211 MakeSOO  := $(MakeSO) -O3
 212
 213
 214 LIBNAME_O    := $(LIBRELEASE)/lib$(LIBRARYNAME).so
 215 LIBNAME_G    := $(LIBDEBUG)/lib$(LIBRARYNAME).so
 216 LIBNAME_AO   := $(LIBRELEASE)/lib$(LIBRARYNAME).a
 217 LIBNAME_AG   := $(LIBDEBUG)/lib$(LIBRARYNAME).a
 218 LIBNAME_OBJO := $(LIBRELEASE)/$(LIBRARYNAME).o
 219 LIBNAME_OBJG := $(LIBDEBUG)/$(LIBRARYNAME).o
 220
 221
 222 ifndef ENABLE_OPTIMIZED
 223 BUILD_LIBNAME_G := $(LIBNAME_G)
 224 ifndef DONT_BUILD_RELINKED
 225 BUILD_LIBNAME_OBJG := $(LIBNAME_OBJG)
 226 endif
 227 ifdef BUILD_ARCHIVE
 228 BUILD_LIBNAME_AG := $(LIBNAME_AG)
 229 endif
 230 endif
 231
 232 # If optimized builds are enabled...
 233 ifdef ENABLE_OPTIMIZED
 234 BUILD_LIBNAME_O  := $(LIBNAME_O)
 235 ifndef DONT_BUILD_RELINKED
 236 BUILD_LIBNAME_OBJO := $(LIBNAME_OBJO)
 237 endif
 238 ifdef BUILD_ARCHIVE
 239 BUILD_LIBNAME_AO := $(LIBNAME_AO)
 240 endif
 241 endif
 242
 243 all:: $(BUILD_LIBNAME_AG) $(BUILD_LIBNAME_OBJG)      # Debug
 244 all:: $(BUILD_LIBNAME_AO) $(BUILD_LIBNAME_OBJO)      # Release
 245 dynamic:: $(BUILD_LIBNAME_G) $(BUILD_LIBNAME_O)      # .so files
 246
 247 $(LIBNAME_O): $(ObjectsO) $(LibSubDirs) $(LIBRELEASE)/.dir
 248         @echo ======= Linking $(LIBRARYNAME) release library =======
 249         $(VERB) $(MakeSOO) -o $@ $(ObjectsO) $(LibSubDirs) $(LibLinkOpts)
 250
 251 $(LIBNAME_G): $(ObjectsG) $(LibSubDirs) $(LIBDEBUG)/.dir
 252         @echo ======= Linking $(LIBRARYNAME) debug library =======
 253         $(VERB) $(MakeSO) -g -o $@ $(ObjectsG) $(LibSubDirs) $(LibLinkOpts)
 254
 255 $(LIBNAME_AO): $(ObjectsO) $(LibSubDirs) $(LIBRELEASE)/.dir
 256         @echo ======= Linking $(LIBRARYNAME) release library =======
 257         @rm -f $@
 258         $(VERB) $(AR) $@ $(ObjectsO) $(LibSubDirs)
 259
 260 $(LIBNAME_AG): $(ObjectsG) $(LibSubDirs) $(LIBDEBUG)/.dir
 261         @echo ======= Linking $(LIBRARYNAME) debug library =======
 262         @rm -f $@
 263         $(VERB) $(AR) $@ $(ObjectsG) $(LibSubDirs)
 264
 265 $(LIBNAME_OBJO): $(ObjectsO) $(LibSubDirs) $(LIBRELEASE)/.dir
 266         @echo "Linking $@"
 267         $(VERB) $(Relink) -o $@ $(ObjectsO) $(LibSubDirs)
 268
 269 $(LIBNAME_OBJG): $(ObjectsG) $(LibSubDirs) $(LIBDEBUG)/.dir
 270         $(VERB) $(Relink) -o $@ $(ObjectsG) $(LibSubDirs)
 271
 272 endif
 273
 274 #------------------------------------------------------------------------
 275 # Create a TAGS database for emacs
 276 #------------------------------------------------------------------------
 277
 278 ifeq ($(LEVEL), .)
 279 tags:
 280         etags -l c++ `find include lib tools -name '*.cpp' -o -name '*.h'`
 281 all:: tags
 282 endif
 283
 284 #------------------------------------------------------------------------
 285 # Handle the TOOLNAME option - used when building tool executables...
 286 #------------------------------------------------------------------------
 287 #
 288 # The TOOLNAME option should be used with a USEDLIBS variable that tells the
 289 # libraries (and the order of the libs) that should be linked to the
 290 # tool. USEDLIBS should contain a list of library names (some with .a extension)
 291 # that are automatically linked in as .o files unless the .a suffix is added.
 292 #
 293 ifdef TOOLNAME
 294
 295 # TOOLEXENAME* - These compute the output filenames to generate...
 296 TOOLEXENAME_G := $(BUILD_ROOT_TOP)/tools/Debug/$(TOOLNAME)
 297 TOOLEXENAME_O := $(BUILD_ROOT_TOP)/tools/Release/$(TOOLNAME)
 298 TOOLEXENAMES  := $(TOOLEXENAME_G)
 299 ifdef ENABLE_OPTIMIZED
 300 TOOLEXENAMES += $(TOOLEXENAME_O)
 301 endif
 302
 303 # USED_LIBS_OPTIONS - Compute the options line that add -llib1 -llib2, etc.
 304 USED_LIBS_OPTIONS   := $(patsubst %.a.o, -l%, $(addsuffix .o, $(USEDLIBS)))
 305 USED_LIBS_OPTIONS_G := $(patsubst %.o, $(LIBDEBUG)/%.o,  $(USED_LIBS_OPTIONS))
 306 USED_LIBS_OPTIONS_O := $(patsubst %.o, $(LIBRELEASE)/%.o,$(USED_LIBS_OPTIONS))
 307
 308
 309 # USED_LIB_PATHS - Compute the path of the libraries used so that tools are
 310 # rebuilt if libraries change.  This has to make sure to handle .a/.so and .o
 311 # files seperately.
 312 #
 313 STATICUSEDLIBS   := $(patsubst %.a.o, lib%.a, $(addsuffix .o, $(USEDLIBS)))
 314 USED_LIB_PATHS_G := $(addprefix $(LIBDEBUG)/, $(STATICUSEDLIBS))
 315 USED_LIB_PATHS_O := $(addprefix $(LIBRELEASE)/, $(STATICUSEDLIBS))
 316
 317 all::   $(TOOLEXENAMES)
 318 clean::
 319         $(VERB) rm -f $(TOOLEXENAMES)
 320
 321 $(TOOLEXENAME_G): $(ObjectsG) $(USED_LIB_PATHS_G) $(BUILD_ROOT_TOP)/tools/Debug/.dir
 322         @echo ======= Linking $(TOOLNAME) debug executable =======
 323         $(VERB) $(LinkG) -o $@ $(ObjectsG) $(USED_LIBS_OPTIONS_G) $(TOOLLINKOPTS)
 324
 325 $(TOOLEXENAME_O): $(ObjectsO) $(USED_LIB_PATHS_O) $(BUILD_ROOT_TOP)/tools/Release/.dir
 326         @echo ======= Linking $(TOOLNAME) release executable =======
 327         $(VERB) $(LinkO) -o $@ $(ObjectsG) $(USED_LIBS_OPTIONS_O) $(TOOLLINKOPTS)
 328
 329 endif
 330
 331
 332
 333 #---------------------------------------------------------
 334 .PRECIOUS: $(BUILD_ROOT)/Depend/.dir
 335 .PRECIOUS: $(BUILD_ROOT)/Debug/.dir $(BUILD_ROOT)/Release/.dir
 336
 337 # Create dependencies for the *.cpp files...
 338 $(BUILD_ROOT)/Depend/%.d: %.cpp $(BUILD_ROOT)/Depend/.dir
 339         $(VERB) $(Depend) $< | sed 's|$*\.o *|$(BUILD_ROOT)/Release/& $(BUILD_ROOT)/Debug/& $(BUILD_ROOT)/Depend/$(@F)|g' > $@
 340
 341 # Create dependencies for the *.c files...
 342 $(BUILD_ROOT)/Depend/%.d: %.c $(BUILD_ROOT)/Depend/.dir
 343         $(VERB) $(Depend) $< | sed 's|$*\.o *|Release/& Debug/& Depend/$(@F)|g' > $@
 344
 345 # Create .o files in the ObjectFiles directory from the .cpp and .c files...
 346 $(BUILD_ROOT)/Release/%.o: %.cpp $(BUILD_ROOT)/Release/.dir
 347         @echo "Compiling $<"
 348         $(VERB) $(CompileO) $< -o $@
 349
 350 #Release/%.o: %.c Release/.dir Depend/.dir
 351 #       $(CompileOC) $< -o $@
 352
 353 $(BUILD_ROOT)/Debug/%.o: %.cpp $(BUILD_ROOT)/Debug/.dir
 354         @echo "Compiling $<"
 355         $(VERB) $(CompileG) $< -o $@
 356
 357 #Debug/%.o: %.c Debug/.dir
 358 #       $(CompileGC) $< -o $@
 359
 360 # Create a .cpp source file from a flex input file... this uses sed to cut down
 361 # on the warnings emited by GCC...
 362 %.cpp: %.l
 363         flex -t $< | sed '/^find_rule/d' | sed 's/void yyunput/inline void yyunput/' | sed 's/void \*yy_flex_realloc/inline void *yy_flex_realloc/' > $@
 364
 365 # Rule for building the bison parsers...
 366
 367 %.cpp %.h : %.y
 368         $(VERB) bison -v -d -p $(<:%Parser.y=%) $(basename $@).y
 369         $(VERB) mv -f $(basename $@).tab.c $(basename $@).cpp
 370         $(VERB) mv -f $(basename $@).tab.h $(basename $@).h
 371
 372 # To create the directories...
 373 %/.dir:
 374         $(VERB) mkdir -p $(@D)
 375         @date > $@
 376
 377 # Clean nukes the tree
 378 clean::
 379         $(VERB) rm -rf $(BUILD_ROOT)/Debug $(BUILD_ROOT)/Release $(BUILD_ROOT)/Depend
 380         $(VERB) rm -f core *.o *.d *.so *~ *.flc
 381
 382 # If dependancies were generated for the file that included this file,
 383 # include the dependancies now...
 384 #
 385 SourceDepend := $(addsuffix .d,$(addprefix $(BUILD_ROOT)/Depend/,$(basename $(filter-out Debug/%, $(Source)))))
 386 ifneq ($(SourceDepend),)
 387 include $(SourceDepend)
 388 endif