Minor changes to some API signatures.
[reactos.git] / reactos / Makefile
1 # Well-known targets:
2 #
3 # all (default target)
4 # This target builds all of ReactOS.
5 #
6 # module
7 # These targets builds a single module. Replace module with the name of
8 # the module you want to build.
9 #
10 # bootcd
11 # This target builds an ISO (ReactOS.iso) from which ReactOS can be booted
12 # and installed.
13 #
14 # livecd
15 # This target builds an ISO (ReactOS-Live.iso) from which ReactOS can be
16 # booted, but not installed.
17 #
18 # install
19 # This target installs all of ReactOS to a location specified by the
20 # ROS_INSTALL environment variable.
21 #
22 # module_install
23 # These targets installs a single module to a location specified by the
24 # ROS_INSTALL environment variable. Replace module with the name of the
25 # module you want to install.
26 #
27 # clean
28 # This target cleans (deletes) all files that are generated when building
29 # ReactOS.
30 #
31 # module_clean
32 # These targets cleans (deletes) files that are generated when building a
33 # single module. Replace module with the name of the module you want to
34 # clean.
35 #
36 # depends
37 # This target does a complete dependency check of the ReactOS codebase.
38 # This can require several minutes to complete. If you only need to check
39 # dependencies for a single or few modules then you can use the
40 # module_depends targets instead. This target can also repair a damaged or
41 # missing makefile.auto if needed.
42 #
43 # module_depends
44 # These targets do a dependency check of individual modules. Replace module
45 # with the name of the module for which you want to check dependencies.
46 # This is faster than the depends target which does a complete dependency
47 # check of the ReactOS codebase.
48 #
49 #
50 # Accepted environment variables:
51 #
52 # ROS_PREFIX
53 # This variable specifies the prefix of the MinGW installation. On Windows
54 # a prefix is usually not needed, but on linux it is usually "mingw32". If
55 # not present and no executable named "gcc" can be found, then the prefix is
56 # assumed to be "mingw32". If your gcc is named i386-mingw32-gcc then set
57 # ROS_PREFIX to i386-mingw32. Don't include the dash (-) before gcc.
58 #
59 # ROS_INTERMEDIATE
60 # This variable controls where to put intermediate files. Intermediate
61 # files are generated files that are needed to generate the final
62 # output files. Examples of intermediate files include *.o, *.a, and
63 # *.coff. N.B. Don't put a path separator at the end. The variable
64 # defaults to .\obj-i386.
65 #
66 # ROS_OUTPUT
67 # This variable controls where to put output files. Output files are
68 # generated files that makes up the result of the build process.
69 # Examples of output files include *.exe, *.dll, and *.sys. N.B. Don't
70 # put a path separator at the end. The variable defaults to .\output-i386.
71 #
72 # ROS_TEMPORARY
73 # This variable controls where to put temporary files. Temporary files
74 # are (usually small) generated files that are needed to generate the
75 # intermediate or final output files. Examples of temporary files include
76 # *.rci (preprocessed .rc files for wrc), *.tmp, and *.exp. N.B. Don't put
77 # a path separator at the end. The variable defaults to the current
78 # directory.
79 #
80 # ROS_INSTALL
81 # This variable controls where to install output files to when using
82 # 'make install'. N.B. Don't put a path separator at the end. The variable
83 # defaults to .\reactos.
84 #
85 # ROS_BUILDMAP
86 # This variable controls if map files are to be generated for executable
87 # output files. Map files have the extension .map. The value can be either
88 # full (to build map files with assembly code), yes (to build map files
89 # without source code) or no (to not build any map files). The variable
90 # defaults to no.
91 #
92 # ROS_BUILDNOSTRIP
93 # This variable controls if non-symbol-stripped versions are to be built
94 # of executable output files. Non-symbol-stripped executable output files
95 # have .nostrip added to the filename just before the extension. The value
96 # can be either yes (to build non-symbol-stripped versions of executable
97 # output files) or no (to not build non-symbol-stripped versions of
98 # executable output files). The variable defaults to no.
99 #
100 # ROS_RBUILDFLAGS
101 # Pass parameters to rbuild.
102 # -v Be verbose.
103 # -c Clean as you go. Delete generated files as soon as they are not needed anymore.
104 # -dd Disable automatic dependencies.
105 # -dm{module} Check only automatic dependencies for this module.
106 # -mi Let make handle creation of install directories. Rbuild will not generate the directories.
107 # -ps Generate proxy makefiles in source tree instead of the output tree.
108
109 .PHONY: all
110 .PHONY: clean
111 all: makefile.auto
112
113
114 .SUFFIXES:
115
116 ifeq ($(HOST),)
117 ifeq ($(word 1,$(shell gcc -dumpmachine)),mingw32)
118 HOST=mingw32-windows
119 else
120 HOST=mingw32-linux
121 endif
122 endif
123
124 # Default to half-verbose mode
125 ifeq ($(VERBOSE),no)
126 Q = @
127 HALFVERBOSEECHO = no
128 BUILDNO_QUIET = -q
129 else
130 ifeq ($(VERBOSE),full)
131 Q =
132 HALFVERBOSEECHO = no
133 BUILDNO_QUIET =
134 else
135 Q = @
136 HALFVERBOSEECHO = yes
137 BUILDNO_QUIET = -q
138 endif
139 endif
140 ifeq ($(HOST),mingw32-linux)
141 QUOTE = "
142 else
143 QUOTE =
144 endif
145 ifeq ($(HALFVERBOSEECHO),yes)
146 ECHO_CP =@echo $(QUOTE)[COPY] $@$(QUOTE)
147 ECHO_MKDIR =@echo $(QUOTE)[MKDIR] $@$(QUOTE)
148 ECHO_BUILDNO =@echo $(QUOTE)[BUILDNO] $@$(QUOTE)
149 ECHO_INVOKE =@echo $(QUOTE)[INVOKE] $<$(QUOTE)
150 ECHO_PCH =@echo $(QUOTE)[PCH] $@$(QUOTE)
151 ECHO_CC =@echo $(QUOTE)[CC] $<$(QUOTE)
152 ECHO_GAS =@echo $(QUOTE)[GAS] $<$(QUOTE)
153 ECHO_NASM =@echo $(QUOTE)[NASM] $<$(QUOTE)
154 ECHO_AR =@echo $(QUOTE)[AR] $@$(QUOTE)
155 ECHO_WINEBLD =@echo $(QUOTE)[WINEBLD] $@$(QUOTE)
156 ECHO_WRC =@echo $(QUOTE)[WRC] $@$(QUOTE)
157 ECHO_WIDL =@echo $(QUOTE)[WIDL] $@$(QUOTE)
158 ECHO_BIN2RES =@echo $(QUOTE)[BIN2RES] $<$(QUOTE)
159 ECHO_DLLTOOL =@echo $(QUOTE)[DLLTOOL] $@$(QUOTE)
160 ECHO_LD =@echo $(QUOTE)[LD] $@$(QUOTE)
161 ECHO_NM =@echo $(QUOTE)[NM] $@$(QUOTE)
162 ECHO_OBJDUMP =@echo $(QUOTE)[OBJDUMP] $@$(QUOTE)
163 ECHO_RBUILD =@echo $(QUOTE)[RBUILD] $@$(QUOTE)
164 ECHO_RSYM =@echo $(QUOTE)[RSYM] $@$(QUOTE)
165 ECHO_WMC =@echo $(QUOTE)[WMC] $@$(QUOTE)
166 ECHO_NCI =@echo $(QUOTE)[NCI] $@$(QUOTE)
167 ECHO_CABMAN =@echo $(QUOTE)[CABMAN] $<$(QUOTE)
168 ECHO_CDMAKE =@echo $(QUOTE)[CDMAKE] $@$(QUOTE)
169 ECHO_MKHIVE =@echo $(QUOTE)[MKHIVE] $@$(QUOTE)
170 ECHO_REGTESTS=@echo $(QUOTE)[REGTESTS] $@$(QUOTE)
171 ECHO_TEST =@echo $(QUOTE)[TEST] $@$(QUOTE)
172 ECHO_GENDIB =@echo $(QUOTE)[GENDIB] $@$(QUOTE)
173 else
174 ECHO_CP =
175 ECHO_MKDIR =
176 ECHO_BUILDNO =
177 ECHO_INVOKE =
178 ECHO_PCH =
179 ECHO_CC =
180 ECHO_GAS =
181 ECHO_NASM =
182 ECHO_AR =
183 ECHO_WINEBLD =
184 ECHO_WRC =
185 ECHO_WIDL =
186 ECHO_BIN2RES =
187 ECHO_DLLTOOL =
188 ECHO_LD =
189 ECHO_NM =
190 ECHO_OBJDUMP =
191 ECHO_RBUILD =
192 ECHO_RSYM =
193 ECHO_WMC =
194 ECHO_NCI =
195 ECHO_CABMAN =
196 ECHO_CDMAKE =
197 ECHO_MKHIVE =
198 ECHO_REGTESTS=
199 ECHO_TEST =
200 ECHO_GENDIB =
201 endif
202
203
204 host_gcc = $(Q)gcc
205 host_gpp = $(Q)g++
206 host_ld = $(Q)ld
207 host_ar = $(Q)ar
208 host_objcopy = $(Q)objcopy
209 ifeq ($(HOST),mingw32-linux)
210 EXEPREFIX = ./
211 EXEPOSTFIX =
212 SEP = /
213 mkdir = -$(Q)mkdir -p
214 gcc = $(Q)$(PREFIX)-gcc
215 gpp = $(Q)$(PREFIX)-g++
216 ld = $(Q)$(PREFIX)-ld
217 nm = $(Q)$(PREFIX)-nm
218 objdump = $(Q)$(PREFIX)-objdump
219 ar = $(Q)$(PREFIX)-ar
220 objcopy = $(Q)$(PREFIX)-objcopy
221 dlltool = $(Q)$(PREFIX)-dlltool
222 windres = $(Q)$(PREFIX)-windres
223 rm = $(Q)rm -f
224 cp = $(Q)cp
225 NUL = /dev/null
226 else # mingw32-windows
227 EXEPREFIX =
228 EXEPOSTFIX = .exe
229 ROS_EMPTY =
230 SEP = \$(ROS_EMPTY)
231 mkdir = -$(Q)mkdir
232 gcc = $(Q)gcc
233 gpp = $(Q)g++
234 ld = $(Q)ld
235 nm = $(Q)nm
236 objdump = $(Q)objdump
237 ar = $(Q)ar
238 objcopy = $(Q)objcopy
239 dlltool = $(Q)dlltool
240 windres = $(Q)windres
241 rm = $(Q)del /f /q
242 cp = $(Q)copy /y
243 NUL = NUL
244 endif
245
246 ifneq ($(ROS_INTERMEDIATE),)
247 INTERMEDIATE := $(ROS_INTERMEDIATE)
248 else
249 INTERMEDIATE := obj-i386
250 endif
251 INTERMEDIATE_ := $(INTERMEDIATE)$(SEP)
252
253 ifneq ($(ROS_OUTPUT),)
254 OUTPUT := $(ROS_OUTPUT)
255 else
256 OUTPUT := output-i386
257 endif
258 OUTPUT_ := $(OUTPUT)$(SEP)
259
260 ifneq ($(ROS_TEMPORARY),)
261 TEMPORARY := $(ROS_TEMPORARY)
262 else
263 TEMPORARY :=
264 endif
265 TEMPORARY_ := $(TEMPORARY)$(SEP)
266
267 ifneq ($(ROS_INSTALL),)
268 INSTALL := $(ROS_INSTALL)
269 else
270 INSTALL := reactos
271 endif
272 INSTALL_ := $(INSTALL)$(SEP)
273
274 $(INTERMEDIATE):
275 ${mkdir} $@
276
277 ifneq ($(INTERMEDIATE),$(OUTPUT))
278 $(OUTPUT):
279 ${mkdir} $@
280 endif
281
282
283 NTOSKRNL_MC = ntoskrnl$(SEP)ntoskrnl.mc
284 KERNEL32_MC = lib$(SEP)kernel32$(SEP)kernel32.mc
285 BUILDNO_H = include$(SEP)reactos$(SEP)buildno.h
286 BUGCODES_H = include$(SEP)reactos$(SEP)bugcodes.h
287 BUGCODES_RC = ntoskrnl$(SEP)bugcodes.rc
288 ERRCODES_H = include$(SEP)reactos$(SEP)errcodes.h
289 ERRCODES_RC = lib$(SEP)kernel32$(SEP)errcodes.rc
290
291 include lib/lib.mak
292 include tools/tools.mak
293 include boot/freeldr/bootsect/bootsect.mak
294 -include makefile.auto
295
296 PREAUTO := \
297 $(BIN2C_TARGET) \
298 $(BIN2RES_TARGET) \
299 $(BUILDNO_H) \
300 $(BUGCODES_H) \
301 $(BUGCODES_RC) \
302 $(ERRCODES_H) \
303 $(ERRCODES_RC) \
304 $(NCI_SERVICE_FILES) \
305 $(GENDIB_DIB_FILES)
306
307 makefile.auto: $(RBUILD_TARGET) $(PREAUTO) $(XMLBUILDFILES)
308 $(ECHO_RBUILD)
309 $(Q)$(RBUILD_TARGET) $(ROS_RBUILDFLAGS) mingw
310
311
312 $(BUGCODES_H) $(BUGCODES_RC): $(WMC_TARGET) $(NTOSKRNL_MC)
313 $(ECHO_WMC)
314 $(Q)$(WMC_TARGET) -i -H $(BUGCODES_H) -o $(BUGCODES_RC) $(NTOSKRNL_MC)
315
316 $(ERRCODES_H) $(ERRCODES_RC): $(WMC_TARGET) $(KERNEL32_MC)
317 $(ECHO_WMC)
318 $(Q)$(WMC_TARGET) -i -H $(ERRCODES_H) -o $(ERRCODES_RC) $(KERNEL32_MC)
319
320 .PHONY: makefile_auto_clean
321 makefile_auto_clean:
322 -@$(rm) makefile.auto $(PREAUTO) 2>$(NUL)
323
324 .PHONY: clean
325 clean: makefile_auto_clean
326
327 .PHONY: depends
328 depends:
329 @-$(rm) makefile.auto
330 @$(MAKE) $(filter-out depends, $(MAKECMDGOALS))