1 # -----------------------------------------------------------------------------
3 # (c) 2009 The University of Glasgow
5 # This file is part of the GHC build system.
7 # To understand how the build system works and how to modify it, see
8 # http://hackage.haskell.org/trac/ghc/wiki/Building/Architecture
9 # http://hackage.haskell.org/trac/ghc/wiki/Building/Modifying
11 # -----------------------------------------------------------------------------
13 # -----------------------------------------------------------------------------
16 # We build the RTS with stage 1
17 rts_dist_HC = $(GHC_STAGE1)
19 # merge GhcLibWays and GhcRTSWays but strip out duplicates
20 rts_WAYS = $(GhcLibWays) $(filter-out $(GhcLibWays),$(GhcRTSWays))
22 ALL_RTS_LIBS = $(foreach way,$(rts_WAYS),rts/dist/build/libHSrts$($(way)_libsuf)) \
23 rts/dist/build/libHSrtsmain.a
24 all_rts : $(ALL_RTS_LIBS)
26 # -----------------------------------------------------------------------------
27 # Defining the sources
29 ALL_DIRS = hooks parallel sm eventlog
31 ifeq "$(HOSTPLATFORM)" "i386-unknown-mingw32"
37 EXCLUDED_SRCS += rts/Main.c
38 EXCLUDED_SRCS += rts/parallel/SysMan.c
39 EXCLUDED_SRCS += rts/dyn-wrapper.c
40 EXCLUDED_SRCS += $(wildcard rts/Vis*.c)
42 rts_C_SRCS = $(filter-out $(EXCLUDED_SRCS),$(wildcard rts/*.c $(foreach dir,$(ALL_DIRS),rts/$(dir)/*.c)))
43 rts_CMM_SRCS = $(wildcard rts/*.cmm)
45 # Don't compile .S files when bootstrapping a new arch
46 ifeq "$(TARGETPLATFORM)" "$(HOSTPLATFORM)"
47 ifneq "$(findstring $(TargetArch_CPP), powerpc powerpc64)" ""
48 rts_S_SRCS += rts/AdjustorAsm.S
50 ifneq "$(findstring $(TargetOS_CPP), darwin)" ""
51 rts_S_SRCS += rts/AdjustorAsm.S
56 ifeq "$(GhcUnregisterised)" "YES"
60 rts_AUTO_APPLY_CMM = rts/dist/build/AutoApply.cmm
62 $(rts_AUTO_APPLY_CMM): $(GENAPPLY_INPLACE)
63 "$(GENAPPLY_INPLACE)" >$@
65 rts/dist/build/sm/Evac_thr.c : rts/sm/Evac.c | $$(dir $$@)/.
67 rts/dist/build/sm/Scav_thr.c : rts/sm/Scav.c | $$(dir $$@)/.
70 rts_H_FILES = $(wildcard includes/*.h) $(wildcard rts/*.h)
72 # collect the -l flags that we need to link the rts dyn lib.
73 rts/libs.depend : $(GHC_PKG_INPLACE)
74 "$(GHC_PKG_INPLACE)" field rts extra-libraries \
75 | sed -e 's/^extra-libraries: //' -e 's/\([a-z0-9]*\)[ ]*/-l\1 /g' > $@
77 #-----------------------------------------------------------------------------
80 define build-rts-way # args: $1 = way
83 ifneq "$$(findstring debug, $1)" ""
85 rts_dist_$1_CC_OPTS = -g -O0
87 rts_dist_$1_HC_OPTS = $$(GhcRtsHcOpts)
88 rts_dist_$1_CC_OPTS = $$(GhcRtsCcOpts)
91 ifneq "$$(findstring thr, $1)" ""
92 rts_$1_EXTRA_C_SRCS = rts/dist/build/sm/Evac_thr.c rts/dist/build/sm/Scav_thr.c
95 $(call distdir-way-opts,rts,dist,$1)
96 $(call c-suffix-rules,rts,dist,$1,YES)
97 $(call cmm-suffix-rules,rts,dist,$1)
99 rts_$1_LIB = rts/dist/build/libHSrts$$($1_libsuf)
101 rts_$1_C_OBJS = $$(patsubst rts/%.c,rts/dist/build/%.$$($1_osuf),$$(rts_C_SRCS)) $$(patsubst %.c,%.$$($1_osuf),$$(rts_$1_EXTRA_C_SRCS))
102 rts_$1_S_OBJS = $$(patsubst rts/%.S,rts/dist/build/%.$$($1_osuf),$$(rts_S_SRCS))
103 rts_$1_CMM_OBJS = $$(patsubst rts/%.cmm,rts/dist/build/%.$$($1_osuf),$$(rts_CMM_SRCS)) $$(patsubst %.cmm,%.$$($1_osuf),$$(rts_AUTO_APPLY_CMM))
105 rts_$1_OBJS = $$(rts_$1_C_OBJS) $$(rts_$1_S_OBJS) $$(rts_$1_CMM_OBJS)
107 rts_dist_$1_CC_OPTS += -DRtsWay=$$(DQ)rts_$1$$(DQ)
109 ifneq "$$(findstring dyn, $1)" ""
110 $$(rts_$1_LIB) : $$(rts_$1_OBJS) rts/libs.depend
111 "$$(RM)" $$(RM_OPTS) $$@
112 "$$(rts_dist_HC)" -shared -dynamic -dynload deploy \
113 -no-auto-link-packages `cat rts/libs.depend` $$(rts_$1_OBJS) -o $$@
115 $$(rts_$1_LIB) : $$(rts_$1_OBJS)
116 "$$(RM)" $$(RM_OPTS) $$@
117 echo $$(rts_$1_OBJS) | $$(XARGS) $$(AR) $$(EXTRA_AR_ARGS) $$@
122 # And expand the above for each way:
123 $(foreach way,$(rts_WAYS),$(eval $(call build-rts-way,$(way))))
125 #-----------------------------------------------------------------------------
126 # Flags for compiling every file
128 # We like plenty of warnings.
129 WARNING_OPTS += -Wall
130 ifeq "$(GccLT34)" "YES"
133 WARNING_OPTS += -Wextra
135 WARNING_OPTS += -Wstrict-prototypes
136 WARNING_OPTS += -Wmissing-prototypes
137 WARNING_OPTS += -Wmissing-declarations
138 WARNING_OPTS += -Winline
139 WARNING_OPTS += -Waggregate-return
140 WARNING_OPTS += -Wpointer-arith
141 WARNING_OPTS += -Wmissing-noreturn
142 WARNING_OPTS += -Wcast-align
143 WARNING_OPTS += -Wnested-externs
144 WARNING_OPTS += -Wredundant-decls
146 # These ones are hard to avoid:
147 #WARNING_OPTS += -Wconversion
148 #WARNING_OPTS += -Wbad-function-cast
149 #WARNING_OPTS += -Wshadow
150 #WARNING_OPTS += -Wcast-qual
152 STANDARD_OPTS += -Iincludes -Irts
153 # COMPILING_RTS is only used when building Win32 DLL support.
154 STANDARD_OPTS += -DCOMPILING_RTS
156 # HC_OPTS is included in both .c and .cmm compilations, whereas CC_OPTS is
157 # only included in .c compilations. HC_OPTS included the WAY_* opts, which
158 # must be included in both types of compilations.
160 rts_CC_OPTS += $(WARNING_OPTS)
161 rts_CC_OPTS += $(STANDARD_OPTS)
163 rts_HC_OPTS += $(STANDARD_OPTS) -package-name rts
165 ifneq "$(GhcWithSMP)" "YES"
166 rts_CC_OPTS += -DNOSMP
167 rts_HC_OPTS += -optc-DNOSMP
170 ifeq "$(UseLibFFIForAdjustors)" "YES"
171 rts_CC_OPTS += -DUSE_LIBFFI_FOR_ADJUSTORS
174 # Mac OS X: make sure we compile for the right OS version
175 rts_CC_OPTS += $(MACOSX_DEPLOYMENT_CC_OPTS)
176 rts_HC_OPTS += $(addprefix -optc, $(MACOSX_DEPLOYMENT_CC_OPTS))
177 rts_LD_OPTS += $(addprefix -optl, $(MACOSX_DEPLOYMENT_LD_OPTS))
179 # Otherwise the stack-smash handler gets triggered.
180 ifneq "$(findstring $(TargetOS_CPP), darwin openbsd)" ""
181 rts_HC_OPTS += -optc-fno-stack-protector
184 # We *want* type-checking of hand-written cmm.
185 rts_HC_OPTS += -dcmm-lint
187 # -fno-strict-aliasing is required for the runtime, because we often
188 # use a variety of types to represent closure pointers (StgPtr,
189 # StgClosure, StgMVar, etc.), and without -fno-strict-aliasing gcc is
190 # allowed to assume that these pointers do not alias. eg. without
191 # this flag we get problems in sm/Evac.c:copy() with gcc 3.4.3, the
192 # upd_evacee() assigments get moved before the object copy.
193 rts_CC_OPTS += -fno-strict-aliasing
195 rts_CC_OPTS += -fno-common
197 ifeq "$(BeConservative)" "YES"
198 rts_CC_OPTS += -DBE_CONSERVATIVE
201 #-----------------------------------------------------------------------------
202 # Flags for compiling specific files
204 # XXX DQ is now the same on all platforms, so get rid of it
207 # If RtsMain.c is built with optimisation then the SEH exception stuff on
208 # Windows gets confused.
209 # This has to be in HC rather than CC opts, as otherwise there's a
210 # -optc-O2 that comes after it.
211 rts/RtsMain_HC_OPTS += -optc-O0
213 rts/RtsMessages_CC_OPTS += -DProjectVersion=$(DQ)$(ProjectVersion)$(DQ)
214 rts/RtsUtils_CC_OPTS += -DProjectVersion=$(DQ)$(ProjectVersion)$(DQ)
216 rts/RtsUtils_CC_OPTS += -DHostPlatform=$(DQ)$(HOSTPLATFORM)$(DQ)
217 rts/RtsUtils_CC_OPTS += -DHostArch=$(DQ)$(HostArch_CPP)$(DQ)
218 rts/RtsUtils_CC_OPTS += -DHostOS=$(DQ)$(HostOS_CPP)$(DQ)
219 rts/RtsUtils_CC_OPTS += -DHostVendor=$(DQ)$(HostVendor_CPP)$(DQ)
221 rts/RtsUtils_CC_OPTS += -DBuildPlatform=$(DQ)$(BUILDPLATFORM)$(DQ)
222 rts/RtsUtils_CC_OPTS += -DBuildArch=$(DQ)$(BuildArch_CPP)$(DQ)
223 rts/RtsUtils_CC_OPTS += -DBuildOS=$(DQ)$(BuildOS_CPP)$(DQ)
224 rts/RtsUtils_CC_OPTS += -DBuildVendor=$(DQ)$(BuildVendor_CPP)$(DQ)
226 rts/RtsUtils_CC_OPTS += -DTargetPlatform=$(DQ)$(TARGETPLATFORM)$(DQ)
227 rts/RtsUtils_CC_OPTS += -DTargetArch=$(DQ)$(TargetArch_CPP)$(DQ)
228 rts/RtsUtils_CC_OPTS += -DTargetOS=$(DQ)$(TargetOS_CPP)$(DQ)
229 rts/RtsUtils_CC_OPTS += -DTargetVendor=$(DQ)$(TargetVendor_CPP)$(DQ)
231 rts/RtsUtils_CC_OPTS += -DGhcUnregisterised=$(DQ)$(GhcUnregisterised)$(DQ)
232 rts/RtsUtils_CC_OPTS += -DGhcEnableTablesNextToCode=$(DQ)$(GhcEnableTablesNextToCode)$(DQ)
234 # ffi.h triggers prototype warnings, so disable them here:
235 rts/Interpreter_CC_OPTS += -Wno-strict-prototypes
236 rts/Adjustor_CC_OPTS += -Wno-strict-prototypes
237 rts/sm/Storage_CC_OPTS += -Wno-strict-prototypes
239 # inlining warnings happen in Compact
240 rts/sm/Compact_CC_OPTS += -Wno-inline
242 # emits warnings about call-clobbered registers on x86_64
243 rts/StgCRun_CC_OPTS += -w
245 rts/RetainerProfile_CC_OPTS += -w
246 rts/RetainerSet_CC_OPTS += -Wno-format
248 rts/win32/ConsoleHandler_CC_OPTS += -w
249 rts/win32/ThrIOManager_CC_OPTS += -w
250 rts/win32/Ticker_CC_OPTS += -w
251 # The above warning supression flags are a temporary kludge.
252 # While working on this module you are encouraged to remove it and fix
253 # any warnings in the module. See
254 # http://hackage.haskell.org/trac/ghc/wiki/WorkingConventions#Warnings
257 # Without this, thread_obj will not be inlined (at least on x86 with GCC 4.1.0)
258 rts/sm/Compact_CC_OPTS += -finline-limit=2500
260 # -O3 helps unroll some loops (especially in copy() with a constant argument).
261 rts/sm/Evac_CC_OPTS += -funroll-loops
262 rts/dist/build/sm/Evac_thr_HC_OPTS += -optc-funroll-loops
264 # These files are just copies of sm/Evac.c and sm/Scav.c respectively,
265 # but compiled with -DPARALLEL_GC.
266 rts/dist/build/sm/Evac_thr_HC_OPTS += -optc-DPARALLEL_GC -Irts/sm
267 rts/dist/build/sm/Scav_thr_HC_OPTS += -optc-DPARALLEL_GC -Irts/sm
269 #-----------------------------------------------------------------------------
270 # Add PAPI library if needed
272 ifeq "$(GhcRtsWithPapi)" "YES"
274 rts_CC_OPTS += -DUSE_PAPI
276 rts_PACKAGE_CPP_OPTS += -DUSE_PAPI
277 rts_PACKAGE_CPP_OPTS += -DPAPI_INCLUDE_DIR=$(PapiIncludeDir)
278 rts_PACKAGE_CPP_OPTS += -DPAPI_LIB_DIR=$(PapiLibDir)
280 ifneq "$(PapiIncludeDir)" ""
281 rts_HC_OPTS += -I$(PapiIncludeDir)
282 rts_CC_OPTS += -I$(PapiIncludeDir)
283 rts_HSC2HS_OPTS += -I$(PapiIncludeDir)
285 ifneq "$(PapiLibDirs)" ""
286 rts_LD_OPTS += -L$(PapiLibDirs)
289 else # GhcRtsWithPapi==YES
291 rts_PACKAGE_CPP_OPTS += -DPAPI_INCLUDE_DIR=""
292 rts_PACKAGE_CPP_OPTS += -DPAPI_LIB_DIR=""
296 # -----------------------------------------------------------------------------
299 # Hack: we define every way-related option here, so that we get (hopefully)
300 # a superset of the dependencies. To do this properly, we should generate
301 # a different set of dependencies for each way. Further hack: PROFILING and
302 # TICKY_TICKY can't be used together, so we omit TICKY_TICKY for now.
303 rts_MKDEPENDC_OPTS += -DPROFILING -DTHREADED_RTS -DDEBUG
304 rts_MKDEPENDC_OPTS += -Irts/sm
306 rts_WAYS_DASHED = $(subst $(space),,$(patsubst %,-%,$(strip $(rts_WAYS))))
307 rts_dist_depfile = rts/dist/build/.depend$(rts_WAYS_DASHED)
309 rts_dist_C_SRCS = $(rts_C_SRCS) $(rts_thr_EXTRA_C_SRCS)
310 rts_dist_S_SRCS = $(rts_S_SRCS)
311 rts_dist_C_FILES = $(rts_C_SRCS) $(rts_thr_EXTRA_C_SRCS) $(rts_S_SRCS)
313 $(eval $(call build-dependencies,rts,dist))
315 $(rts_dist_depfile) : libffi/ffi.h
317 #-----------------------------------------------------------------------------
320 rts_CC_OPTS += -Ilibffi/build/include
321 rts_HC_OPTS += -Ilibffi/build/include
322 rts_HSC2HS_OPTS += -Ilibffi/build/include
323 rts_LD_OPTS += -Llibffi/build/include
325 # -----------------------------------------------------------------------------
326 # compile generic patchable dyn-wrapper
328 DYNWRAPPER_SRC = rts/dyn-wrapper.c
329 DYNWRAPPER_PROG = rts/dyn-wrapper$(exeext)
330 $(DYNWRAPPER_PROG): $(DYNWRAPPER_SRC)
331 "$(HC)" -cpp -optc-include -optcdyn-wrapper-patchable-behaviour.h $(INPLACE_EXTRA_FLAGS) $< -o $@
333 # -----------------------------------------------------------------------------
334 # build the static lib containing the C main symbol
336 rts/dist/build/libHSrtsmain.a : rts/dist/build/Main.o
337 $(AR) $(EXTRA_AR_ARGS) $@ $<
339 # -----------------------------------------------------------------------------
340 # The RTS package config
342 # If -DDEBUG is in effect, adjust package conf accordingly..
343 ifneq "$(strip $(filter -optc-DDEBUG,$(GhcRtsHcOpts)))" ""
344 rts_PACKAGE_CPP_OPTS += -DDEBUG
347 ifeq "$(HaveLibMingwEx)" "YES"
348 rts_PACKAGE_CPP_OPTS += -DHAVE_LIBMINGWEX
351 $(eval $(call manual-package-config,rts))
353 ifneq "$(BootingFromHc)" "YES"
354 rts/package.conf.inplace : $(includes_H_CONFIG) $(includes_H_PLATFORM)
357 # -----------------------------------------------------------------------------
360 install : install_rts
364 $(INSTALL_DIR) $(DESTDIR)$(ghclibdir)
365 $(INSTALL_DIR) $(DESTDIR)$(ghclibdir)/include
366 "$(CP)" $(ALL_RTS_LIBS) $(DESTDIR)$(ghclibdir)
368 # -----------------------------------------------------------------------------
371 $(eval $(call clean-target,rts,dist,rts/dist))
373 BINDIST_EXTRAS += rts/package.conf.in
374 BINDIST_EXTRAS += $(ALL_RTS_LIBS)