makefileANYposixportablerules
makefile
all: app
app: main.o util.o
cc -o app main.o util.oExplicit rules are the most portable foundation.
Makefile Portable POSIX Patterns
Portable makefile patterns that work across POSIX make environments, avoiding GNU-only features when needed.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Portable make basics
Patterns that avoid GNU-only behavior.
makefileANYposixportablevariables
makefile
CC = c99
CFLAGS = -O2
LDFLAGS =
LDLIBS =
app: main.o util.o
$(CC) $(LDFLAGS) -o $@ main.o util.o $(LDLIBS)Keeping `CC`, `CFLAGS`, `LDFLAGS`, and `LDLIBS` overridable is a long-standing portable convention.
makefileANYposixsuffix-rules
makefile
.SUFFIXES: .c .o
.c.o:
$(CC) $(CFLAGS) -c $<Suffix rules are older but widely portable.
makefileANYposixcleanportable
makefile
clean:
rm -f app *.o`.PHONY` is common in modern makes, but some historical portability guidance prefers not to depend on it unless you know the implementation supports it.
bashANYposixclivariables
bash
make CC=clang CFLAGS='-O0 -g'Command-line macro assignments are part of standard make usage.
Recipe portability
Shell-safe and cross-environment recipe habits.
makefileANYportableshellrecipes
makefile
deploy:
cd infra && terraform apply -auto-approveSince each recipe line runs in its own shell by default, keep dependent shell commands on the same line in portable makefiles.
makefileANYportableshelldollar
makefile
print-pid:
@echo $$PPIDMake uses `$` for variable expansion, so shell variables need `$$`.
makefileANYportablesyntaxrecipes
makefile
target:
printf 'hello
'Traditional make syntax requires tabs unless you explicitly use GNU `.RECIPEPREFIX`.
makefileANYportabledirectories
makefile
build:
mkdir -p build`mkdir -p` is broadly available on modern POSIX systems.
Features to avoid for portability
Common GNU-only constructs that reduce portability.
makefileANYportablegnu-only
makefile
# Prefer explicit rules when portability matters
app: main.o util.o
$(CC) -o $@ $^`eval`, `call`, `foreach`, and many text functions are GNU extensions.
makefileANYportablewildcard
makefile
SRC = main.c util.c api.cSome highly portable makefiles avoid GNU-only discovery functions.
makefileANYportablegnu-onlyshell
makefile
release:
cd dist && tar -czf app.tar.gz app`.ONESHELL` is a GNU extension.
More in Makefile
Makefile Recipes for Real Projects
Production-oriented Makefile targets for apps, Docker, Terraform, Python, Node, Go, and deployment workflows.
Makefile Debugging, Parallelism & CI
Debug make behavior, inspect variables, run parallel builds safely, and build reliable CI targets.
Makefile Functions & Text Processing
GNU make text, path, conditional, shell, and metaprogramming functions with practical examples.
Makefile Pattern Rules & Dependency Generation
Pattern rules, wildcarding, implicit rules, static pattern rules, and generated dependency files in GNU make.
Makefile Cheat Sheet
Comprehensive GNU make and Makefile reference covering targets, prerequisites, recipes, variables, includes, conditionals, pattern rules, and command-line usage.