Merge pull request #2400 from esdrubal/extrahead
[mono.git] / mcs / build / library.make
1 # -*- makefile -*-
2 #
3 # The rules for building our class libraries.
4 #
5 # The NO_TEST stuff is not too pleasant but whatcha
6 # gonna do.
7
8 # All the dep files now land in the same directory so we
9 # munge in the library name to keep the files from clashing.
10
11 # The including makefile can set the following variables:
12 # LIB_MCS_FLAGS - Command line flags passed to mcs.
13 # LIB_REFS      - This should be a space separated list of assembly names which are added to the mcs
14 #                 command line.
15 #
16
17 # All dependent libs become dependent dirs for parallel builds
18 # Have to rename to handle differences between assembly/directory names
19 DEP_LIBS=$(patsubst System.Xml,System.XML,$(LIB_REFS))
20
21 LIB_MCS_FLAGS += $(patsubst %,-r:%,$(LIB_REFS))
22
23 sourcefile = $(LIBRARY).sources
24
25 # If the directory contains the per profile include file, generate list file.
26 PROFILE_sources := $(wildcard $(PROFILE)_$(LIBRARY).sources)
27 ifdef PROFILE_sources
28 PROFILE_excludes = $(wildcard $(PROFILE)_$(LIBRARY).exclude.sources)
29 sourcefile = $(depsdir)/$(PROFILE)_$(LIBRARY).sources
30 library_CLEAN_FILES += $(sourcefile)
31
32 ifdef EXTENSION_MODULE
33 EXTENSION_include = $(wildcard $(topdir)/../../mono-extensions/mcs/$(thisdir)/$(PROFILE)_$(LIBRARY).sources)
34 else
35 EXTENSION_include = $(wildcard $(PROFILE)_opt_$(LIBRARY).sources)
36 endif
37
38
39 ifdef EXTENSION_MODULE
40 EXTENSION_exclude = $(wildcard $(topdir)/../../mono-extensions/mcs/$(thisdir)/$(PROFILE)_$(LIBRARY).exclude.sources)
41 else
42 EXTENSION_exclude = $(wildcard $(PROFILE)_opt_$(LIBRARY).exclude.sources)
43 endif
44
45 # Note, gensources.sh can create a $(sourcefile).makefrag if it sees any '#include's
46 # We don't include it in the dependencies since it isn't always created
47 $(sourcefile): $(PROFILE_sources) $(PROFILE_excludes) $(topdir)/build/gensources.sh $(EXTENSION_include)
48         @echo Creating the per profile list $@ ...
49         $(SHELL) $(topdir)/build/gensources.sh $@ '$(PROFILE_sources)' '$(PROFILE_excludes)' '$(EXTENSION_include)' '$(EXTENSION_exclude)'
50 endif
51
52 PLATFORM_excludes := $(wildcard $(LIBRARY).$(PLATFORM)-excludes)
53
54 ifndef PLATFORM_excludes
55 ifeq (cat,$(PLATFORM_CHANGE_SEPARATOR_CMD))
56 response = $(sourcefile)
57 endif
58 endif
59
60 ifndef response
61 response = $(depsdir)/$(PROFILE)_$(LIBRARY_SUBDIR)_$(LIBRARY).response
62 library_CLEAN_FILES += $(response)
63 endif
64
65 ifndef LIBRARY_NAME
66 LIBRARY_NAME = $(LIBRARY)
67 endif
68
69 ifdef LIBRARY_COMPAT
70 lib_dir = compat
71 else
72 lib_dir = lib
73 endif
74
75 ifdef LIBRARY_SUBDIR
76 the_libdir_base = $(topdir)/class/$(lib_dir)/$(PROFILE)/$(LIBRARY_SUBDIR)/
77 else
78 the_libdir_base = $(topdir)/class/$(lib_dir)/$(PROFILE)/
79 endif
80
81 ifdef RESOURCE_STRINGS
82 ifdef BOOTSTRAP_PROFILE
83 MCS_FLAGS_RESOURCE_STRINGS += $(RESOURCE_STRINGS:%=--getresourcestrings:%)
84 endif
85 endif
86
87 #
88 # The bare directory contains the plain versions of System and System.Xml
89 #
90 bare_libdir = $(the_libdir_base)bare
91
92 #
93 # The secxml directory contains the System version that depends on 
94 # System.Xml and Mono.Security
95 #
96 secxml_libdir = $(the_libdir_base)secxml
97
98 the_libdir = $(the_libdir_base)$(intermediate)
99
100 ifdef LIBRARY_USE_INTERMEDIATE_FILE
101 build_libdir = $(the_libdir)tmp/
102 else
103 build_libdir = $(the_libdir)
104 endif
105
106 the_lib   = $(the_libdir)$(LIBRARY_NAME)
107 build_lib = $(build_libdir)$(LIBRARY_NAME)
108 library_CLEAN_FILES += $(the_lib)   $(the_lib).so   $(the_lib).mdb   $(the_lib:.dll=.pdb)
109 library_CLEAN_FILES += $(build_lib) $(build_lib).so $(build_lib).mdb $(build_lib:.dll=.pdb)
110
111 ifdef NO_SIGN_ASSEMBLY
112 SN = :
113 else
114 ifeq ("$(SN)","")
115 sn = $(topdir)/class/lib/$(BUILD_TOOLS_PROFILE)/sn.exe
116 SN = MONO_PATH="$(topdir)/class/lib/$(BUILD_TOOLS_PROFILE)$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" $(RUNTIME) $(RUNTIME_FLAGS) $(sn) -q
117 endif
118 endif
119
120 ifeq ($(PLATFORM), win32)
121 GACDIR = `cygpath -w $(mono_libdir)`
122 GACROOT = `cygpath -w $(DESTDIR)$(mono_libdir)`
123 test_flags += -d:WINDOWS
124 else
125 GACDIR = $(mono_libdir)
126 GACROOT = $(DESTDIR)$(mono_libdir)
127 endif
128
129 ifndef NO_BUILD
130 all-local: $(the_lib) $(extra_targets)
131 endif
132
133 ifeq ($(LIBRARY_COMPILE),$(BOOT_COMPILE))
134 is_boot=true
135 else
136 is_boot=false
137 endif
138
139 csproj-local: csproj-library csproj-test
140
141 intermediate_clean=$(subst /,-,$(intermediate))
142 csproj-library: 
143         config_file=`basename $(LIBRARY) .dll`-$(intermediate_clean)$(PROFILE).input; \
144         [[ $(thisdir) == *"Facades"* ]] && config_file=Facades_$$config_file; \
145         echo $(thisdir):$$config_file >> $(topdir)/../msvc/scripts/order; \
146         (echo $(is_boot); \
147         echo $(USE_MCS_FLAGS) $(LIBRARY_FLAGS) $(LIB_MCS_FLAGS); \
148         echo $(LIBRARY_NAME); \
149         echo $(BUILT_SOURCES_cmdline); \
150         echo $(build_lib); \
151         echo $(FRAMEWORK_VERSION); \
152         echo $(PROFILE); \
153         echo $(response)) > $(topdir)/../msvc/scripts/inputs/$$config_file
154
155 csproj-test:
156
157 install-local: all-local
158 test-local: all-local
159 uninstall-local:
160
161 ifdef NO_INSTALL
162 install-local uninstall-local:
163         @:
164
165 else
166
167 aot_lib = $(the_lib)$(PLATFORM_AOT_SUFFIX)
168 aot_libname = $(LIBRARY_NAME)$(PLATFORM_AOT_SUFFIX)
169
170 ifdef LIBRARY_INSTALL_DIR
171 install-local:
172         $(MKINSTALLDIRS) $(DESTDIR)$(LIBRARY_INSTALL_DIR)
173         $(INSTALL_LIB) $(the_lib) $(DESTDIR)$(LIBRARY_INSTALL_DIR)/$(LIBRARY_NAME)
174         test ! -f $(the_lib).mdb || $(INSTALL_LIB) $(the_lib).mdb $(DESTDIR)$(LIBRARY_INSTALL_DIR)/$(LIBRARY_NAME).mdb
175 ifdef PLATFORM_AOT_SUFFIX
176         test ! -f $(aot_lib) || $(INSTALL_LIB) $(aot_lib) $(DESTDIR)$(LIBRARY_INSTALL_DIR)
177 endif
178
179 uninstall-local:
180         -rm -f $(DESTDIR)$(LIBRARY_INSTALL_DIR)/$(LIBRARY_NAME) $(DESTDIR)$(LIBRARY_INSTALL_DIR)/$(LIBRARY_NAME).mdb
181
182 else
183
184 # If RUNTIME_HAS_CONSISTENT_GACDIR is set, it implies that the internal GACDIR
185 # of the runtime is the same as the GACDIR we want.  So, we don't need to pass it
186 # to gacutil.  Note that the GACDIR we want may not be the same as the value of
187 # GACDIR set above, since the user could have overridden the value of $(prefix).
188 #
189 # This makes a difference only when we're building from the mono/ tree, since we
190 # have to ensure that the internal GACDIR of the in-tree runtime matches where we
191 # install the DLLs.
192
193 ifndef RUNTIME_HAS_CONSISTENT_GACDIR
194 gacdir_flag = /gacdir $(GACDIR)
195 endif
196
197 ifndef LIBRARY_PACKAGE
198 ifdef LIBRARY_COMPAT
199 LIBRARY_PACKAGE = compat-$(FRAMEWORK_VERSION)
200 else
201 LIBRARY_PACKAGE = $(FRAMEWORK_VERSION)
202 endif
203 endif
204
205 ifneq (none, $(LIBRARY_PACKAGE))
206 package_flag = /package $(LIBRARY_PACKAGE)
207 endif
208
209 install-local: $(gacutil)
210         $(GACUTIL) /i $(the_lib) /f $(gacdir_flag) /root $(GACROOT) $(package_flag)
211
212 uninstall-local: $(gacutil)
213         -$(GACUTIL) /u $(LIBRARY_NAME:.dll=) $(gacdir_flag) /root $(GACROOT) $(package_flag)
214
215 endif # LIBRARY_INSTALL_DIR
216 endif # NO_INSTALL
217
218 clean-local:
219         -rm -f $(tests_CLEAN_FILES) $(library_CLEAN_FILES) $(CLEAN_FILES)
220
221 test-local run-test-local run-test-ondotnet-local:
222         @:
223
224 DISTFILES = $(wildcard *$(LIBRARY)*.sources) $(EXTRA_DISTFILES)
225
226 ASSEMBLY      = $(LIBRARY)
227 ASSEMBLY_EXT  = .dll
228 the_assembly  = $(the_lib)
229 include $(topdir)/build/tests.make
230
231 ifdef HAVE_CS_TESTS
232 DISTFILES += $(test_sourcefile)
233
234 csproj-test:
235         config_file=`basename $(LIBRARY) .dll`-tests-$(PROFILE).input; \
236         echo $(thisdir):$$config_file >> $(topdir)/../msvc/scripts/order; \
237         (echo false; \
238         echo $(USE_MCS_FLAGS) -r:$(the_assembly) $(TEST_MCS_FLAGS); \
239         echo $(test_lib); \
240         echo $(BUILT_SOURCES_cmdline); \
241         echo $(test_lib); \
242         echo $(FRAMEWORK_VERSION); \
243         echo $(PROFILE); \
244         echo $(test_response)) > $(topdir)/../msvc/scripts/inputs/$$config_file
245
246 endif
247
248 # make dist will collect files in .sources files from all profiles
249 dist-local: dist-default
250         subs=' ' ; \
251         for f in `$(topdir)/tools/removecomments.sh $(wildcard *$(LIBRARY).sources)` $(TEST_FILES) ; do \
252           case $$f in \
253           ../*) : ;; \
254           *) dest=`dirname "$$f"` ; \
255              case $$subs in *" $$dest "*) : ;; *) subs=" $$dest$$subs" ; $(MKINSTALLDIRS) $(distdir)/$$dest ;; esac ; \
256              cp -p "$$f" $(distdir)/$$dest || exit 1 ;; \
257           esac ; done ; \
258         for d in . $$subs ; do \
259           case $$d in .) : ;; *) test ! -f $$d/ChangeLog || cp -p $$d/ChangeLog $(distdir)/$$d ;; esac ; done
260
261 ifndef LIBRARY_COMPILE
262 LIBRARY_COMPILE = $(CSCOMPILE)
263 endif
264
265 ifndef LIBRARY_SNK
266 LIBRARY_SNK = $(topdir)/class/mono.snk
267 endif
268
269 ifdef BUILT_SOURCES
270 library_CLEAN_FILES += $(BUILT_SOURCES)
271 ifeq (cat, $(PLATFORM_CHANGE_SEPARATOR_CMD))
272 BUILT_SOURCES_cmdline = $(BUILT_SOURCES)
273 else
274 BUILT_SOURCES_cmdline = `echo $(BUILT_SOURCES) | $(PLATFORM_CHANGE_SEPARATOR_CMD)`
275 endif
276 endif
277
278 # The library
279
280 $(the_lib): $(the_libdir)/.stamp
281
282 $(build_lib): $(response) $(sn) $(BUILT_SOURCES) $(build_libdir:=/.stamp)
283         $(LIBRARY_COMPILE) $(LIBRARY_FLAGS) $(LIB_MCS_FLAGS) $(MCS_FLAGS_RESOURCE_STRINGS) -target:library -out:$@ $(BUILT_SOURCES_cmdline) @$(response)
284         $(Q) $(SN) -R $@ $(LIBRARY_SNK)
285
286 ifdef LIBRARY_USE_INTERMEDIATE_FILE
287 $(the_lib): $(build_lib)
288         $(Q) cp $(build_lib) $@
289         $(Q) $(SN) -v $@
290         $(Q) test ! -f $(build_lib).mdb || mv $(build_lib).mdb $@.mdb
291         $(Q) test ! -f $(build_lib:.dll=.pdb) || mv $(build_lib:.dll=.pdb) $(the_lib:.dll=.pdb)
292 endif
293
294 library_CLEAN_FILES += $(PROFILE)_aot.log
295
296 ifdef PLATFORM_AOT_SUFFIX
297 Q_AOT=$(if $(V),,@echo "AOT     [$(PROFILE)] $(notdir $(@))";)
298
299 $(the_lib)$(PLATFORM_AOT_SUFFIX): $(the_lib)
300         $(Q_AOT) MONO_PATH='$(the_libdir_base)' > $(PROFILE)_$(LIBRARY_NAME)_aot.log 2>&1 $(RUNTIME) $(AOT_BUILD_FLAGS) --debug $(the_lib)
301
302 all-local-aot: $(the_lib)$(PLATFORM_AOT_SUFFIX)
303 endif
304
305
306 makefrag = $(depsdir)/$(PROFILE)_$(LIBRARY_SUBDIR)_$(LIBRARY).makefrag
307 library_CLEAN_FILES += $(makefrag)
308 $(makefrag): $(sourcefile)
309 #       @echo Creating $@ ...
310         @sed 's,^,$(build_lib): ,' $< >$@
311         @if test ! -f $(sourcefile).makefrag; then :; else \
312            cat $(sourcefile).makefrag >> $@ ; \
313            echo '$@: $(sourcefile).makefrag' >> $@; \
314            echo '$(sourcefile).makefrag:' >> $@; fi
315
316 ifneq ($(response),$(sourcefile))
317
318 ifdef PLATFORM_excludes
319 $(response): $(sourcefile) $(PLATFORM_excludes)
320         @echo Filtering $(sourcefile) to $@ ...
321         @sort $(sourcefile) $(PLATFORM_excludes) | uniq -u | $(PLATFORM_CHANGE_SEPARATOR_CMD) >$@
322 else
323 $(response): $(sourcefile)
324         @echo Converting $(sourcefile) to $@ ...
325         @cat $(sourcefile) | $(PLATFORM_CHANGE_SEPARATOR_CMD) >$@
326 endif
327
328 endif
329
330 -include $(makefrag)
331
332 # for now, don't give any /lib flags or set MONO_PATH, since we
333 # give a full path to the assembly.
334
335 ## Include corcompare stuff
336 include $(topdir)/build/corcompare.make
337
338 all-local: $(makefrag) $(test_makefrag) $(btest_makefrag)
339 ifneq ($(response),$(sourcefile))
340 $(response): $(topdir)/build/library.make $(depsdir)/.stamp
341 endif
342 $(makefrag) $(test_response) $(test_makefrag) $(btest_response) $(btest_makefrag): $(topdir)/build/library.make $(depsdir)/.stamp
343
344 ## Documentation stuff
345
346 Q_MDOC_UP=$(if $(V),,@echo "MDOC-UP [$(PROFILE)] $(notdir $(@))";)
347 MDOC_UP  =$(Q_MDOC_UP) \
348                 MONO_PATH="$(topdir)/class/lib/$(DEFAULT_PROFILE)$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" $(RUNTIME) $(topdir)/class/lib/$(DEFAULT_PROFILE)/mdoc.exe \
349                 update --delete -o Documentation/en $(the_lib)
350
351 doc-update-local: $(the_libdir)/.doc-stamp
352
353 $(the_libdir)/.doc-stamp: $(the_lib)
354         $(MDOC_UP)
355         @echo "doc-stamp" > $@
356
357 # Need to be here so it comes after the definition of DEP_DIRS/DEP_LIBS
358 gen-deps:
359         @echo "$(DEPS_TARGET_DIR): $(DEP_DIRS) $(DEP_LIBS)" >> $(DEPS_FILE)