1 # Sample Makefile to build simple project.
3 # This Makefile expect all source files (.c) to be at the same level, in the
4 # $(SRC_PATH) directory.
6 # This Makefile expect all embedded library source files (.c) to be at the same level, in the
7 # $(LIBRARY_PATH) directory.
9 # It will automatically generate dependencies, compile all files, and produce a
10 # binary using the provided name linked against the library if necessary.
12 # Set BINARY_NAME to the name of the binary file to build.
13 # Set LIBRARY_NAME to the name of the library file to build.
14 # The default path for the library code and object is lib.
15 # By default the linker will look for $(BINARY_NAME) library name.
16 # Set BUILD_TYPE to either debug or release.
18 # Automatic dependencies code from:
19 # http://make.mad-scientist.net/papers/advanced-auto-dependency-generation/#tldr
27 # ====================================
28 # DO NOT CHANGE STUFF BEYOND THIS LINE
29 # ====================================
35 WARN_FLAGS = -Wall -Wextra
37 UNAME := $(shell uname -o)
39 ifeq ($(BUILD_TYPE),debug)
40 BUILDDIR := .build/debug
47 BUILDDIR := .build/release
61 OBJDIR := $(BUILDDIR)/objs
62 $(shell mkdir -p $(OBJDIR))
64 SRCS=$(wildcard $(SRC_PATH)/*.c)
65 LIBSRCS=$(wildcard $(LIBRARY_PATH)/*.c)
66 OBJS=$(patsubst %.c,$(OBJDIR)/%.o,$(notdir $(SRCS)))
67 LIBOBJS=$(patsubst %.c,$(OBJDIR)/%.o,$(notdir $(LIBSRCS)))
69 DEPDIR := $(BUILDDIR)/deps
70 $(shell mkdir -p $(DEPDIR))
71 DEPFLAGS = -MT $@ -MMD -MP -MF $(DEPDIR)/$(notdir $*).Td
72 POSTCOMPILE = mv -f $(DEPDIR)/$(notdir $*).Td $(DEPDIR)/$(notdir $*).d
74 ifeq ($(UNAME),Cygwin)
75 CYGWIN_DLIBRARY_NAME := $(subst lib,cyg,$(LIBRARY_NAME))
79 CYGWIN_LDLIBS_NOARCHIVE :=
80 CYGWIN_LIBLDFLAGS := -Wl,--out-implib=$(LIBRARY_PATH)/$(DLIB_PREFIX)$(LIBRARY_NAME)$(DLIB_SUFFIX).a \
81 -Wl,--export-all-symbols \
82 -Wl,--enable-auto-import
85 ifeq ($(LTO_SUPPORT),yes)
86 CFLAGS_LTO = -flto -ffat-lto-objects
87 LDFLAGS_LTO = -fuse-linker-plugin -flto
90 ifeq ($(GOLD_SUPPORT),yes)
91 LDFLAGS_GOLD = -fuse-ld=gold
94 # Putting header files in the source directory is not the purpose of this INCLUDES_PATH variable
95 INCLUDES_PATH := $(INCLUDES_PATH) -I$(LIBRARY_PATH)
96 CFLAGS := $(CFLAGS) $(CFLAGS_LTO) $(WARN_FLAGS) $(STD_FLAG) $(OPTI_FLAG) $(DEBUG_FLAG) $(INCLUDES_PATH)
97 LIBCFLAGS := -fPIC $(CFLAGS)
98 LDFLAGS := $(LDFLAGS) $(LDFLAGS_LTO) $(LDFLAGS_GOLD) $(STRIP_FLAG)
99 LIBLDFLAGS := -shared $(LDFLAGS)
100 STATICLIBLDFLAGS := -static $(LDFLAGS)
101 LDLIBS := $(LDLIBS) -L$(LIBRARY_PATH) -l$(BINARY_NAME)
103 all: $(BINARY_NAME)$(BINARY_SUFFIX) $(BINARY_NAME).dynamic$(BINARY_SUFFIX) $(BINARY_NAME).static$(BINARY_SUFFIX)
105 $(LIBRARY_PATH)/$(SLIB_PREFIX)$(LIBRARY_NAME)$(SLIB_SUFFIX): $(LIBOBJS)
109 ifeq ($(UNAME),Cygwin)
110 $(LIBRARY_PATH)/$(DLIB_PREFIX)$(LIBRARY_NAME)$(DLIB_SUFFIX).a: $(LIBRARY_PATH)/$(DLIB_PREFIX)$(CYGWIN_DLIBRARY_NAME)$(DLIB_SUFFIX)
111 $(LIBRARY_PATH)/$(DLIB_PREFIX)$(CYGWIN_DLIBRARY_NAME)$(DLIB_SUFFIX): $(LIBOBJS)
113 @$(LD) $(LIBCFLAGS) $(LIBLDFLAGS) $(CYGWIN_LIBLDFLAGS) -Wl,--whole-archive $^ -Wl,--no-whole-archive $(CYGWIN_LDLIBS_NOARCHIVE) -o $@
115 $(LIBRARY_PATH)/$(DLIB_PREFIX)$(LIBRARY_NAME)$(DLIB_SUFFIX): $(LIBOBJS)
117 @$(LD) $(LIBCFLAGS) $(LIBLDFLAGS) $^ -o $@
120 #$(BINARY_NAME)$(BINARY_SUFFIX): $(OBJS) $(LIBOBJS)
122 # @$(LD) $(CFLAGS) $(LDFLAGS) $^ $(LDLIBS) -o $@
124 $(BINARY_NAME)$(BINARY_SUFFIX): $(OBJS) $(LIBRARY_PATH)/$(SLIB_PREFIX)$(LIBRARY_NAME)$(SLIB_SUFFIX)
126 @$(LD) $(CFLAGS) $(LDFLAGS) $^ $(LDLIBS) -o $@
128 $(BINARY_NAME).static$(BINARY_SUFFIX): $(OBJS) $(LIBRARY_PATH)/$(SLIB_PREFIX)$(LIBRARY_NAME)$(SLIB_SUFFIX)
130 @$(LD) $(CFLAGS) $(STATICLIBLDFLAGS) $^ $(LDLIBS) -o $@
132 ifeq ($(UNAME),Cygwin)
133 $(BINARY_NAME).dynamic$(BINARY_SUFFIX): $(OBJS) $(LIBRARY_PATH)/$(DLIB_PREFIX)$(LIBRARY_NAME)$(DLIB_SUFFIX).a
135 $(BINARY_NAME).dynamic$(BINARY_SUFFIX): $(OBJS) $(LIBRARY_PATH)/$(DLIB_PREFIX)$(LIBRARY_NAME)$(DLIB_SUFFIX)
138 @$(LD) $(CFLAGS) $(LDFLAGS) $^ $(LDLIBS) -o $@
140 $(OBJDIR)/%.o: $(SRC_PATH)/%.c $(DEPDIR)/%.d
141 @echo "[C ] $(notdir $*)"
142 @$(CC) $(DEPFLAGS) $(CFLAGS) -c $< -o $@
145 include $(wildcard $(patsubst %,$(DEPDIR)/%.d,$(basename $(SRCS))))
147 $(OBJDIR)/%.o: $(LIBRARY_PATH)/%.c $(DEPDIR)/%.d
148 @echo "[C ] $(notdir $*)"
149 @$(CC) $(DEPFLAGS) $(LIBCFLAGS) -c $< -o $@
152 include $(wildcard $(patsubst %,$(DEPDIR)/%.d,$(basename $(LIBSRCS))))
156 .PRECIOUS: $(DEPDIR)/%.d
158 #FIXME: add an install target
163 -@rm $(BINARY_NAME)$(BINARY_SUFFIX)
164 -@rm $(BINARY_NAME).static$(BINARY_SUFFIX)
165 -@rm $(BINARY_NAME).dynamic$(BINARY_SUFFIX)
166 -@rm $(LIBRARY_PATH)/$(SLIB_PREFIX)$(LIBRARY_NAME)$(SLIB_SUFFIX)
167 ifeq ($(UNAME),Cygwin)
168 -@rm $(LIBRARY_PATH)/$(DLIB_PREFIX)$(CYGWIN_DLIBRARY_NAME)$(DLIB_SUFFIX)
169 -@rm $(LIBRARY_PATH)/$(DLIB_PREFIX)$(LIBRARY_NAME)$(DLIB_SUFFIX).a
171 -@rm $(LIBRARY_PATH)/$(DLIB_PREFIX)$(LIBRARY_NAME)$(DLIB_SUFFIX)
174 disassemble: $(BINARY_NAME)$(BINARY_SUFFIX)
177 symbols: $(BINARY_NAME)$(BINARY_SUFFIX)
178 objdump -t $< | sort | less