Ви не можете вибрати більше 25 тем Теми мають розпочинатися з літери або цифри, можуть містити дефіси (-) і не повинні перевищувати 35 символів.

Makefile.housekeeping 28KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001
  1. # -*- makefile -*- : Force emacs to use Makefile mode
  2. #
  3. # This file contains various boring housekeeping functions that would
  4. # otherwise seriously clutter up the main Makefile.
  5. ###############################################################################
  6. #
  7. # Find a usable "echo -e" substitute.
  8. #
  9. TAB := $(shell $(PRINTF) '\t')
  10. ECHO_E_ECHO := $(ECHO)
  11. ECHO_E_ECHO_E := $(ECHO) -e
  12. ECHO_E_BIN_ECHO := /bin/echo
  13. ECHO_E_BIN_ECHO_E := /bin/echo -e
  14. ECHO_E_ECHO_TAB := $(shell $(ECHO_E_ECHO) '\t' | cat)
  15. ECHO_E_ECHO_E_TAB := $(shell $(ECHO_E_ECHO_E) '\t' | cat)
  16. ECHO_E_BIN_ECHO_TAB := $(shell $(ECHO_E_BIN_ECHO) '\t')
  17. ECHO_E_BIN_ECHO_E_TAB := $(shell $(ECHO_E_BIN_ECHO_E) '\t')
  18. ifeq ($(ECHO_E_ECHO_TAB),$(TAB))
  19. ECHO_E := $(ECHO_E_ECHO)
  20. endif
  21. ifeq ($(ECHO_E_ECHO_E_TAB),$(TAB))
  22. ECHO_E := $(ECHO_E_ECHO_E)
  23. endif
  24. ifeq ($(ECHO_E_BIN_ECHO_TAB),$(TAB))
  25. ECHO_E := $(ECHO_E_BIN_ECHO)
  26. endif
  27. ifeq ($(ECHO_E_BIN_ECHO_E_TAB),$(TAB))
  28. ECHO_E := $(ECHO_E_BIN_ECHO_E)
  29. endif
  30. .echocheck :
  31. ifdef ECHO_E
  32. @$(TOUCH) $@
  33. else
  34. @$(PRINTF) '%24s : x%sx\n' 'tab' '$(TAB)'
  35. @$(PRINTF) '%24s : x%sx\n' '"$(ECHO_E_ECHO) \t"' \
  36. '$(ECHO_E_ECHO_TAB)'
  37. @$(PRINTF) '%24s : x%sx\n' '"$(ECHO_E_ECHO_E) \t"' \
  38. '$(ECHO_E_ECHO_E_TAB)'
  39. @$(PRINTF) '%24s : x%sx\n' '"$(ECHO_E_BIN_ECHO) \t"' \
  40. '$(ECHO_E_BIN_ECHO_TAB)'
  41. @$(PRINTF) '%24s : x%sx\n' '"$(ECHO_E_BIN_ECHO_E) \t"' \
  42. '$(ECHO_E_BIN_ECHO_E_TAB)'
  43. @$(ECHO) "No usable \"echo -e\" substitute found"
  44. @exit 1
  45. endif
  46. MAKEDEPS += .echocheck
  47. VERYCLEANUP += .echocheck
  48. echo :
  49. @$(ECHO) "Using \"$(ECHO_E)\" for \"echo -e\""
  50. ###############################################################################
  51. #
  52. # Generate a usable "seq" substitute
  53. #
  54. define seq
  55. $(shell awk 'BEGIN { for ( i = $(1) ; i <= $(2) ; i++ ) print i }')
  56. endef
  57. ###############################################################################
  58. #
  59. # Determine host OS
  60. #
  61. HOST_OS := $(shell uname -s)
  62. hostos :
  63. @$(ECHO) $(HOST_OS)
  64. ###############################################################################
  65. #
  66. # Determine compiler
  67. CCDEFS := $(shell $(CC) -E -x c -c /dev/null -dM | cut -d" " -f2)
  68. ccdefs:
  69. @$(ECHO) $(CCDEFS)
  70. ifeq ($(filter __ICC,$(CCDEFS)),__ICC)
  71. CCTYPE := icc
  72. else
  73. CCTYPE := gcc
  74. endif
  75. cctype:
  76. @$(ECHO) $(CCTYPE)
  77. ###############################################################################
  78. #
  79. # Check for tools that can cause failed builds
  80. #
  81. .toolcheck :
  82. @if $(CC) -v 2>&1 | grep -is 'gcc version 2\.96' > /dev/null; then \
  83. $(ECHO) 'gcc 2.96 is unsuitable for compiling Etherboot'; \
  84. $(ECHO) 'Use gcc 2.95 or gcc 3.x instead'; \
  85. exit 1; \
  86. fi
  87. @if [ `perl -e 'use bytes; print chr(255)' | wc -c` = 2 ]; then \
  88. $(ECHO) 'Your Perl version has a Unicode handling bug'; \
  89. $(ECHO) 'Execute this command before compiling Etherboot:'; \
  90. $(ECHO) 'export LANG=$${LANG%.UTF-8}'; \
  91. exit 1; \
  92. fi
  93. @$(TOUCH) $@
  94. MAKEDEPS += .toolcheck
  95. VERYCLEANUP += .toolcheck
  96. ###############################################################################
  97. #
  98. # Check for various tool workarounds
  99. #
  100. # Make syntax does not allow use of comma or space in certain places.
  101. # This ugly workaround is suggested in the manual.
  102. #
  103. COMMA := ,
  104. EMPTY :=
  105. SPACE := $(EMPTY) $(EMPTY)
  106. # Check for an old version of gas (binutils 2.9.1)
  107. #
  108. OLDGAS := $(shell $(AS) --version | grep -q '2\.9\.1' && $(ECHO) -DGAS291)
  109. CFLAGS += $(OLDGAS)
  110. oldgas :
  111. @$(ECHO) $(oldgas)
  112. # Some widespread patched versions of gcc include -fstack-protector by
  113. # default, even when -ffreestanding is specified. We therefore need
  114. # to disable -fstack-protector if the compiler supports it.
  115. #
  116. ifeq ($(CCTYPE),gcc)
  117. SP_TEST = $(CC) -fno-stack-protector -x c -c /dev/null \
  118. -o /dev/null >/dev/null 2>&1
  119. SP_FLAGS := $(shell $(SP_TEST) && $(ECHO) '-fno-stack-protector')
  120. CFLAGS += $(SP_FLAGS)
  121. endif
  122. # gcc 4.4 generates .eh_frame sections by default, which distort the
  123. # output of "size". Inhibit this.
  124. #
  125. ifeq ($(CCTYPE),gcc)
  126. CFI_TEST = $(CC) -fno-dwarf2-cfi-asm -x c -c /dev/null \
  127. -o /dev/null >/dev/null 2>&1
  128. CFI_FLAGS := $(shell $(CFI_TEST) && $(ECHO) '-fno-dwarf2-cfi-asm')
  129. CFLAGS += $(CFI_FLAGS)
  130. endif
  131. # Some versions of gas choke on division operators, treating them as
  132. # comment markers. Specifying --divide will work around this problem,
  133. # but isn't available on older gas versions.
  134. #
  135. DIVIDE_TEST = $(AS) --divide /dev/null -o /dev/null 2>/dev/null
  136. DIVIDE_FLAGS := $(shell $(DIVIDE_TEST) && $(ECHO) '--divide')
  137. ASFLAGS += $(DIVIDE_FLAGS)
  138. ###############################################################################
  139. #
  140. # Build verbosity
  141. #
  142. ifeq ($(V),1)
  143. Q :=
  144. QM := @\#
  145. else
  146. Q := @
  147. QM := @
  148. endif
  149. ###############################################################################
  150. #
  151. # Set BIN according to whatever was specified on the command line as
  152. # the build target.
  153. #
  154. # Determine how many different BIN directories are mentioned in the
  155. # make goals.
  156. #
  157. BIN_GOALS := $(filter bin/% bin-%,$(MAKECMDGOALS))
  158. BIN_GOAL_BINS := $(foreach BG,$(BIN_GOALS),$(firstword $(subst /, ,$(BG))))
  159. NUM_BINS := $(words $(sort $(BIN_GOAL_BINS)))
  160. ifeq ($(NUM_BINS),0)
  161. # No BIN directory was specified. Set BIN to "bin" as a sensible
  162. # default.
  163. BIN := bin
  164. else # NUM_BINS == 0
  165. ifeq ($(NUM_BINS),1)
  166. # If exactly one BIN directory was specified, set BIN to match this
  167. # directory.
  168. #
  169. BIN := $(firstword $(BIN_GOAL_BINS))
  170. else # NUM_BINS == 1
  171. # More than one BIN directory was specified. We cannot handle the
  172. # latter case within a single make invocation, so set up recursive
  173. # targets for each BIN directory.
  174. #
  175. # Leave $(BIN) undefined. This has implications for any target that
  176. # depends on $(BIN); such targets should be made conditional upon the
  177. # existence of $(BIN).
  178. #
  179. $(BIN_GOALS) : % : BIN_RECURSE
  180. $(Q)$(MAKE) --no-print-directory BIN=$(firstword $(subst /, ,$@)) $@
  181. .PHONY : BIN_RECURSE
  182. endif # NUM_BINS == 1
  183. endif # NUM_BINS == 0
  184. ifdef BIN
  185. # Create $(BIN) directory if it doesn't exist yet
  186. #
  187. ifeq ($(wildcard $(BIN)),)
  188. $(shell $(MKDIR) -p $(BIN))
  189. endif
  190. # Target to allow e.g. "make bin-efi arch"
  191. #
  192. $(BIN) :
  193. @# Do nothing, silently
  194. .PHONY : $(BIN)
  195. # Remove everything in $(BIN) for a "make clean"
  196. #
  197. CLEANUP += $(BIN)/*.* # Avoid picking up directories
  198. endif # defined(BIN)
  199. # Determine whether or not we need to include the dependency files
  200. #
  201. NO_DEP_TARGETS := $(BIN) clean veryclean
  202. ifeq ($(MAKECMDGOALS),)
  203. NEED_DEPS := 1
  204. endif
  205. ifneq ($(strip $(filter-out $(NO_DEP_TARGETS),$(MAKECMDGOALS))),)
  206. NEED_DEPS := 1
  207. endif
  208. ###############################################################################
  209. #
  210. # Select build architecture and platform based on $(BIN)
  211. #
  212. # BIN has the form bin[-[arch-]platform]
  213. ARCHS := $(patsubst arch/%,%,$(wildcard arch/*))
  214. PLATFORMS := $(patsubst config/defaults/%.h,%,\
  215. $(wildcard config/defaults/*.h))
  216. archs :
  217. @$(ECHO) $(ARCHS)
  218. platforms :
  219. @$(ECHO) $(PLATFORMS)
  220. ifdef BIN
  221. # Determine architecture portion of $(BIN), if present
  222. BIN_ARCH := $(strip $(foreach A,$(ARCHS),\
  223. $(patsubst bin-$(A)-%,$(A),\
  224. $(filter bin-$(A)-%,$(BIN)))))
  225. # Determine platform portion of $(BIN), if present
  226. ifeq ($(BIN_ARCH),)
  227. BIN_PLATFORM := $(patsubst bin-%,%,$(filter bin-%,$(BIN)))
  228. else
  229. BIN_PLATFORM := $(patsubst bin-$(BIN_ARCH)-%,%,$(BIN))
  230. endif
  231. # Determine build architecture
  232. DEFAULT_ARCH := i386
  233. ARCH := $(firstword $(BIN_ARCH) $(DEFAULT_ARCH))
  234. CFLAGS += -DARCH=$(ARCH)
  235. arch :
  236. @$(ECHO) $(ARCH)
  237. .PHONY : arch
  238. # Determine build platform
  239. DEFAULT_PLATFORM := pcbios
  240. PLATFORM := $(firstword $(BIN_PLATFORM) $(DEFAULT_PLATFORM))
  241. CFLAGS += -DPLATFORM=$(PLATFORM)
  242. platform :
  243. @$(ECHO) $(PLATFORM)
  244. endif # defined(BIN)
  245. # Include architecture-specific Makefile
  246. ifdef ARCH
  247. MAKEDEPS += arch/$(ARCH)/Makefile
  248. include arch/$(ARCH)/Makefile
  249. endif
  250. # Include architecture-specific include path
  251. ifdef ARCH
  252. INCDIRS += arch/$(ARCH)/include
  253. endif
  254. ###############################################################################
  255. #
  256. # Source file handling
  257. # SRCDIRS lists all directories containing source files.
  258. srcdirs :
  259. @$(ECHO) $(SRCDIRS)
  260. # SRCS lists all .c or .S files found in any SRCDIR
  261. #
  262. SRCS += $(wildcard $(patsubst %,%/*.c,$(SRCDIRS)))
  263. SRCS += $(wildcard $(patsubst %,%/*.S,$(SRCDIRS)))
  264. srcs :
  265. @$(ECHO) $(SRCS)
  266. # AUTO_SRCS lists all files in SRCS that are not mentioned in
  267. # NON_AUTO_SRCS. Files should be added to NON_AUTO_SRCS if they
  268. # cannot be built using the standard build template.
  269. #
  270. AUTO_SRCS = $(filter-out $(NON_AUTO_SRCS),$(SRCS))
  271. autosrcs :
  272. @$(ECHO) $(AUTO_SRCS)
  273. # Just about everything else in this section depends upon having
  274. # $(BIN) set
  275. ifdef BIN
  276. # INCDIRS lists the include path
  277. incdirs :
  278. @$(ECHO) $(INCDIRS)
  279. # Common flags
  280. #
  281. CFLAGS += $(foreach INC,$(INCDIRS),-I$(INC))
  282. CFLAGS += -Os
  283. CFLAGS += -g
  284. ifeq ($(CCTYPE),gcc)
  285. CFLAGS += -ffreestanding
  286. CFLAGS += -Wall -W -Wformat-nonliteral
  287. endif
  288. ifeq ($(CCTYPE),icc)
  289. CFLAGS += -fno-builtin
  290. CFLAGS += -no-ip
  291. CFLAGS += -no-gcc
  292. CFLAGS += -diag-disable 111 # Unreachable code
  293. CFLAGS += -diag-disable 128 # Unreachable loop
  294. CFLAGS += -diag-disable 170 # Array boundary checks
  295. CFLAGS += -diag-disable 177 # Unused functions
  296. CFLAGS += -diag-disable 181 # printf() format checks
  297. CFLAGS += -diag-disable 188 # enum strictness
  298. CFLAGS += -diag-disable 193 # Undefined preprocessor identifiers
  299. CFLAGS += -diag-disable 280 # switch ( constant )
  300. CFLAGS += -diag-disable 310 # K&R parameter lists
  301. CFLAGS += -diag-disable 424 # Extra semicolon
  302. CFLAGS += -diag-disable 589 # Declarations mid-code
  303. CFLAGS += -diag-disable 593 # Unused variables
  304. CFLAGS += -diag-disable 810 # Casting ints to smaller ints
  305. CFLAGS += -diag-disable 981 # Sequence point violations
  306. CFLAGS += -diag-disable 1292 # Ignored attributes
  307. CFLAGS += -diag-disable 1338 # void pointer arithmetic
  308. CFLAGS += -diag-disable 1361 # Variable-length arrays
  309. CFLAGS += -diag-disable 1418 # Missing prototypes
  310. CFLAGS += -diag-disable 1419 # Missing prototypes
  311. CFLAGS += -diag-disable 1599 # Hidden variables
  312. CFLAGS += -Wall -Wmissing-declarations
  313. endif
  314. CFLAGS += $(EXTRA_CFLAGS)
  315. ASFLAGS += $(EXTRA_ASFLAGS)
  316. LDFLAGS += $(EXTRA_LDFLAGS)
  317. # Inhibit -Werror if NO_WERROR is specified on make command line
  318. #
  319. ifneq ($(NO_WERROR),1)
  320. CFLAGS += -Werror
  321. ASFLAGS += --fatal-warnings
  322. endif
  323. # compiler.h is needed for our linking and debugging system
  324. #
  325. CFLAGS += -include compiler.h
  326. # CFLAGS for specific object types
  327. #
  328. CFLAGS_c +=
  329. CFLAGS_S += -DASSEMBLY
  330. # Base object name of the current target
  331. #
  332. OBJECT = $(firstword $(subst ., ,$(@F)))
  333. # CFLAGS for specific object files. You can define
  334. # e.g. CFLAGS_rtl8139, and have those flags automatically used when
  335. # compiling bin/rtl8139.o.
  336. #
  337. OBJ_CFLAGS = $(CFLAGS_$(OBJECT)) -DOBJECT=$(subst -,_,$(OBJECT))
  338. $(BIN)/%.flags :
  339. @$(ECHO) $(OBJ_CFLAGS)
  340. # ICC requires postprocessing objects to fix up table alignments
  341. #
  342. ifeq ($(CCTYPE),icc)
  343. POST_O = && $(ICCFIX) $@
  344. POST_O_DEPS := $(ICCFIX)
  345. else
  346. POST_O :=
  347. POST_O_DEPS :=
  348. endif
  349. # Rules for specific object types.
  350. #
  351. COMPILE_c = $(CC) $(CFLAGS) $(CFLAGS_c) $(OBJ_CFLAGS)
  352. RULE_c = $(Q)$(COMPILE_c) -c $< -o $@ $(POST_O)
  353. RULE_c_to_dbg%.o = $(Q)$(COMPILE_c) -Ddebug_$(subst -,_,$(OBJECT))=$* -c $< -o $@ $(POST_O)
  354. RULE_c_to_c = $(Q)$(COMPILE_c) -E -c $< > $@
  355. RULE_c_to_s = $(Q)$(COMPILE_c) -S -g0 -c $< -o $@
  356. PREPROCESS_S = $(CPP) $(CFLAGS) $(CFLAGS_S) $(OBJ_CFLAGS)
  357. ASSEMBLE_S = $(AS) $(ASFLAGS)
  358. RULE_S = $(Q)$(PREPROCESS_S) $< | $(ASSEMBLE_S) -o $@
  359. RULE_S_to_s = $(Q)$(PREPROCESS_S) $< > $@
  360. DEBUG_TARGETS += dbg%.o c s
  361. # We automatically generate rules for any file mentioned in AUTO_SRCS
  362. # using the following set of templates. It would be cleaner to use
  363. # $(eval ...), but this function exists only in GNU make >= 3.80.
  364. # src_template : generate Makefile rules for a given source file
  365. #
  366. # $(1) is the full path to the source file (e.g. "drivers/net/rtl8139.c")
  367. # $(2) is the full path to the .d file (e.g. "bin/deps/drivers/net/rtl8139.d")
  368. # $(3) is the source type (e.g. "c")
  369. # $(4) is the source base name (e.g. "rtl8139")
  370. #
  371. define src_template
  372. @$(ECHO) " [DEPS] $(1)"
  373. @$(MKDIR) -p $(dir $(2))
  374. @$(RM) $(2)
  375. @$(TOUCH) $(2)
  376. @$(CPP) $(CFLAGS) $(CFLAGS_$(3)) $(CFLAGS_$(4)) -DOBJECT=$(4) \
  377. -Wno-error -MM $(1) -MG -MP | \
  378. sed 's/\.o\s*:/_DEPS =/' >> $(2)
  379. @$(ECHO_E) '\n$$(BIN)/$(4).o :' \
  380. '$(1) $$(MAKEDEPS) $$(POST_O_DEPS) $$($(4)_DEPS)' \
  381. '\n\t$$(QM)$(ECHO) " [BUILD] $$@"' \
  382. '\n\t$$(RULE_$(3))\n' \
  383. '\nBOBJS += $$(BIN)/$(4).o\n' \
  384. $(foreach TGT,$(DEBUG_TARGETS), \
  385. $(if $(RULE_$(3)_to_$(TGT)), \
  386. '\n$$(BIN)/$(4).$(TGT) :' \
  387. '$(1) $$(MAKEDEPS) $$(POST_O_DEPS) $$($(4)_DEPS)' \
  388. '\n\t$$(QM)$(ECHO) " [BUILD] $$@"' \
  389. '\n\t$$(RULE_$(3)_to_$(TGT))\n' \
  390. '\n$(TGT)_OBJS += $$(BIN)/$(4).$(TGT)\n' ) ) \
  391. '\n$(2) : $$($(4)_DEPS)\n' \
  392. '\nTAGS : $$($(4)_DEPS)\n' \
  393. >> $(2)
  394. @$(PARSEROM) $(1) >> $(2)
  395. endef
  396. # Rule to generate the Makefile rules files to be included
  397. #
  398. $(BIN)/deps/%.d : % $(MAKEDEPS) $(PARSEROM)
  399. $(if $(filter $(AUTO_SRCS),$<),$(call src_template,$<,$@,$(subst .,,$(suffix $<)),$(basename $(notdir $<))),@$(ECHO) 'ERROR: $< is not an AUTO_SRC' ; exit 1)
  400. # Calculate and include the list of Makefile rules files
  401. #
  402. AUTO_DEPS = $(patsubst %,$(BIN)/deps/%.d,$(AUTO_SRCS))
  403. ifdef NEED_DEPS
  404. ifneq ($(AUTO_DEPS),)
  405. -include $(AUTO_DEPS)
  406. endif
  407. endif
  408. autodeps :
  409. @$(ECHO) $(AUTO_DEPS)
  410. VERYCLEANUP += $(BIN)/deps
  411. # The following variables are created by the Makefile rules files
  412. #
  413. bobjs :
  414. @$(ECHO) $(BOBJS)
  415. drivers :
  416. @$(ECHO) $(DRIVERS)
  417. .PHONY : drivers
  418. roms :
  419. @$(ECHO) $(ROMS)
  420. # List of embedded images included in the last build of embedded.o.
  421. # This is needed in order to correctly rebuild embedded.o whenever the
  422. # list of objects changes.
  423. #
  424. EMBEDDED_LIST := $(BIN)/.embedded.list
  425. ifeq ($(wildcard $(EMBEDDED_LIST)),)
  426. EMBEDDED_LIST_IMAGE := <invalid>
  427. else
  428. EMBEDDED_LIST_IMAGE := $(shell cat $(EMBEDDED_LIST))
  429. endif
  430. ifneq ($(EMBEDDED_LIST_IMAGE),$(EMBEDDED_IMAGE))
  431. $(shell $(ECHO) "$(EMBEDDED_IMAGE)" > $(EMBEDDED_LIST))
  432. endif
  433. $(EMBEDDED_LIST) :
  434. VERYCLEANUP += $(EMBEDDED_LIST)
  435. EMBEDDED_FILES := $(subst $(COMMA), ,$(EMBEDDED_IMAGE))
  436. EMBED_ALL := $(foreach i,$(call seq,1,$(words $(EMBEDDED_FILES))),\
  437. EMBED ( $(i), \"$(word $(i), $(EMBEDDED_FILES))\",\
  438. \"$(notdir $(word $(i),$(EMBEDDED_FILES)))\" ))
  439. $(BIN)/embedded.o : $(EMBEDDED_FILES) $(EMBEDDED_LIST)
  440. CFLAGS_embedded = -DEMBED_ALL="$(EMBED_ALL)"
  441. # Generate the NIC file from the parsed source files. The NIC file is
  442. # only for rom-o-matic.
  443. #
  444. $(BIN)/NIC : $(AUTO_DEPS)
  445. @$(ECHO) '# This is an automatically generated file, do not edit' > $@
  446. @$(ECHO) '# It does not affect anything in the build, ' \
  447. 'it is only for rom-o-matic' >> $@
  448. @$(ECHO) >> $@
  449. @perl -ne 'chomp; print "$$1\n" if /\# NIC\t(.*)$$/' $^ >> $@
  450. CLEANUP += $(BIN)/NIC # Doesn't match the $(BIN)/*.* pattern
  451. # Analyse a target name (e.g. "bin/dfe538--prism2_pci.zrom.tmp") and
  452. # derive the variables:
  453. #
  454. # TGT_ELEMENTS : the elements of the target (e.g. "dfe538 prism2_pci")
  455. # TGT_PREFIX : the prefix type (e.g. "zrom")
  456. # TGT_DRIVERS : the driver for each element (e.g. "rtl8139 prism2_pci")
  457. # TGT_ROM_NAME : the ROM name (e.g. "dfe538")
  458. # TGT_MEDIA : the media type (e.g. "rom")
  459. #
  460. DRIVERS_gpxe = $(DRIVERS)
  461. CARD_DRIVER = $(firstword $(DRIVER_$(1)) $(1))
  462. TGT_ELEMENTS = $(subst --, ,$(firstword $(subst ., ,$(notdir $@))))
  463. TGT_PREFIX = $(word 2,$(subst ., ,$(notdir $@)))
  464. TGT_ROM_NAME = $(firstword $(TGT_ELEMENTS))
  465. TGT_DRIVERS = $(strip $(if $(DRIVERS_$(TGT_ROM_NAME)), \
  466. $(DRIVERS_$(TGT_ROM_NAME)), \
  467. $(foreach TGT_ELEMENT,$(TGT_ELEMENTS), \
  468. $(call CARD_DRIVER,$(TGT_ELEMENT))) ))
  469. TGT_MEDIA = $(subst z,,$(TGT_PREFIX))
  470. # Look up ROM IDs for the current target
  471. # (e.g. "bin/dfe538--prism2_pci.zrom.tmp") and derive the variables:
  472. #
  473. # TGT_PCI_VENDOR : the PCI vendor ID (e.g. "0x1186")
  474. # TGT_PCI_DEVICE : the PCI device ID (e.g. "0x1300")
  475. #
  476. TGT_PCI_VENDOR = $(PCI_VENDOR_$(TGT_ROM_NAME))
  477. TGT_PCI_DEVICE = $(PCI_DEVICE_$(TGT_ROM_NAME))
  478. # Calculate link-time options for the current target
  479. # (e.g. "bin/dfe538--prism2_pci.zrom.tmp") and derive the variables:
  480. #
  481. # TGT_LD_DRIVERS : symbols to require in order to drag in the relevant drivers
  482. # (e.g. "obj_rtl8139 obj_prism2_pci")
  483. # TGT_LD_IDS : symbols to define in order to fill in ID structures in the
  484. # ROM header (e.g."pci_vendor_id=0x1186 pci_device_id=0x1300")
  485. #
  486. TGT_LD_DRIVERS = $(subst -,_,$(patsubst %,obj_%,$(TGT_DRIVERS)))
  487. TGT_LD_PREFIX = obj_$(TGT_PREFIX)prefix
  488. TGT_LD_IDS = pci_vendor_id=$(firstword $(TGT_PCI_VENDOR) 0) \
  489. pci_device_id=$(firstword $(TGT_PCI_DEVICE) 0)
  490. # Calculate linker flags based on link-time options for the current
  491. # target type (e.g. "bin/dfe538--prism2_pci.zrom.tmp") and derive the
  492. # variables:
  493. #
  494. # TGT_LD_FLAGS : target-specific flags to pass to linker (e.g.
  495. # "-u obj_zpciprefix -u obj_rtl8139 -u obj_prism2_pci
  496. # --defsym pci_vendor=0x1186 --defsym pci_device=0x1300")
  497. #
  498. TGT_LD_FLAGS = $(foreach SYM,$(TGT_LD_PREFIX) $(TGT_LD_DRIVERS) obj_config,\
  499. -u $(SYM) --defsym check_$(SYM)=$(SYM) ) \
  500. $(patsubst %,--defsym %,$(TGT_LD_IDS))
  501. # Calculate makerom flags for the specific target
  502. # (e.g. "bin/dfe538--prism2_pci.zrom.tmp") and derive the variables:
  503. #
  504. # TGT_MAKEROM_FLAGS : target-specific flags for makerom (e.g.
  505. # "-p 0x1186,0x1300")
  506. #
  507. TGT_MAKEROM_FLAGS = $(strip $(MAKEROM_FLAGS_$(TGT_ROM_NAME)) \
  508. $(if $(TGT_PCI_VENDOR),$(strip -p $(TGT_PCI_VENDOR),$(TGT_PCI_DEVICE))))
  509. # Calculate list of debugging versions of objects to be included in
  510. # the target.
  511. #
  512. DEBUG_LIST = $(subst $(COMMA), ,$(DEBUG))
  513. DEBUG_OBJ_LEVEL = $(firstword $(word 2,$(subst :, ,$(1))) 1)
  514. DEBUG_OBJ_BASE = $(word 1,$(subst :, ,$(1))).dbg$(call DEBUG_OBJ_LEVEL,$(1))
  515. DEBUG_OBJ = $(BIN)/$(call DEBUG_OBJ_BASE,$(1)).o
  516. DEBUG_ORIG_OBJ = $(BIN)/$(word 1,$(subst :, ,$(1))).o
  517. DEBUG_OBJS = $(foreach D,$(DEBUG_LIST),$(call DEBUG_OBJ,$(D)))
  518. DEBUG_ORIG_OBJS = $(foreach D,$(DEBUG_LIST),$(call DEBUG_ORIG_OBJ,$(D)))
  519. BLIB_OBJS = $(DEBUG_OBJS) $(filter-out $(DEBUG_ORIG_OBJS),$(BOBJS))
  520. # Print out all derived information for a given target.
  521. #
  522. $(BIN)/%.info :
  523. @$(ECHO) 'Elements : $(TGT_ELEMENTS)'
  524. @$(ECHO) 'Prefix : $(TGT_PREFIX)'
  525. @$(ECHO) 'Drivers : $(TGT_DRIVERS)'
  526. @$(ECHO) 'ROM name : $(TGT_ROM_NAME)'
  527. @$(ECHO) 'Media : $(TGT_MEDIA)'
  528. @$(ECHO)
  529. @$(ECHO) 'PCI vendor : $(TGT_PCI_VENDOR)'
  530. @$(ECHO) 'PCI device : $(TGT_PCI_DEVICE)'
  531. @$(ECHO)
  532. @$(ECHO) 'LD driver symbols : $(TGT_LD_DRIVERS)'
  533. @$(ECHO) 'LD prefix symbols : $(TGT_LD_PREFIX)'
  534. @$(ECHO) 'LD ID symbols : $(TGT_LD_IDS)'
  535. @$(ECHO)
  536. @$(ECHO) 'LD target flags : $(TGT_LD_FLAGS)'
  537. @$(ECHO)
  538. @$(ECHO) 'makerom target flags : $(TGT_MAKEROM_FLAGS)'
  539. @$(ECHO)
  540. @$(ECHO) 'Debugging objects : $(DEBUG_OBJS)'
  541. @$(ECHO) 'Replaced objects : $(DEBUG_ORIG_OBJS)'
  542. # List of objects included in the last build of blib. This is needed
  543. # in order to correctly rebuild blib whenever the list of objects
  544. # changes.
  545. #
  546. BLIB_LIST := $(BIN)/.blib.list
  547. ifeq ($(wildcard $(BLIB_LIST)),)
  548. BLIB_LIST_OBJS := <invalid>
  549. else
  550. BLIB_LIST_OBJS := $(shell cat $(BLIB_LIST))
  551. endif
  552. ifneq ($(BLIB_LIST_OBJS),$(BLIB_OBJS))
  553. $(shell $(ECHO) "$(BLIB_OBJS)" > $(BLIB_LIST))
  554. endif
  555. $(BLIB_LIST) :
  556. VERYCLEANUP += $(BLIB_LIST)
  557. # Library of all objects
  558. #
  559. BLIB = $(BIN)/blib.a
  560. $(BLIB) : $(BLIB_OBJS) $(BLIB_LIST) $(MAKEDEPS)
  561. $(Q)$(RM) $(BLIB)
  562. $(QM)$(ECHO) " [AR] $@"
  563. $(Q)$(AR) r $@ $(BLIB_OBJS)
  564. $(Q)$(RANLIB) $@
  565. blib : $(BLIB)
  566. # Build an intermediate object file from the objects required for the
  567. # specified target.
  568. #
  569. $(BIN)/%.tmp : $(BLIB) $(MAKEDEPS) $(LDSCRIPT)
  570. $(QM)$(ECHO) " [LD] $@"
  571. $(Q)$(LD) $(LDFLAGS) -T $(LDSCRIPT) $(TGT_LD_FLAGS) $(BLIB) -o $@ \
  572. -Map $(BIN)/$*.tmp.map
  573. $(Q)$(OBJDUMP) -ht $@ | $(SORTOBJDUMP) >> $(BIN)/$*.tmp.map
  574. # Keep intermediate object file (useful for debugging)
  575. .PRECIOUS : $(BIN)/%.tmp
  576. # Show a linker map for the specified target
  577. #
  578. $(BIN)/%.map : $(BIN)/%.tmp
  579. @less $(BIN)/$*.tmp.map
  580. # Get objects list for the specified target
  581. #
  582. define objs_list
  583. $(sort $(foreach OBJ_SYMBOL,\
  584. $(filter obj_%,$(shell $(NM) $(1) | cut -d" " -f3)),\
  585. $(patsubst obj_%,%,$(OBJ_SYMBOL))))
  586. endef
  587. $(BIN)/%.objs : $(BIN)/%.tmp
  588. $(Q)$(ECHO) $(call objs_list,$<)
  589. $(BIN)/%.sizes : $(BIN)/%.tmp
  590. $(Q)$(SIZE) -t $(foreach OBJ,$(call objs_list,$<),$(BIN)/$(OBJ).o) | \
  591. sort -g
  592. # Get dependency list for the specified target
  593. #
  594. define deps_list
  595. $(sort $(foreach OBJ,$(call objs_list,$(1)),$($(OBJ)_DEPS)))
  596. endef
  597. $(BIN)/%.deps : $(BIN)/%.tmp
  598. $(Q)$(ECHO) $(call deps_list,$<)
  599. # Get unneeded source files for the specified target
  600. #
  601. define nodeps_list
  602. $(sort $(filter-out $(call deps_list,$(1)),\
  603. $(foreach BOBJ,$(BOBJS),\
  604. $($(basename $(notdir $(BOBJ)))_DEPS))))
  605. endef
  606. $(BIN)/%.nodeps : $(BIN)/%.tmp
  607. $(Q)$(ECHO) $(call nodeps_list,$<)
  608. # Get licensing verdict for the specified target
  609. #
  610. define unlicensed_deps_list
  611. $(shell grep -L FILE_LICENCE $(call deps_list,$(1)))
  612. endef
  613. define licence_list
  614. $(patsubst __licence_%,%,\
  615. $(filter __licence_%,$(shell $(NM) $(1) | cut -d" " -f3)))
  616. endef
  617. $(BIN)/%.licence : $(BIN)/%.tmp
  618. $(QM)$(ECHO) " [LICENCE] $@"
  619. $(Q)$(if $(strip $(call unlicensed_deps_list,$<)),\
  620. echo -n "Unable to determine licence because the following " ;\
  621. echo "files are missing a licence declaration:" ;\
  622. echo $(call unlicensed_deps_list,$<);\
  623. exit 1,\
  624. $(LICENCE) $(call licence_list,$<))
  625. # Extract compression information from intermediate object file
  626. #
  627. $(BIN)/%.zinfo : $(BIN)/%.tmp
  628. $(QM)$(ECHO) " [ZINFO] $@"
  629. $(Q)$(OBJCOPY) -O binary -j .zinfo $< $@
  630. # Build raw binary file from intermediate object file
  631. #
  632. $(BIN)/%.bin : $(BIN)/%.tmp
  633. $(QM)$(ECHO) " [BIN] $@"
  634. $(Q)$(OBJCOPY) -O binary -R .zinfo $< $@
  635. # Compress raw binary file
  636. #
  637. $(BIN)/%.zbin : $(BIN)/%.bin $(BIN)/%.zinfo $(ZBIN)
  638. $(QM)$(ECHO) " [ZBIN] $@"
  639. $(Q)$(ZBIN) $(BIN)/$*.bin $(BIN)/$*.zinfo > $@
  640. # Rules for each media format. These are generated and placed in an
  641. # external Makefile fragment. We could do this via $(eval ...), but
  642. # that would require make >= 3.80.
  643. #
  644. # Note that there's an alternative way to generate most .rom images:
  645. # they can be copied from their 'master' ROM image using cp and
  646. # reprocessed with makerom to add the PCI IDs and ident string. The
  647. # relevant rule would look something like:
  648. #
  649. # $(BIN)/dfe538%rom : $(BIN)/rtl8139%rom
  650. # cat $< $@
  651. # $(FINALISE_rom)
  652. #
  653. # You can derive the ROM/driver relationships using the variables
  654. # DRIVER_<rom> and/or ROMS_<driver>.
  655. #
  656. # We don't currently do this, because (a) it would require generating
  657. # yet more Makefile fragments (since you need a rule for each ROM in
  658. # ROMS), and (b) the linker is so fast that it probably wouldn't make
  659. # much difference to the overall build time.
  660. media :
  661. @$(ECHO) $(MEDIA)
  662. AUTO_MEDIA = $(filter-out $(NON_AUTO_MEDIA),$(MEDIA))
  663. automedia :
  664. @$(ECHO) $(AUTO_MEDIA)
  665. # media_template : create Makefile rules for specified media
  666. #
  667. # $(1) is the media name (e.g. "rom")
  668. # $(2) is the full path to the .d file (e.g. "bin/deps/rom.media.d")
  669. #
  670. define media_template
  671. @$(ECHO) " [MEDIADEPS] $(1)"
  672. @$(MKDIR) -p $(dir $(2))
  673. @$(RM) $(2)
  674. @$(TOUCH) $(2)
  675. @$(ECHO_E) '$$(BIN)/%.$(1) : $$(BIN)/%.$(1).zbin' \
  676. '\n\t$$(QM)$(ECHO) " [FINISH] $$@"' \
  677. '\n\t$$(Q)$$(CP) $$< $$@' \
  678. '\n\t$$(Q)$$(PAD_$(1))' \
  679. '\n\t$$(Q)$$(FINALISE_$(1))' \
  680. > $(2)
  681. endef
  682. # Rule to generate the Makefile rules to be included
  683. #
  684. $(BIN)/deps/%.media.d : $(MAKEDEPS)
  685. $(if $(filter $(AUTO_MEDIA),$*), \
  686. $(call media_template,$*,$@), \
  687. @$(ECHO) 'ERROR: $* is not an AUTO_MEDIA' ; exit 1)
  688. # Calculate and include the list of Makefile rules files
  689. #
  690. MEDIA_DEPS = $(patsubst %,$(BIN)/deps/%.media.d,$(AUTO_MEDIA))
  691. mediadeps :
  692. @$(ECHO) $(MEDIA_DEPS)
  693. ifdef NEED_DEPS
  694. ifneq ($(MEDIA_DEPS),)
  695. -include $(MEDIA_DEPS)
  696. endif
  697. endif
  698. # Wrap up binary blobs (for embedded images)
  699. #
  700. $(BIN)/%.o : payload/%.img
  701. $(QM)echo " [WRAP] $@"
  702. $(Q)$(LD) -b binary -r -o $@ $< --undefined obj_payload \
  703. --defsym obj_$*=0
  704. BOBJS += $(patsubst payload/%.img,$(BIN)/%.o,$(wildcard payload/*.img))
  705. # The "allXXXs" targets for each suffix
  706. #
  707. allall: allroms allzroms allpxes allisos alldsks
  708. allroms allzroms : all%s : $(foreach ROM,$(ROMS),$(BIN)/$(ROM).%)
  709. allpxes allisos alldsks : all%s : $(foreach DRIVER,$(DRIVERS),$(BIN)/$(DRIVER).%)
  710. # Alias for gpxe.%
  711. #
  712. $(BIN)/etherboot.% : $(BIN)/gpxe.%
  713. ln -sf $(notdir $<) $@
  714. endif # defined(BIN)
  715. ###############################################################################
  716. #
  717. # Rules for finalising files. TGT_MAKEROM_FLAGS is defined as part of
  718. # the automatic build system and varies by target; it includes the
  719. # "-p 0x1234,0x5678" string to set the PCI IDs.
  720. #
  721. FINALISE_rom = $(MAKEROM) $(MAKEROM_FLAGS) $(TGT_MAKEROM_FLAGS) \
  722. -i$(IDENT) -s 0 $@
  723. # Some ROMs require specific flags to be passed to makerom.pl
  724. #
  725. MAKEROM_FLAGS_3c503 = -3
  726. ###############################################################################
  727. #
  728. # The compression utilities
  729. #
  730. $(NRV2B) : util/nrv2b.c $(MAKEDEPS)
  731. $(QM)$(ECHO) " [HOSTCC] $@"
  732. $(Q)$(HOST_CC) -O2 -DENCODE -DDECODE -DMAIN -DVERBOSE -DNDEBUG \
  733. -DBITSIZE=32 -DENDIAN=0 -o $@ $<
  734. CLEANUP += $(NRV2B)
  735. $(ZBIN) : util/zbin.c util/nrv2b.c $(MAKEDEPS)
  736. $(QM)$(ECHO) " [HOSTCC] $@"
  737. $(Q)$(HOST_CC) -O2 -o $@ $<
  738. CLEANUP += $(ZBIN)
  739. ###############################################################################
  740. #
  741. # The EFI image converter
  742. #
  743. ELF2EFI_CFLAGS := -I$(BINUTILS_DIR)/include -I$(BFD_DIR)/include \
  744. -idirafter include -L$(BINUTILS_DIR)/lib -L$(BFD_DIR)/lib \
  745. -lbfd -liberty -lz
  746. $(ELF2EFI32) : util/elf2efi.c $(MAKEDEPS)
  747. $(QM)$(ECHO) " [HOSTCC] $@"
  748. $(Q)$(HOST_CC) $(ELF2EFI_CFLAGS) -DMDE_CPU_IA32 -O2 -o $@ $<
  749. CLEANUP += $(ELF2EFI32)
  750. $(ELF2EFI64) : util/elf2efi.c $(MAKEDEPS)
  751. $(QM)$(ECHO) " [HOSTCC] $@"
  752. $(Q)$(HOST_CC) $(ELF2EFI_CFLAGS) -DMDE_CPU_X64 -O2 -o $@ $<
  753. CLEANUP += $(ELF2EFI64)
  754. $(EFIROM) : util/efirom.c $(MAKEDEPS)
  755. $(QM)$(ECHO) " [HOSTCC] $@"
  756. $(Q)$(HOST_CC) -idirafter include -O2 -o $@ $<
  757. CLEANUP += $(EFIROM)
  758. ###############################################################################
  759. #
  760. # The ICC fixup utility
  761. #
  762. $(ICCFIX) : util/iccfix.c $(MAKEDEPS)
  763. $(QM)$(ECHO) " [HOSTCC] $@"
  764. $(Q)$(HOST_CC) -idirafter include -O2 -o $@ $<
  765. CLEANUP += $(ICCFIX)
  766. ###############################################################################
  767. #
  768. # Auto-incrementing build serial number. Append "bs" to your list of
  769. # build targets to get a serial number printed at the end of the
  770. # build. Enable -DBUILD_SERIAL in order to see it when the code runs.
  771. #
  772. BUILDSERIAL_H = config/.buildserial.h
  773. BUILDSERIAL_NOW = config/.buildserial.now
  774. BUILDSERIAL_NEXT = config/.buildserial.next
  775. $(BUILDSERIAL_NOW) $(BUILDSERIAL_NEXT) :
  776. $(ECHO) 1 > $@
  777. $(BUILDSERIAL_H) : $(BUILDSERIAL_NOW) $(BUILDSERIAL_NEXT)
  778. $(ECHO) '#define BUILD_SERIAL_NUM $(shell cat $<)' > $@
  779. ifeq ($(filter bs,$(MAKECMDGOALS)),bs)
  780. $(shell diff -q $(BUILDSERIAL_NOW) $(BUILDSERIAL_NEXT) > /dev/null || \
  781. cp -f $(BUILDSERIAL_NEXT) $(BUILDSERIAL_NOW))
  782. endif
  783. bs : $(BUILDSERIAL_NOW)
  784. @$(ECHO) $$(( $(shell cat $<) + 1 )) > $(BUILDSERIAL_NEXT)
  785. @$(ECHO) "Build serial number is $(shell cat $<)"
  786. ###############################################################################
  787. #
  788. # Build the TAGS file(s) for emacs
  789. #
  790. TAGS :
  791. ctags -e -R -f $@ --exclude=bin
  792. CLEANUP += TAGS
  793. ###############################################################################
  794. #
  795. # Force rebuild for any given target
  796. #
  797. %.rebuild :
  798. rm -f $*
  799. $(Q)$(MAKE) $*
  800. ###############################################################################
  801. #
  802. # Symbol table checks
  803. #
  804. ifdef BIN
  805. SYMTAB = $(BIN)/symtab
  806. $(SYMTAB) : $(BLIB)
  807. $(OBJDUMP) -w -t $< > $@
  808. CLEANUP += $(BIN)/symtab
  809. symcheck : $(SYMTAB)
  810. $(SYMCHECK) $<
  811. endif # defined(BIN)
  812. ###############################################################################
  813. #
  814. # Build bochs symbol table
  815. #
  816. ifdef BIN
  817. $(BIN)/%.bxs : $(BIN)/%.tmp
  818. $(NM) $< | cut -d" " -f1,3 > $@
  819. endif # defined(BIN)
  820. ###############################################################################
  821. #
  822. # Documentation
  823. #
  824. ifdef BIN
  825. $(BIN)/doxygen.cfg : doxygen.cfg $(MAKEDEPS)
  826. $(Q)$(PERL) -pe 's{\@SRCDIRS\@}{$(SRCDIRS)}; ' \
  827. -e 's{\@INCDIRS\@}{$(filter-out .,$(INCDIRS))}; ' \
  828. -e 's{\@BIN\@}{$(BIN)}; ' \
  829. -e 's{\@ARCH\@}{$(ARCH)}; ' \
  830. $< > $@
  831. $(BIN)/doc : $(BIN)/doxygen.cfg
  832. $(Q)$(DOXYGEN) $<
  833. .PHONY : $(BIN)/doc
  834. doc : $(BIN)/doc
  835. doc-clean :
  836. $(Q)$(RM) -r $(BIN)/doc
  837. VERYCLEANUP += $(BIN)/doc
  838. docview :
  839. @[ -f $(BIN)/doc/html/index.html ] || $(MAKE) $(BIN)/doc
  840. @if [ -n "$$BROWSER" ] ; then \
  841. ( $$BROWSER $(BIN)/doc/html/index.html & ) ; \
  842. else \
  843. $(ECHO) "Documentation index in $(BIN)/doc/html/index.html" ; \
  844. fi
  845. endif # defined(BIN)
  846. ###############################################################################
  847. #
  848. # Clean-up
  849. #
  850. clean :
  851. $(RM) $(CLEANUP)
  852. veryclean : clean
  853. $(RM) -r $(VERYCLEANUP)