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 # -----------------------------------------------------------------------------
14 # Build a program. Invoke like this:
16 # utils/genapply_MODULES = Main
17 # utils/genapply_HC_OPTS = -package Cabal
18 # utils/genapply_dist_PROG = genapply
20 # $(eval $(call build-prog,utils/genapply,dist-install,1))
25 # $3 = GHC stage to use (0 == bootstrapping compiler)
27 ifneq "$$(CLEANING)" "YES"
28 ifeq "$$($1_$2_PROG)" ""
29 $$(error $1_$2_PROG is not set)
33 ifeq "$$(findstring $3,0 1 2)" ""
34 $$(error $1/$2: stage argument to build-prog should be 0, 1, or 2)
37 $(call all-target,$1,all_$1_$2)
39 $(call clean-target,$1,$2,$1/$2)
41 $(call package-config,$1,$2,$3)
43 ifeq "$$($1_USES_CABAL)" "YES"
44 ifneq "$$(NO_INCLUDE_PKGDATA)" "YES"
45 include $1/$2/package-data.mk
49 ifeq "$$($1_USES_CABAL)$$($1_$2_VERSION)" "YES"
53 ifeq "$$($1_$2_DISABLE)" "YES"
55 ifeq "$$(DEBUG)" "YES"
56 $$(warning $1/$2 disabled)
59 # The following code to build the package all depends on settings
60 # obtained from package-data.mk. If we don't have package-data.mk
61 # yet, then don't try to do anything else with this package. Make will
62 # try to build package-data.mk, then restart itself and we'll be in business.
64 $(call all-target,$1_$2,$1/$2/package-data.mk)
66 # We have a rule for package-data.mk only when the package is
67 # disabled, because we want the build to fail if we haven't run phase 0.
68 ifneq "$(BINDIST)" "YES"
69 $(call build-package-data,$1,$2)
74 ifneq "$(BINDIST)" "YES"
75 $(call hs-sources,$1,$2)
76 $(call c-sources,$1,$2)
80 $1_$2_depfile = $1/$2/build/.depend
82 $(call build-dependencies,$1,$2)
86 $(call distdir-opts,$1,$2,$3)
88 # Just the 'v' way for programs
89 $(call distdir-way-opts,$1,$2,v)
91 $(call c-suffix-rules,$1,$2,v,YES)
93 $(call hs-suffix-rules,$1,$2,v)
94 $$(foreach dir,$$($1_$2_HS_SRC_DIRS),\
95 $$(eval $$(call hs-suffix-rules-srcdir,$1,$2,v,$$(dir))))
97 $(call c-objs,$1,$2,v)
98 $(call hs-objs,$1,$2,v)
100 ifeq "$$(BootingFromHc)" "NO"
101 $1/$2/build/tmp/$$($1_$2_PROG) : $$($1_$2_v_HS_OBJS) $$($1_$2_v_C_OBJS) $$($1_$2_v_S_OBJS) $$($1_$2_OTHER_OBJS)
102 "$$(MKDIRHIER)" $$(dir $$@)
103 "$$($1_$2_HC)" -o $$@ $$($1_$2_v_ALL_HC_OPTS) $$(LD_OPTS) $$($1_$2_v_HS_OBJS) $$($1_$2_v_C_OBJS) $$($1_$2_v_S_OBJS) $$($1_$2_OTHER_OBJS)
105 $1/$2/build/tmp/$$($1_$2_PROG) : $$($1_$2_v_HS_OBJS) $$($1_$2_v_C_OBJS) $$($1_$2_v_S_OBJS) $$($1_$2_OTHER_OBJS)
106 "$$(MKDIRHIER)" $$(dir $$@)
107 "$$(CC)" -o $$@ $$($1_$2_v_ALL_CC_OPTS) $$(LD_OPTS) $$($1_$2_v_HS_OBJS) $$($1_$2_v_C_OBJS) $$($1_$2_v_S_OBJS) $$($1_$2_OTHER_OBJS) $$($1_$2_v_EXTRA_CC_OPTS)
110 # Note [lib-depends] if this program is built with stage1 or greater, we
111 # need to depend on the libraries too. NB. since $(ALL_STAGE1_LIBS) and
112 # $(ALL_RTS_LIBS) are not defined until after libraries/*/ghc.mk have
113 # been included, this introduces an ordering dependency.
115 ifeq "$$(ALL_STAGE1_LIBS)" ""
116 $$(error ordering failure in $1: $$(ALL_STAGE1_LIBS) is empty)
118 $1/$2/build/tmp/$($1_$2_PROG) : $$(ALL_STAGE1_LIBS) $$(ALL_RTS_LIBS) $$(OTHER_LIBS)
122 ifeq "$$($1_$2_INSTALL_INPLACE)" "NO"
123 $(call all-target,$1_$2,$1/$2/build/tmp/$$($1_$2_PROG))
125 # Where do we install the inplace version?
126 ifeq "$$($1_$2_SHELL_WRAPPER) $$(Windows)" "YES NO"
127 $1_$2_INPLACE = $$(INPLACE_LIB)/$$($1_$2_PROG)
129 ifeq "$$($1_$2_LIBEXEC)" "YES"
130 $1_$2_INPLACE = $$(INPLACE_LIB)/$$($1_$2_PROG)
132 $1_$2_INPLACE = $$(INPLACE_BIN)/$$($1_$2_PROG)
136 $(call all-target,$1_$2,$$($1_$2_INPLACE))
137 $(call clean-target,$1,$2_inplace,$$($1_$2_INPLACE))
139 # INPLACE_BIN might be empty if we're distcleaning
140 ifeq "$(findstring clean,$(MAKECMDGOALS))" ""
141 $$($1_$2_INPLACE) : $1/$2/build/tmp/$$($1_$2_PROG) $$(MKDIRHIER)
142 "$$(MKDIRHIER)" $$(dir $$@)
147 # touch is necessary; cp doesn't update the file time.
150 $(call shell-wrapper,$1,$2)
152 ifeq "$$($1_$2_INSTALL)" "YES"
153 ifeq "$$($1_$2_LIBEXEC)" "YES"
154 INSTALL_LIBEXECS += $1/$2/build/tmp/$$($1_$2_PROG)
156 INSTALL_BINS += $1/$2/build/tmp/$$($1_$2_PROG)
160 endif # package-data.mk exists