You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Makefile.housekeeping 30KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082
  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_GOALS_BINS := $(sort $(foreach BG,$(BIN_GOALS),\
  159. $(firstword $(subst /, ,$(BG)))))
  160. NUM_BINS := $(words $(BIN_GOALS_BINS))
  161. ifeq ($(NUM_BINS),0)
  162. # No BIN directory was specified. Set BIN to "bin" as a sensible
  163. # default.
  164. BIN := bin
  165. else # NUM_BINS == 0
  166. ifeq ($(NUM_BINS),1)
  167. # If exactly one BIN directory was specified, set BIN to match this
  168. # directory.
  169. #
  170. BIN := $(firstword $(BIN_GOALS_BINS))
  171. else # NUM_BINS == 1
  172. # More than one BIN directory was specified. We cannot handle the
  173. # latter case within a single make invocation, so set up recursive
  174. # targets for each BIN directory. Use exactly one target for each BIN
  175. # directory since running multiple make invocations within the same
  176. # BIN directory is likely to cause problems.
  177. #
  178. # Leave $(BIN) undefined. This has implications for any target that
  179. # depends on $(BIN); such targets should be made conditional upon the
  180. # existence of $(BIN).
  181. #
  182. BIN_GOALS_FIRST := $(foreach BGB,$(BIN_GOALS_BINS),\
  183. $(firstword $(filter $(BGB)/%,$(BIN_GOALS))))
  184. BIN_GOALS_OTHER := $(filter-out $(BIN_GOALS_FIRST),$(BIN_GOALS))
  185. $(BIN_GOALS_FIRST) : % : BIN_RECURSE
  186. $(Q)$(MAKE) --no-print-directory BIN=$(firstword $(subst /, ,$@)) \
  187. $(filter $(firstword $(subst /, ,$@))/%, $(BIN_GOALS))
  188. $(BIN_GOALS_OTHER) : % : BIN_RECURSE
  189. $(Q)$(TRUE)
  190. .PHONY : BIN_RECURSE
  191. endif # NUM_BINS == 1
  192. endif # NUM_BINS == 0
  193. ifdef BIN
  194. # Create $(BIN) directory if it doesn't exist yet
  195. #
  196. ifeq ($(wildcard $(BIN)),)
  197. $(shell $(MKDIR) -p $(BIN))
  198. endif
  199. # Target to allow e.g. "make bin-efi arch"
  200. #
  201. $(BIN) :
  202. @# Do nothing, silently
  203. .PHONY : $(BIN)
  204. # Remove everything in $(BIN) for a "make clean"
  205. #
  206. CLEANUP += $(BIN)/*.* # Avoid picking up directories
  207. endif # defined(BIN)
  208. # Determine whether or not we need to include the dependency files
  209. #
  210. NO_DEP_TARGETS := $(BIN) clean veryclean
  211. ifeq ($(MAKECMDGOALS),)
  212. NEED_DEPS := 1
  213. endif
  214. ifneq ($(strip $(filter-out $(NO_DEP_TARGETS),$(MAKECMDGOALS))),)
  215. NEED_DEPS := 1
  216. endif
  217. ###############################################################################
  218. #
  219. # Select build architecture and platform based on $(BIN)
  220. #
  221. # BIN has the form bin[-[arch-]platform]
  222. ARCHS := $(patsubst arch/%,%,$(wildcard arch/*))
  223. PLATFORMS := $(patsubst config/defaults/%.h,%,\
  224. $(wildcard config/defaults/*.h))
  225. archs :
  226. @$(ECHO) $(ARCHS)
  227. platforms :
  228. @$(ECHO) $(PLATFORMS)
  229. ifdef BIN
  230. # Determine architecture portion of $(BIN), if present
  231. BIN_ARCH := $(strip $(foreach A,$(ARCHS),\
  232. $(patsubst bin-$(A)-%,$(A),\
  233. $(filter bin-$(A)-%,$(BIN)))))
  234. # Determine platform portion of $(BIN), if present
  235. ifeq ($(BIN_ARCH),)
  236. BIN_PLATFORM := $(patsubst bin-%,%,$(filter bin-%,$(BIN)))
  237. else
  238. BIN_PLATFORM := $(patsubst bin-$(BIN_ARCH)-%,%,$(BIN))
  239. endif
  240. # Determine build architecture
  241. DEFAULT_ARCH := i386
  242. ARCH := $(firstword $(BIN_ARCH) $(DEFAULT_ARCH))
  243. CFLAGS += -DARCH=$(ARCH)
  244. arch :
  245. @$(ECHO) $(ARCH)
  246. .PHONY : arch
  247. # Determine build platform
  248. DEFAULT_PLATFORM := pcbios
  249. PLATFORM := $(firstword $(BIN_PLATFORM) $(DEFAULT_PLATFORM))
  250. CFLAGS += -DPLATFORM=$(PLATFORM)
  251. platform :
  252. @$(ECHO) $(PLATFORM)
  253. endif # defined(BIN)
  254. # Include architecture-specific Makefile
  255. ifdef ARCH
  256. MAKEDEPS += arch/$(ARCH)/Makefile
  257. include arch/$(ARCH)/Makefile
  258. endif
  259. # Include architecture-specific include path
  260. ifdef ARCH
  261. INCDIRS += arch/$(ARCH)/include
  262. INCDIRS += arch/$(ARCH)/include/$(PLATFORM)
  263. endif
  264. ###############################################################################
  265. #
  266. # Source file handling
  267. # SRCDIRS lists all directories containing source files.
  268. srcdirs :
  269. @$(ECHO) $(SRCDIRS)
  270. # SRCS lists all .c or .S files found in any SRCDIR
  271. #
  272. SRCS += $(wildcard $(patsubst %,%/*.c,$(SRCDIRS)))
  273. SRCS += $(wildcard $(patsubst %,%/*.S,$(SRCDIRS)))
  274. srcs :
  275. @$(ECHO) $(SRCS)
  276. # AUTO_SRCS lists all files in SRCS that are not mentioned in
  277. # NON_AUTO_SRCS. Files should be added to NON_AUTO_SRCS if they
  278. # cannot be built using the standard build template.
  279. #
  280. AUTO_SRCS = $(filter-out $(NON_AUTO_SRCS),$(SRCS))
  281. autosrcs :
  282. @$(ECHO) $(AUTO_SRCS)
  283. # Just about everything else in this section depends upon having
  284. # $(BIN) set
  285. ifdef BIN
  286. # INCDIRS lists the include path
  287. incdirs :
  288. @$(ECHO) $(INCDIRS)
  289. # Common flags
  290. #
  291. CFLAGS += $(foreach INC,$(INCDIRS),-I$(INC))
  292. CFLAGS += -Os
  293. CFLAGS += -g
  294. ifeq ($(CCTYPE),gcc)
  295. CFLAGS += -ffreestanding
  296. CFLAGS += -Wall -W -Wformat-nonliteral
  297. endif
  298. ifeq ($(CCTYPE),icc)
  299. CFLAGS += -fno-builtin
  300. CFLAGS += -no-ip
  301. CFLAGS += -no-gcc
  302. CFLAGS += -diag-disable 111 # Unreachable code
  303. CFLAGS += -diag-disable 128 # Unreachable loop
  304. CFLAGS += -diag-disable 170 # Array boundary checks
  305. CFLAGS += -diag-disable 177 # Unused functions
  306. CFLAGS += -diag-disable 181 # printf() format checks
  307. CFLAGS += -diag-disable 188 # enum strictness
  308. CFLAGS += -diag-disable 193 # Undefined preprocessor identifiers
  309. CFLAGS += -diag-disable 280 # switch ( constant )
  310. CFLAGS += -diag-disable 310 # K&R parameter lists
  311. CFLAGS += -diag-disable 424 # Extra semicolon
  312. CFLAGS += -diag-disable 589 # Declarations mid-code
  313. CFLAGS += -diag-disable 593 # Unused variables
  314. CFLAGS += -diag-disable 810 # Casting ints to smaller ints
  315. CFLAGS += -diag-disable 981 # Sequence point violations
  316. CFLAGS += -diag-disable 1292 # Ignored attributes
  317. CFLAGS += -diag-disable 1338 # void pointer arithmetic
  318. CFLAGS += -diag-disable 1361 # Variable-length arrays
  319. CFLAGS += -diag-disable 1418 # Missing prototypes
  320. CFLAGS += -diag-disable 1419 # Missing prototypes
  321. CFLAGS += -diag-disable 1599 # Hidden variables
  322. CFLAGS += -Wall -Wmissing-declarations
  323. endif
  324. CFLAGS += $(EXTRA_CFLAGS)
  325. ASFLAGS += $(EXTRA_ASFLAGS)
  326. LDFLAGS += $(EXTRA_LDFLAGS)
  327. # Inhibit -Werror if NO_WERROR is specified on make command line
  328. #
  329. ifneq ($(NO_WERROR),1)
  330. CFLAGS += -Werror
  331. ASFLAGS += --fatal-warnings
  332. endif
  333. # Function trace recorder state in the last build. This is needed
  334. # in order to correctly rebuild whenever the function recorder is
  335. # enabled/disabled.
  336. #
  337. FNREC_STATE := $(BIN)/.fnrec.state
  338. ifeq ($(wildcard $(FNREC_STATE)),)
  339. FNREC_OLD := <invalid>
  340. else
  341. FNREC_OLD := $(shell cat $(FNREC_STATE))
  342. endif
  343. ifeq ($(FNREC_OLD),$(FNREC))
  344. $(FNREC_STATE) :
  345. else
  346. $(FNREC_STATE) : clean
  347. $(shell $(ECHO) "$(FNREC)" > $(FNREC_STATE))
  348. endif
  349. VERYCLEANUP += $(FNREC_STATE)
  350. MAKEDEPS += $(FNREC_STATE)
  351. ifeq ($(FNREC),1)
  352. # Enabling -finstrument-functions affects gcc's analysis and leads to spurious
  353. # warnings about use of uninitialised variables.
  354. #
  355. CFLAGS += -Wno-uninitialized
  356. CFLAGS += -finstrument-functions
  357. CFLAGS += -finstrument-functions-exclude-file-list=core/fnrec.c
  358. endif
  359. # compiler.h is needed for our linking and debugging system
  360. #
  361. CFLAGS += -include compiler.h
  362. # CFLAGS for specific object types
  363. #
  364. CFLAGS_c +=
  365. CFLAGS_S += -DASSEMBLY
  366. # Base object name of the current target
  367. #
  368. OBJECT = $(firstword $(subst ., ,$(@F)))
  369. # CFLAGS for specific object files. You can define
  370. # e.g. CFLAGS_rtl8139, and have those flags automatically used when
  371. # compiling bin/rtl8139.o.
  372. #
  373. OBJ_CFLAGS = $(CFLAGS_$(OBJECT)) -DOBJECT=$(subst -,_,$(OBJECT))
  374. $(BIN)/%.flags :
  375. @$(ECHO) $(OBJ_CFLAGS)
  376. # ICC requires postprocessing objects to fix up table alignments
  377. #
  378. ifeq ($(CCTYPE),icc)
  379. POST_O = && $(ICCFIX) $@
  380. POST_O_DEPS := $(ICCFIX)
  381. else
  382. POST_O :=
  383. POST_O_DEPS :=
  384. endif
  385. # Rules for specific object types.
  386. #
  387. COMPILE_c = $(CC) $(CFLAGS) $(CFLAGS_c) $(OBJ_CFLAGS)
  388. RULE_c = $(Q)$(COMPILE_c) -c $< -o $@ $(POST_O)
  389. RULE_c_to_dbg%.o = $(Q)$(COMPILE_c) -Ddebug_$(subst -,_,$(OBJECT))=$* -c $< -o $@ $(POST_O)
  390. RULE_c_to_c = $(Q)$(COMPILE_c) -E -c $< > $@
  391. RULE_c_to_s = $(Q)$(COMPILE_c) -S -g0 -c $< -o $@
  392. PREPROCESS_S = $(CPP) $(CFLAGS) $(CFLAGS_S) $(OBJ_CFLAGS)
  393. ASSEMBLE_S = $(AS) $(ASFLAGS)
  394. RULE_S = $(Q)$(PREPROCESS_S) $< | $(ASSEMBLE_S) -o $@
  395. RULE_S_to_s = $(Q)$(PREPROCESS_S) $< > $@
  396. DEBUG_TARGETS += dbg%.o c s
  397. # We automatically generate rules for any file mentioned in AUTO_SRCS
  398. # using the following set of templates. It would be cleaner to use
  399. # $(eval ...), but this function exists only in GNU make >= 3.80.
  400. # deps_template : generate dependency list for a given source file
  401. #
  402. # $(1) is the full path to the source file (e.g. "drivers/net/rtl8139.c")
  403. # $(2) is the source type (e.g. "c")
  404. # $(3) is the source base name (e.g. "rtl8139")
  405. #
  406. define deps_template
  407. @$(ECHO) " [DEPS] $(1)"
  408. @$(MKDIR) -p $(BIN)/deps/$(dir $(1))
  409. @$(CPP) $(CFLAGS) $(CFLAGS_$(2)) $(CFLAGS_$(3)) -DOBJECT=$(3) \
  410. -Wno-error -M $(1) -MG -MP | \
  411. sed 's/\.o\s*:/_DEPS =/' > $(BIN)/deps/$(1).d
  412. endef
  413. # rules_template : generate rules for a given source file
  414. #
  415. # $(1) is the full path to the source file (e.g. "drivers/net/rtl8139.c")
  416. # $(2) is the source type (e.g. "c")
  417. # $(3) is the source base name (e.g. "rtl8139")
  418. #
  419. define rules_template
  420. @$(ECHO) " [RULES] $(1)"
  421. @$(MKDIR) -p $(BIN)/rules/$(dir $(1))
  422. @$(ECHO_E) '\n$$(BIN)/$(3).o :' \
  423. '$(1) $$(MAKEDEPS) $$(POST_O_DEPS) $$($(3)_DEPS)' \
  424. '\n\t$$(QM)$(ECHO) " [BUILD] $$@"' \
  425. '\n\t$$(RULE_$(2))\n' \
  426. '\nBOBJS += $$(BIN)/$(3).o\n' \
  427. $(foreach TGT,$(DEBUG_TARGETS), \
  428. $(if $(RULE_$(2)_to_$(TGT)), \
  429. '\n$$(BIN)/$(3).$(TGT) :' \
  430. '$(1) $$(MAKEDEPS) $$(POST_O_DEPS) $$($(3)_DEPS)' \
  431. '\n\t$$(QM)$(ECHO) " [BUILD] $$@"' \
  432. '\n\t$$(RULE_$(2)_to_$(TGT))\n' \
  433. '\n$(TGT)_OBJS += $$(BIN)/$(3).$(TGT)\n' ) ) \
  434. '\n$(BIN)/deps/$(1).d : $$($(3)_DEPS)\n' \
  435. '\nTAGS : $$($(3)_DEPS)\n' > $(BIN)/rules/$(1).r
  436. @$(PERL) $(PARSEROM) $(1) >> $(BIN)/rules/$(1).r
  437. endef
  438. # Rule to generate the dependency list file
  439. #
  440. $(BIN)/deps/%.d : % $(MAKEDEPS)
  441. $(call deps_template,$<,$(subst .,,$(suffix $<)),$(basename $(notdir $<)))
  442. # Calculate and include the list of dependency list files
  443. #
  444. AUTO_DEPS = $(patsubst %,$(BIN)/deps/%.d,$(AUTO_SRCS))
  445. ifdef NEED_DEPS
  446. ifneq ($(AUTO_DEPS),)
  447. -include $(AUTO_DEPS)
  448. endif
  449. endif
  450. autodeps :
  451. @$(ECHO) $(AUTO_DEPS)
  452. VERYCLEANUP += $(BIN)/deps
  453. # Rule to generate the rules file
  454. #
  455. $(BIN)/rules/%.r : % $(MAKEDEPS) $(PARSEROM)
  456. $(call rules_template,$<,$(subst .,,$(suffix $<)),$(basename $(notdir $<)))
  457. # Calculate and include the list of rules files
  458. #
  459. AUTO_RULES = $(patsubst %,$(BIN)/rules/%.r,$(AUTO_SRCS))
  460. ifdef NEED_DEPS
  461. ifneq ($(AUTO_RULES),)
  462. -include $(AUTO_RULES)
  463. endif
  464. endif
  465. autorules :
  466. @$(ECHO) $(AUTO_RULES)
  467. VERYCLEANUP += $(BIN)/rules
  468. # The following variables are created by the rules files
  469. #
  470. bobjs :
  471. @$(ECHO) $(BOBJS)
  472. drivers :
  473. @$(ECHO) $(DRIVERS)
  474. .PHONY : drivers
  475. roms :
  476. @$(ECHO) $(ROMS)
  477. # List of embedded images included in the last build of embedded.o.
  478. # This is needed in order to correctly rebuild embedded.o whenever the
  479. # list of objects changes.
  480. #
  481. EMBEDDED_LIST := $(BIN)/.embedded.list
  482. ifeq ($(wildcard $(EMBEDDED_LIST)),)
  483. EMBEDDED_IMAGE_OLD := <invalid>
  484. else
  485. EMBEDDED_IMAGE_OLD := $(shell cat $(EMBEDDED_LIST))
  486. endif
  487. ifneq ($(EMBEDDED_IMAGE_OLD),$(EMBEDDED_IMAGE))
  488. $(shell $(ECHO) "$(EMBEDDED_IMAGE)" > $(EMBEDDED_LIST))
  489. endif
  490. $(EMBEDDED_LIST) :
  491. VERYCLEANUP += $(EMBEDDED_LIST)
  492. EMBEDDED_FILES := $(subst $(COMMA), ,$(EMBEDDED_IMAGE))
  493. EMBED_ALL := $(foreach i,$(call seq,1,$(words $(EMBEDDED_FILES))),\
  494. EMBED ( $(i), \"$(word $(i), $(EMBEDDED_FILES))\",\
  495. \"$(notdir $(word $(i),$(EMBEDDED_FILES)))\" ))
  496. $(BIN)/embedded.o : $(EMBEDDED_FILES) $(EMBEDDED_LIST)
  497. # This file uses .incbin inline assembly to include a binary file.
  498. # Unfortunately ccache does not detect this dependency and caches builds even
  499. # when the binary file has changed.
  500. #
  501. $(BIN)/embedded.o : override CC := env CCACHE_DISABLE=1 $(CC)
  502. CFLAGS_embedded = -DEMBED_ALL="$(EMBED_ALL)"
  503. # Generate error usage information
  504. #
  505. $(BIN)/%.einfo : $(BIN)/%.o
  506. $(QM)$(ECHO) " [EINFO] $@"
  507. $(Q)$(OBJCOPY) -O binary -j .einfo --set-section-flags .einfo=alloc \
  508. $< $@
  509. EINFOS := $(patsubst $(BIN)/%.o,$(BIN)/%.einfo,$(BOBJS))
  510. $(BIN)/errors : $(EINFOS) $(EINFO)
  511. $(QM)$(ECHO) " [EINFO] $@"
  512. $(Q)$(EINFO) $(EINFOS) | sort > $@
  513. # Generate the NIC file from the parsed source files. The NIC file is
  514. # only for rom-o-matic.
  515. #
  516. $(BIN)/NIC : $(AUTO_DEPS)
  517. @$(ECHO) '# This is an automatically generated file, do not edit' > $@
  518. @$(ECHO) '# It does not affect anything in the build, ' \
  519. 'it is only for rom-o-matic' >> $@
  520. @$(ECHO) >> $@
  521. @perl -ne 'chomp; print "$$1\n" if /\# NIC\t(.*)$$/' $^ >> $@
  522. CLEANUP += $(BIN)/NIC # Doesn't match the $(BIN)/*.* pattern
  523. # Analyse a target name (e.g. "bin/dfe538--prism2_pci.zrom.tmp") and
  524. # derive the variables:
  525. #
  526. # TGT_ELEMENTS : the elements of the target (e.g. "dfe538 prism2_pci")
  527. # TGT_PREFIX : the prefix type (e.g. "zrom")
  528. # TGT_DRIVERS : the driver for each element (e.g. "rtl8139 prism2_pci")
  529. # TGT_ROM_NAME : the ROM name (e.g. "dfe538")
  530. # TGT_MEDIA : the media type (e.g. "rom")
  531. #
  532. DRIVERS_ipxe = $(DRIVERS)
  533. CARD_DRIVER = $(firstword $(DRIVER_$(1)) $(1))
  534. TGT_ELEMENTS = $(subst --, ,$(firstword $(subst ., ,$(notdir $@))))
  535. TGT_PREFIX = $(word 2,$(subst ., ,$(notdir $@)))
  536. TGT_ROM_NAME = $(firstword $(TGT_ELEMENTS))
  537. TGT_DRIVERS = $(strip $(if $(DRIVERS_$(TGT_ROM_NAME)), \
  538. $(DRIVERS_$(TGT_ROM_NAME)), \
  539. $(foreach TGT_ELEMENT,$(TGT_ELEMENTS), \
  540. $(call CARD_DRIVER,$(TGT_ELEMENT))) ))
  541. TGT_MEDIA = $(subst z,,$(TGT_PREFIX))
  542. # Look up ROM IDs for the current target
  543. # (e.g. "bin/dfe538--prism2_pci.zrom.tmp") and derive the variables:
  544. #
  545. # TGT_PCI_VENDOR : the PCI vendor ID (e.g. "0x1186")
  546. # TGT_PCI_DEVICE : the PCI device ID (e.g. "0x1300")
  547. #
  548. TGT_PCI_VENDOR = $(PCI_VENDOR_$(TGT_ROM_NAME))
  549. TGT_PCI_DEVICE = $(PCI_DEVICE_$(TGT_ROM_NAME))
  550. # Calculate link-time options for the current target
  551. # (e.g. "bin/dfe538--prism2_pci.zrom.tmp") and derive the variables:
  552. #
  553. # TGT_LD_DRIVERS : symbols to require in order to drag in the relevant drivers
  554. # (e.g. "obj_rtl8139 obj_prism2_pci")
  555. # TGT_LD_IDS : symbols to define in order to fill in ID structures in the
  556. # ROM header (e.g."pci_vendor_id=0x1186 pci_device_id=0x1300")
  557. #
  558. TGT_LD_DRIVERS = $(subst -,_,$(patsubst %,obj_%,$(TGT_DRIVERS)))
  559. TGT_LD_PREFIX = obj_$(TGT_PREFIX)prefix
  560. TGT_LD_IDS = pci_vendor_id=$(firstword $(TGT_PCI_VENDOR) 0) \
  561. pci_device_id=$(firstword $(TGT_PCI_DEVICE) 0)
  562. # Calculate linker flags based on link-time options for the current
  563. # target type (e.g. "bin/dfe538--prism2_pci.zrom.tmp") and derive the
  564. # variables:
  565. #
  566. # TGT_LD_FLAGS : target-specific flags to pass to linker (e.g.
  567. # "-u obj_zpciprefix -u obj_rtl8139 -u obj_prism2_pci
  568. # --defsym pci_vendor=0x1186 --defsym pci_device=0x1300")
  569. #
  570. TGT_LD_FLAGS = $(foreach SYM,$(TGT_LD_PREFIX) $(TGT_LD_DRIVERS) obj_config,\
  571. -u $(SYM) --defsym check_$(SYM)=$(SYM) ) \
  572. $(patsubst %,--defsym %,$(TGT_LD_IDS)) \
  573. $(TGT_LD_FLAGS_PRE)
  574. # Calculate list of debugging versions of objects to be included in
  575. # the target.
  576. #
  577. DEBUG_LIST = $(subst $(COMMA), ,$(DEBUG))
  578. DEBUG_OBJ_LEVEL = $(firstword $(word 2,$(subst :, ,$(1))) 1)
  579. DEBUG_OBJ_BASE = $(word 1,$(subst :, ,$(1))).dbg$(call DEBUG_OBJ_LEVEL,$(1))
  580. DEBUG_OBJ = $(BIN)/$(call DEBUG_OBJ_BASE,$(1)).o
  581. DEBUG_ORIG_OBJ = $(BIN)/$(word 1,$(subst :, ,$(1))).o
  582. DEBUG_OBJS = $(foreach D,$(DEBUG_LIST),$(call DEBUG_OBJ,$(D)))
  583. DEBUG_ORIG_OBJS = $(foreach D,$(DEBUG_LIST),$(call DEBUG_ORIG_OBJ,$(D)))
  584. BLIB_OBJS = $(DEBUG_OBJS) $(filter-out $(DEBUG_ORIG_OBJS),$(BOBJS))
  585. # Print out all derived information for a given target.
  586. #
  587. $(BIN)/%.info :
  588. @$(ECHO) 'Elements : $(TGT_ELEMENTS)'
  589. @$(ECHO) 'Prefix : $(TGT_PREFIX)'
  590. @$(ECHO) 'Drivers : $(TGT_DRIVERS)'
  591. @$(ECHO) 'ROM name : $(TGT_ROM_NAME)'
  592. @$(ECHO) 'Media : $(TGT_MEDIA)'
  593. @$(ECHO)
  594. @$(ECHO) 'PCI vendor : $(TGT_PCI_VENDOR)'
  595. @$(ECHO) 'PCI device : $(TGT_PCI_DEVICE)'
  596. @$(ECHO)
  597. @$(ECHO) 'LD driver symbols : $(TGT_LD_DRIVERS)'
  598. @$(ECHO) 'LD prefix symbols : $(TGT_LD_PREFIX)'
  599. @$(ECHO) 'LD ID symbols : $(TGT_LD_IDS)'
  600. @$(ECHO)
  601. @$(ECHO) 'LD target flags : $(TGT_LD_FLAGS)'
  602. @$(ECHO)
  603. @$(ECHO) 'Debugging objects : $(DEBUG_OBJS)'
  604. @$(ECHO) 'Replaced objects : $(DEBUG_ORIG_OBJS)'
  605. # List of objects included in the last build of blib. This is needed
  606. # in order to correctly rebuild blib whenever the list of objects
  607. # changes.
  608. #
  609. BLIB_LIST := $(BIN)/.blib.list
  610. ifeq ($(wildcard $(BLIB_LIST)),)
  611. BLIB_OBJS_OLD := <invalid>
  612. else
  613. BLIB_OBJS_OLD := $(shell cat $(BLIB_LIST))
  614. endif
  615. ifneq ($(BLIB_OBJS_OLD),$(BLIB_OBJS))
  616. $(shell $(ECHO) "$(BLIB_OBJS)" > $(BLIB_LIST))
  617. endif
  618. $(BLIB_LIST) :
  619. VERYCLEANUP += $(BLIB_LIST)
  620. # Library of all objects
  621. #
  622. BLIB = $(BIN)/blib.a
  623. $(BLIB) : $(BLIB_OBJS) $(BLIB_LIST) $(MAKEDEPS)
  624. $(Q)$(RM) $(BLIB)
  625. $(QM)$(ECHO) " [AR] $@"
  626. $(Q)$(AR) r $@ $(BLIB_OBJS)
  627. $(Q)$(RANLIB) $@
  628. blib : $(BLIB)
  629. # Command to generate build ID. Must be unique for each $(BIN)/%.tmp,
  630. # even within the same build run.
  631. #
  632. BUILD_ID_CMD := perl -e 'printf "0x%08x", int ( rand ( 0xffffffff ) );'
  633. # Build an intermediate object file from the objects required for the
  634. # specified target.
  635. #
  636. $(BIN)/%.tmp : $(BLIB) $(MAKEDEPS) $(LDSCRIPT)
  637. $(QM)$(ECHO) " [LD] $@"
  638. $(Q)$(LD) $(LDFLAGS) -T $(LDSCRIPT) $(TGT_LD_FLAGS) $(BLIB) -o $@ \
  639. --defsym _build_id=`$(BUILD_ID_CMD)` -Map $(BIN)/$*.tmp.map
  640. $(Q)$(OBJDUMP) -ht $@ | $(PERL) $(SORTOBJDUMP) >> $(BIN)/$*.tmp.map
  641. # Keep intermediate object file (useful for debugging)
  642. .PRECIOUS : $(BIN)/%.tmp
  643. # Show a linker map for the specified target
  644. #
  645. $(BIN)/%.map : $(BIN)/%.tmp
  646. @less $(BIN)/$*.tmp.map
  647. # Get objects list for the specified target
  648. #
  649. define objs_list
  650. $(sort $(foreach OBJ_SYMBOL,\
  651. $(filter obj_%,$(shell $(NM) $(1) | cut -d" " -f3)),\
  652. $(patsubst obj_%,%,$(OBJ_SYMBOL))))
  653. endef
  654. $(BIN)/%.objs : $(BIN)/%.tmp
  655. $(Q)$(ECHO) $(call objs_list,$<)
  656. $(BIN)/%.sizes : $(BIN)/%.tmp
  657. $(Q)$(SIZE) -t $(foreach OBJ,$(call objs_list,$<),$(wildcard $(BIN)/$(subst _,?,$(OBJ)).o)) | \
  658. sort -g
  659. # Get dependency list for the specified target
  660. #
  661. define deps_list
  662. $(sort $(foreach OBJ,$(call objs_list,$(1)),$($(OBJ)_DEPS)))
  663. endef
  664. $(BIN)/%.deps : $(BIN)/%.tmp
  665. $(Q)$(ECHO) $(call deps_list,$<)
  666. # Get unneeded source files for the specified target
  667. #
  668. define nodeps_list
  669. $(sort $(filter-out $(call deps_list,$(1)),\
  670. $(foreach BOBJ,$(BOBJS),\
  671. $($(basename $(notdir $(BOBJ)))_DEPS))))
  672. endef
  673. $(BIN)/%.nodeps : $(BIN)/%.tmp
  674. $(Q)$(ECHO) $(call nodeps_list,$<)
  675. # Get licensing verdict for the specified target
  676. #
  677. define licensable_deps_list
  678. $(filter-out config/local/%.h,$(call deps_list,$(1)))
  679. endef
  680. define unlicensed_deps_list
  681. $(shell grep -L FILE_LICENCE $(call licensable_deps_list,$(1)))
  682. endef
  683. define licence_list
  684. $(patsubst __licence_%,%,\
  685. $(filter __licence_%,$(shell $(NM) $(1) | cut -d" " -f3)))
  686. endef
  687. $(BIN)/%.licence : $(BIN)/%.tmp
  688. $(QM)$(ECHO) " [LICENCE] $@"
  689. $(Q)$(if $(strip $(call unlicensed_deps_list,$<)),\
  690. echo -n "Unable to determine licence because the following " ;\
  691. echo "files are missing a licence declaration:" ;\
  692. echo $(call unlicensed_deps_list,$<);\
  693. exit 1,\
  694. $(PERL) $(LICENCE) $(call licence_list,$<))
  695. # Extract compression information from intermediate object file
  696. #
  697. $(BIN)/%.zinfo : $(BIN)/%.tmp
  698. $(QM)$(ECHO) " [ZINFO] $@"
  699. $(Q)$(OBJCOPY) -O binary -j .zinfo $< $@
  700. # Build raw binary file from intermediate object file
  701. #
  702. $(BIN)/%.bin : $(BIN)/%.tmp
  703. $(QM)$(ECHO) " [BIN] $@"
  704. $(Q)$(OBJCOPY) -O binary -R .zinfo $< $@
  705. # Compress raw binary file
  706. #
  707. $(BIN)/%.zbin : $(BIN)/%.bin $(BIN)/%.zinfo $(ZBIN)
  708. $(QM)$(ECHO) " [ZBIN] $@"
  709. $(Q)$(ZBIN) $(BIN)/$*.bin $(BIN)/$*.zinfo > $@
  710. # Rules for each media format. These are generated and placed in an
  711. # external Makefile fragment. We could do this via $(eval ...), but
  712. # that would require make >= 3.80.
  713. #
  714. # Note that there's an alternative way to generate most .rom images:
  715. # they can be copied from their 'master' ROM image using cp and
  716. # reprocessed with makerom to add the PCI IDs and ident string. The
  717. # relevant rule would look something like:
  718. #
  719. # $(BIN)/dfe538%rom : $(BIN)/rtl8139%rom
  720. # cat $< $@
  721. # $(FINALISE_rom)
  722. #
  723. # You can derive the ROM/driver relationships using the variables
  724. # DRIVER_<rom> and/or ROMS_<driver>.
  725. #
  726. # We don't currently do this, because (a) it would require generating
  727. # yet more Makefile fragments (since you need a rule for each ROM in
  728. # ROMS), and (b) the linker is so fast that it probably wouldn't make
  729. # much difference to the overall build time.
  730. # Add NON_AUTO_MEDIA to the media list, so that they show up in the
  731. # output of "make"
  732. #
  733. MEDIA += $(NON_AUTO_MEDIA)
  734. media :
  735. @$(ECHO) $(MEDIA)
  736. AUTO_MEDIA = $(filter-out $(NON_AUTO_MEDIA),$(MEDIA))
  737. automedia :
  738. @$(ECHO) $(AUTO_MEDIA)
  739. # media_template : create Makefile rules for specified media
  740. #
  741. # $(1) is the media name (e.g. "rom")
  742. #
  743. define media_template
  744. @$(ECHO) " [MEDIARULES] $(1)"
  745. @$(MKDIR) -p $(BIN)/rules/$(dir $(1))
  746. @$(ECHO_E) '$$(BIN)/%.$(1) : $$(BIN)/%.$(1).zbin' \
  747. '\n\t$$(QM)$(ECHO) " [FINISH] $$@"' \
  748. '\n\t$$(Q)$$(CP) $$< $$@' \
  749. '\n\t$$(Q)$$(PAD_$(1))' \
  750. '\n\t$$(Q)$$(FINALISE_$(1))' \
  751. > $(BIN)/rules/$(1).media.r
  752. endef
  753. # Rule to generate the Makefile rules to be included
  754. #
  755. $(BIN)/rules/%.media.r : $(MAKEDEPS)
  756. $(call media_template,$*)
  757. # Calculate and include the list of Makefile rules files
  758. #
  759. MEDIA_RULES = $(patsubst %,$(BIN)/rules/%.media.r,$(AUTO_MEDIA))
  760. mediarules :
  761. @$(ECHO) $(MEDIA_RULES)
  762. ifdef NEED_DEPS
  763. ifneq ($(MEDIA_RULES),)
  764. -include $(MEDIA_RULES)
  765. endif
  766. endif
  767. # Wrap up binary blobs (for embedded images)
  768. #
  769. $(BIN)/%.o : payload/%.img
  770. $(QM)echo " [WRAP] $@"
  771. $(Q)$(LD) -b binary -r -o $@ $< --undefined obj_payload \
  772. --defsym obj_$*=0
  773. BOBJS += $(patsubst payload/%.img,$(BIN)/%.o,$(wildcard payload/*.img))
  774. # The "allXXXs" targets for each suffix
  775. #
  776. allall: allroms allzroms allpxes allisos alldsks
  777. allroms allzroms : all%s : $(foreach ROM,$(ROMS),$(BIN)/$(ROM).%)
  778. allpxes allisos alldsks : all%s : $(foreach DRIVER,$(DRIVERS),$(BIN)/$(DRIVER).%)
  779. # Alias for ipxe.%
  780. #
  781. $(BIN)/etherboot.% : $(BIN)/ipxe.%
  782. ln -sf $(notdir $<) $@
  783. endif # defined(BIN)
  784. ###############################################################################
  785. #
  786. # The compression utilities
  787. #
  788. $(NRV2B) : util/nrv2b.c $(MAKEDEPS)
  789. $(QM)$(ECHO) " [HOSTCC] $@"
  790. $(Q)$(HOST_CC) -O2 -DENCODE -DDECODE -DMAIN -DVERBOSE -DNDEBUG \
  791. -DBITSIZE=32 -DENDIAN=0 -o $@ $<
  792. CLEANUP += $(NRV2B)
  793. $(ZBIN) : util/zbin.c util/nrv2b.c $(MAKEDEPS)
  794. $(QM)$(ECHO) " [HOSTCC] $@"
  795. $(Q)$(HOST_CC) -O2 -o $@ $<
  796. CLEANUP += $(ZBIN)
  797. ###############################################################################
  798. #
  799. # The EFI image converter
  800. #
  801. ELF2EFI_CFLAGS := -I$(BINUTILS_DIR)/include -I$(BFD_DIR)/include \
  802. -I$(ZLIB_DIR)/include -idirafter include \
  803. -L$(BINUTILS_DIR)/lib -L$(BFD_DIR)/lib -L$(ZLIB_DIR)/lib \
  804. -lbfd -ldl -liberty -lz -Wl,--no-warn-search-mismatch
  805. $(ELF2EFI32) : util/elf2efi.c $(MAKEDEPS)
  806. $(QM)$(ECHO) " [HOSTCC] $@"
  807. $(Q)$(HOST_CC) $< $(ELF2EFI_CFLAGS) -DEFI_TARGET_IA32 -O2 -o $@
  808. CLEANUP += $(ELF2EFI32)
  809. $(ELF2EFI64) : util/elf2efi.c $(MAKEDEPS)
  810. $(QM)$(ECHO) " [HOSTCC] $@"
  811. $(Q)$(HOST_CC) $< $(ELF2EFI_CFLAGS) -DEFI_TARGET_X64 -O2 -o $@
  812. CLEANUP += $(ELF2EFI64)
  813. $(EFIROM) : util/efirom.c $(MAKEDEPS)
  814. $(QM)$(ECHO) " [HOSTCC] $@"
  815. $(Q)$(HOST_CC) -idirafter include -O2 -o $@ $<
  816. CLEANUP += $(EFIROM)
  817. ###############################################################################
  818. #
  819. # The ICC fixup utility
  820. #
  821. $(ICCFIX) : util/iccfix.c $(MAKEDEPS)
  822. $(QM)$(ECHO) " [HOSTCC] $@"
  823. $(Q)$(HOST_CC) -idirafter include -O2 -o $@ $<
  824. CLEANUP += $(ICCFIX)
  825. ###############################################################################
  826. #
  827. # The error usage information utility
  828. #
  829. $(EINFO) : util/einfo.c $(MAKEDEPS)
  830. $(QM)$(ECHO) " [HOSTCC] $@"
  831. $(Q)$(HOST_CC) -idirafter include -O2 -o $@ $<
  832. CLEANUP += $(EINFO)
  833. ###############################################################################
  834. #
  835. # Local configs
  836. #
  837. config/local/%.h :
  838. $(Q)touch $@
  839. ###############################################################################
  840. #
  841. # Auto-incrementing build serial number. Append "bs" to your list of
  842. # build targets to get a serial number printed at the end of the
  843. # build. Enable -DBUILD_SERIAL in order to see it when the code runs.
  844. #
  845. BUILDSERIAL_H = config/.buildserial.h
  846. BUILDSERIAL_NOW = config/.buildserial.now
  847. BUILDSERIAL_NEXT = config/.buildserial.next
  848. $(BUILDSERIAL_NOW) $(BUILDSERIAL_NEXT) :
  849. $(ECHO) 1 > $@
  850. $(BUILDSERIAL_H) : $(BUILDSERIAL_NOW) $(BUILDSERIAL_NEXT)
  851. $(ECHO) '#define BUILD_SERIAL_NUM $(shell cat $<)' > $@
  852. ifeq ($(filter bs,$(MAKECMDGOALS)),bs)
  853. $(shell diff -q $(BUILDSERIAL_NOW) $(BUILDSERIAL_NEXT) > /dev/null || \
  854. cp -f $(BUILDSERIAL_NEXT) $(BUILDSERIAL_NOW))
  855. endif
  856. bs : $(BUILDSERIAL_NOW)
  857. @$(ECHO) $$(( $(shell cat $<) + 1 )) > $(BUILDSERIAL_NEXT)
  858. @$(ECHO) "Build serial number is $(shell cat $<)"
  859. ###############################################################################
  860. #
  861. # Build the TAGS file(s) for emacs
  862. #
  863. TAGS :
  864. ctags -e -R -f $@ --exclude=bin
  865. CLEANUP += TAGS
  866. ###############################################################################
  867. #
  868. # Force rebuild for any given target
  869. #
  870. %.rebuild :
  871. rm -f $*
  872. $(Q)$(MAKE) $*
  873. ###############################################################################
  874. #
  875. # Symbol table checks
  876. #
  877. ifdef BIN
  878. SYMTAB = $(BIN)/symtab
  879. $(SYMTAB) : $(BLIB)
  880. $(OBJDUMP) -w -t $< > $@
  881. CLEANUP += $(BIN)/symtab
  882. symcheck : $(SYMTAB)
  883. $(PERL) $(SYMCHECK) $<
  884. endif # defined(BIN)
  885. ###############################################################################
  886. #
  887. # Build bochs symbol table
  888. #
  889. ifdef BIN
  890. $(BIN)/%.bxs : $(BIN)/%.tmp
  891. $(NM) $< | cut -d" " -f1,3 > $@
  892. endif # defined(BIN)
  893. ###############################################################################
  894. #
  895. # Documentation
  896. #
  897. ifdef BIN
  898. $(BIN)/doxygen.cfg : doxygen.cfg $(MAKEDEPS)
  899. $(Q)$(PERL) -pe 's{\@SRCDIRS\@}{$(SRCDIRS)}; ' \
  900. -e 's{\@INCDIRS\@}{$(filter-out .,$(INCDIRS))}; ' \
  901. -e 's{\@BIN\@}{$(BIN)}; ' \
  902. -e 's{\@ARCH\@}{$(ARCH)}; ' \
  903. $< > $@
  904. $(BIN)/doc : $(BIN)/doxygen.cfg
  905. $(Q)$(DOXYGEN) $<
  906. .PHONY : $(BIN)/doc
  907. doc : $(BIN)/doc
  908. doc-clean :
  909. $(Q)$(RM) -r $(BIN)/doc
  910. VERYCLEANUP += $(BIN)/doc
  911. docview :
  912. @[ -f $(BIN)/doc/html/index.html ] || $(MAKE) $(BIN)/doc
  913. @if [ -n "$$BROWSER" ] ; then \
  914. ( $$BROWSER $(BIN)/doc/html/index.html & ) ; \
  915. else \
  916. $(ECHO) "Documentation index in $(BIN)/doc/html/index.html" ; \
  917. fi
  918. endif # defined(BIN)
  919. ###############################################################################
  920. #
  921. # Clean-up
  922. #
  923. clean :
  924. $(RM) $(CLEANUP)
  925. veryclean : clean
  926. $(RM) -r $(VERYCLEANUP)