meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
programming:makefile [2024/03/19 13:00] – niziakprogramming:makefile [2025/04/16 13:31] (current) – niziak
Line 3: Line 3:
 Quick reference [[https://www.gnu.org/software/make/manual/html_node/Quick-Reference.html]] Quick reference [[https://www.gnu.org/software/make/manual/html_node/Quick-Reference.html]]
  
-[[http://aegis.sourceforge.net/auug97.pdf|Recursive Make Considered Harmfull]]+Recursive Make Considered Harmful: 
 +  * [[http://aegis.sourceforge.net/auug97.pdf|Recursive Make Considered Harmfull]] 
 +  * [[https://accu.org/journals/overload/14/71/miller_2004/|Recursive Make Considered Harmful]] 
 +  * [[https://news.ycombinator.com/item?id=20014348]] 
 +  * [[http://make.mad-scientist.net/papers/rules-of-makefiles/]]
  
-[[http://make.mad-scientist.net/papers/rules-of-makefiles/]] 
  
 +=== one shell ===
  
 +NOTE: read carefully issues introduced with "one shell":
 +[[https://www.gnu.org/software/make/manual/html_node/One-Shell.html|5.3.1 Using One Shell]]
  
 +<code make>
 +.ONESHELL:
 +foo : bar/lose
 +        cd $(<D)
 +        gobble $(<F) > ../$@
 +</code>
 +
 +alternatives w/o ''.ONESHELL''
 +
 +<code make>
 +target:
 + $(Q)( \
 + set -eo pipefail ; \
 + if [ -x "/opt/SEGGER/JLink/JLinkExe" ]; then \
 + echo "Skipping JLINK intallation (reason: already installed)."; \
 + exit 0; \
 + fi; \
 + \
 + wget -c -P /tmp --post-data "accept_license_agreement=accepted" --progress=dot:giga \
 + "https://www.segger.com/downloads/jlink/$(JLINK_VERSION).deb"; \
 + \
 + $(SUDO) apt-get update; \
 + $(SUDO) apt-get -y --fix-broken install "/tmp/$(JLINK_VERSION).deb"; \
 + \
 + rm "/tmp/${JLINK_VERSION}.deb"; \
 + make .jlink-workaround; \
 + make jlink-notice; \
 + )
 +
 +</code>
 +
 +=== disable built-in rules ===
 +
 +<code makefile>
 +# Disable built-in rules and variables
 +MAKEFLAGS += --no-builtin-rules
 +MAKEFLAGS += --no-builtin-variables
 +</code>
  
 === VPATH === === VPATH ===
 +
 [[https://www.gnu.org/software/make/manual/html_node/General-Search.html]] [[https://www.gnu.org/software/make/manual/html_node/General-Search.html]]
  
Line 18: Line 63:
  
 === order only prereq === === order only prereq ===
 +
 Special pipe "|" character is used.  Special pipe "|" character is used. 
-If any //$(objects)// has to be build, then //obj// has to be build first. +If any ''$(objects)'' has to be build, then ''obj'' has to be build first. 
-But if //obj// is out of date or missing, this doesn't force //$(objects)// to built.+But if ''obj'' is out of date or missing, this doesn't force ''$(objects)'' to built. 
 + 
 <code make> <code make>
 $(objects): | obj $(objects): | obj
  
 obj: obj:
-  @mkdir -p $@''+  @mkdir -p $@
 </code> </code>
  
Line 35: Line 83:
  
 === double colon rules === === double colon rules ===
 +
 [[https://www.chemie.fu-berlin.de/chemnet/use/info/make/make_4.html#SEC40]] [[https://www.chemie.fu-berlin.de/chemnet/use/info/make/make_4.html#SEC40]]
-It can be usefull, when target needs to be updates and command to update target depends on which prerequisite file caused the update. 
  
-<code makefile>+It can be useful, when target needs to be updated and command to update target depends on which prerequisite file caused the update. 
 + 
 +<code make>
 all:: all::
 </code> </code>
Line 44: Line 94:
 Another scenario is to find source .c file in different dirs Another scenario is to find source .c file in different dirs
  
-<code makefile>+<code make>
 build/%.o:: test/%.c build/%.o:: test/%.c
         $(COMPILE) $(CFLAGS) $< -o $@         $(COMPILE) $(CFLAGS) $< -o $@
Line 59: Line 109:
     * if no prereq, command is always executed     * if no prereq, command is always executed
   * Order of execution is not guaranteed   * Order of execution is not guaranteed
- 
-=== macros === 
-  * *$(dir /path/to/file.txt)* get path part only 
-  * *$(basename src/foo.c src-1.0/bar hacks)* - produces the result ‘src/foo src-1.0/bar hacks’.  
-  * *$(notdir src/foo.c hacks)* - result ‘foo.c hacks’.  
- 
  
 ====== Parallel make ====== ====== Parallel make ======
Line 72: Line 116:
 For whole file: <code makefile>.NOTPARALLEL:</code> For whole file: <code makefile>.NOTPARALLEL:</code>
 For single target: For single target:
-<code makefile>+ 
 +<code make>
 .NOTPARALLEL: %.a  .NOTPARALLEL: %.a 
 .NOTPARALLEL: foo.c bar.c  .NOTPARALLEL: foo.c bar.c 
 </code> </code>
  
-[[https://stackoverflow.com/questions/8496135/parallel-makefile-requires-dependency-ordering|Parallel makefile requires dependency ordering +[[https://stackoverflow.com/questions/8496135/parallel-makefile-requires-dependency-ordering|Parallel makefile requires dependency ordering]]
-]]+
  
 ===== Prevent one target from parallel run ===== ===== Prevent one target from parallel run =====