source: mainline/uspace/Makefile.common@ a912aff

Last change on this file since a912aff was 2660ee3, checked in by GitHub <noreply@…>, 8 years ago

Generate files that a third party can use to build software for HelenOS (#15)

Generate files that a third party can use to build software for HelenOS
without necessarily knowing anything about the build system.

  • Property mode set to 100644
File size: 9.8 KB
Line 
1#
2# Copyright (c) 2005 Martin Decky
3# Copyright (c) 2007 Jakub Jermar
4# All rights reserved.
5#
6# Redistribution and use in source and binary forms, with or without
7# modification, are permitted provided that the following conditions
8# are met:
9#
10# - Redistributions of source code must retain the above copyright
11# notice, this list of conditions and the following disclaimer.
12# - Redistributions in binary form must reproduce the above copyright
13# notice, this list of conditions and the following disclaimer in the
14# documentation and/or other materials provided with the distribution.
15# - The name of the author may not be used to endorse or promote products
16# derived from this software without specific prior written permission.
17#
18# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28#
29
30# Individual makefiles set:
31#
32# USPACE_PREFIX (*) relative path to uspace/ directory
33# SOURCES (*) list of source files
34# LIBS libraries to link with
35# DEFS compiler defines
36# EXTRA_CFLAGS additional flags to pass to C compiler
37# LINKER_SCRIPT linker script
38# PRE_DEPEND targets required for dependency check
39#
40# BINARY (/) binary output name (like appname)
41# LIBRARY (/) library output name (like libname)
42#
43# EXTRA_OUTPUT additional output targets
44# EXTRA_CLEAN additional cleanup targets
45#
46# Optionally, for a binary:
47# STATIC_NEEDED set to 'y' for init binaries, will build statically
48# linked version
49# STATIC_ONLY set to 'y' if binary cannot be linked dynamically
50# (e.g. uses thread-local variables)
51#
52# Optionally, for a library:
53# SOVERSION shared library version (major.minor),
54# if missing, no shared library is built
55#
56# (x) required variables
57# (/) exactly one of the variables must be defined
58#
59
60ROOT_PATH = $(USPACE_PREFIX)/..
61
62VERSION_DEF = $(ROOT_PATH)/version
63
64COMMON_MAKEFILE = $(ROOT_PATH)/Makefile.common
65COMMON_HEADER = $(ROOT_PATH)/common.h
66
67CONFIG_MAKEFILE = $(ROOT_PATH)/Makefile.config
68CONFIG_HEADER = $(ROOT_PATH)/config.h
69
70-include $(VERSION_DEF)
71-include $(COMMON_MAKEFILE)
72-include $(CONFIG_MAKEFILE)
73
74OUTPUTS = $(EXTRA_OUTPUT)
75
76ifneq ($(BINARY),)
77 JOB = $(BINARY).job
78 TEST_BINARY = test-$(BINARY)
79 OUTPUTS += $(BINARY) $(BINARY).disasm
80 EXTRA_CLEAN += $(BINARY).map
81endif
82
83ifneq ($(LIBRARY),)
84 JOB = $(LIBRARY).job
85 TEST_BINARY = test-$(LIBRARY)
86 OUTPUTS += $(LIBRARY).a
87endif
88
89ifeq ($(CONFIG_BUILD_SHARED_LIBS),y)
90 ifneq ($(SOVERSION),)
91 SLIBRARY = $(LIBRARY).so.$(SOVERSION)
92 LSONAME = $(LIBRARY).so.$(basename $(SOVERSION))
93 OUTPUTS += $(SLIBRARY) $(SLIBRARY).disasm $(LSONAME)
94 EXTRA_CLEAN += $(LIBRARY).la $(SLIBRARY).map
95 endif
96endif
97
98LIB_PREFIX = $(USPACE_PREFIX)/lib
99
100LIBC_PREFIX = $(LIB_PREFIX)/c
101LIBC_INCLUDES_FLAGS = \
102 -I$(LIBC_PREFIX)/include \
103 -I$(LIBC_PREFIX)/arch/$(UARCH)/include \
104 -I$(ROOT_PATH)/abi/include
105LIBSOFTFLOAT_PREFIX = $(LIB_PREFIX)/softfloat
106LIBSOFTINT_PREFIX = $(LIB_PREFIX)/softint
107
108LIBMATH_PREFIX = $(LIB_PREFIX)/math
109LIBMATH_INCLUDES_FLAGS = \
110 -I$(LIBMATH_PREFIX)/include \
111 -I$(LIBMATH_PREFIX)/arch/$(UARCH)/include
112
113LIBPOSIX_PREFIX = $(LIB_PREFIX)/posix
114LIBDLTEST_PREFIX = $(LIB_PREFIX)/dltest
115
116AFLAGS = --fatal-warnings
117LFLAGS = --fatal-warnings --warn-common
118
119ifeq ($(STATIC_NEEDED),y)
120 STATIC_BUILD = y
121else
122 ifeq ($(STATIC_ONLY),y)
123 STATIC_BUILD = y
124 else
125 ifeq ($(CONFIG_USE_SHARED_LIBS),y)
126 STATIC_BUILD = n
127 else
128 STATIC_BUILD = y
129 endif
130 endif
131endif
132
133ifeq ($(STATIC_BUILD),y)
134 BASE_LIBS = $(LIBC_PREFIX)/libc.a
135else
136 BASE_LIBS = $(LIBC_PREFIX)/libc.so.0
137 LINK_DYNAMIC = y
138endif
139
140BASE_LIBS += $(LIBSOFTFLOAT_PREFIX)/libsoftfloat.a $(LIBSOFTINT_PREFIX)/libsoftint.a
141
142ifeq ($(LINK_DYNAMIC),y)
143 LFLAGS += -Bdynamic
144 LINKER_SCRIPT ?= $(LIBC_PREFIX)/arch/$(UARCH)/_link-dlexe.ld
145else
146 LINKER_SCRIPT ?= $(LIBC_PREFIX)/arch/$(UARCH)/_link.ld
147endif
148
149LIB_LINKER_SCRIPT = $(LIBC_PREFIX)/arch/$(UARCH)/_link-shlib.ld
150
151INCLUDES_FLAGS = $(LIBC_INCLUDES_FLAGS)
152
153ifneq ($(LIBRARY),)
154 INCLUDES_FLAGS += -Iinclude -I.
155endif
156
157INCLUDES_FLAGS += $(foreach lib,$(LIBS), -I$(LIB_PREFIX)/$(lib) -I$(LIB_PREFIX)/$(lib)/include)
158
159# TODO: get rid of this special case
160ifneq ($(filter math, $(LIBS)),)
161 INCLUDES_FLAGS += $(LIBMATH_INCLUDES_FLAGS)
162endif
163
164# PCUT-based unit tests
165ifneq ($(TEST_SOURCES),)
166 TEST_OUTPUTS = $(TEST_BINARY) $(TEST_BINARY).disasm
167 TEST_CFLAGS = -I$(LIB_PREFIX)/pcut/include -D__helenos__
168 TEST_BINARY_LIBS = $(LIB_PREFIX)/pcut/libpcut.a
169 EXTRA_CLEAN += $(TEST_OUTPUTS) $(TEST_BINARY).map
170ifneq ($(LIBRARY),)
171 TEST_BINARY_LIBS += $(LIBRARY).a
172endif
173 TEST_BINARY_LIBS += $(TEST_LIBS)
174endif
175
176# Flags that are not necessary, and can be overriden, but are used by default.
177DEFAULT_CFLAGS = \
178 -O$(OPTIMIZATION) \
179 -ffunction-sections \
180 -pipe \
181 -Wall \
182 -Wextra \
183 -Wno-unused-parameter \
184 -Wmissing-prototypes \
185 -Wwrite-strings \
186 -Werror-implicit-function-declaration
187
188ifeq ($(CONFIG_DEBUG),y)
189 DEFAULT_CFLAGS += -Werror
190endif
191
192ifeq ($(COMPILER),clang)
193 DEFAULT_CFLAGS += \
194 -Wno-missing-field-initializers \
195 -Wno-typedef-redefinition \
196 -Wno-unused-command-line-argument
197else
198 DEFAULT_CFLAGS += \
199 -Wno-clobbered
200endif
201
202ifeq ($(CONFIG_LINE_DEBUG),y)
203 DEFAULT_CFLAGS += -ggdb
204endif
205
206# Flags that should always be used, even for third-party software.
207COMMON_CFLAGS = \
208 -ffreestanding \
209 -nostdlib \
210 -nostdinc \
211 -D__$(ENDIANESS)__
212
213# Flags that are always used for HelenOS code, but not for third-party.
214HELENOS_CFLAGS = \
215 -std=gnu99 \
216 $(INCLUDES_FLAGS) \
217 -imacros $(CONFIG_HEADER) \
218 -D_HELENOS_SOURCE \
219 -fexec-charset=UTF-8 \
220 -finput-charset=UTF-8 \
221 -fno-common \
222 -fdebug-prefix-map=$(realpath $(ROOT_PATH))=.
223
224# TODO: Use a different name.
225# CFLAGS variable is traditionally used for overridable flags.
226CFLAGS = $(COMMON_CFLAGS) $(HELENOS_CFLAGS) $(DEFAULT_CFLAGS)
227
228## Setup platform configuration
229#
230
231-include $(LIBC_PREFIX)/arch/$(UARCH)/Makefile.common
232
233## Compilation options
234#
235
236ifeq ($(PRECHECK),y)
237 JOBFILE = $(LIBC_PREFIX)/../../../tools/jobfile.py
238 # XXX: Do not change the order of arguments.
239 CC_JOB = $(JOBFILE) $(JOB) $(CC) $< -o $@
240else
241 CC_JOB = $(CC) $< -o $@
242endif
243
244ifeq ($(CONFIG_STRIP_BINARIES),y)
245 LFLAGS += --strip-all
246endif
247
248LIB_CFLAGS = $(CFLAGS) -fPIC
249LIB_LFLAGS = $(LFLAGS) -shared -soname $(LSONAME)
250
251AS_CFLAGS := $(addprefix -Xassembler ,$(AFLAGS))
252LD_CFLAGS := $(addprefix -Xlinker ,$(LFLAGS))
253
254OBJECTS := $(addsuffix .o,$(basename $(SOURCES)))
255LOBJECTS := $(addsuffix .lo,$(basename $(SOURCES)))
256TEST_OBJECTS := $(addsuffix .test.o,$(basename $(TEST_SOURCES)))
257DEPENDS := $(addsuffix .d,$(basename $(SOURCES))) $(addsuffix .test.d,$(basename $(TEST_SOURCES)))
258
259LIBTAGS := $(foreach lib,$(LIBS), $(USPACE_PREFIX)/lib/$(lib)/tag)
260LIBARGS := $(addprefix -L$(USPACE_PREFIX)/lib/, $(LIBS)) $(addprefix -l, $(LIBS))
261
262.PHONY: all all-test clean fasterclean depend
263
264all: tag $(OUTPUTS)
265
266all-test: $(TEST_OUTPUTS)
267
268clean: fasterclean
269 find . -name '*.o' -follow -exec rm \{\} \;
270 find . -name '*.lo' -follow -exec rm \{\} \;
271 find . -name '*.d' -follow -exec rm \{\} \;
272
273fasterclean:
274 rm -rf $(JOB) $(OUTPUTS) $(EXTRA_CLEAN) tag deps.mk
275
276depend: $(PRE_DEPEND)
277
278# "Tag" files are used to force relink of binaries when dependencies get rebuilt,
279# regardless of whether the dependency was linked statically or dynamically,
280# or which version of a dynamic library was used. Prerequisites for this file
281# are defined further down.
282tag:
283 touch tag
284
285# Generate inter-module make dependencies.
286# This is needed to ensure correct build order of libraries and code depending on them.
287deps.mk: Makefile
288 echo > $@.new
289 for lib in $(LIBS); do \
290 echo "$(SELF_TARGET): lib/$$lib.build" >> $@.new; \
291 done
292 mv -f $@.new $@
293
294%.disasm: %
295ifeq ($(CONFIG_LINE_DEBUG),y)
296 $(OBJDUMP) -d -S $< > $@
297else
298 $(OBJDUMP) -d $< > $@
299endif
300
301ifneq ($(BINARY),)
302$(BINARY): $(LINKER_SCRIPT) $(OBJECTS) $(LIBTAGS) $(BASE_LIBS)
303 $(LD) $(LFLAGS) -T $(LINKER_SCRIPT) -Map $@.map -o $@ $(OBJECTS) $(LIBARGS) $(BASE_LIBS)
304endif
305
306ifneq ($(TEST_BINARY),)
307$(TEST_BINARY): $(LINKER_SCRIPT) $(TEST_OBJECTS) $(TEST_BINARY_LIBS) $(LIBTAGS) $(BASE_LIBS)
308 $(LD) $(LFLAGS) -T $(LINKER_SCRIPT) -Map $@.map -o $@ $(TEST_OBJECTS) $(TEST_BINARY_LIBS) $(LIBARGS) $(BASE_LIBS)
309endif
310
311ifneq ($(LIBRARY),)
312tag: $(LIBRARY).a
313
314$(LIBRARY).a: $(OBJECTS)
315 $(AR) rc $@ $(OBJECTS)
316endif
317
318ifneq ($(SLIBRARY),)
319tag: $(SLIBRARY)
320
321$(LIBRARY).la: $(LOBJECTS)
322 $(AR) rc $@ $(LOBJECTS)
323
324$(SLIBRARY): $(LIB_LINKER_SCRIPT) $(LIBRARY).la
325 $(LD) $(LIB_LFLAGS) -T $(LIB_LINKER_SCRIPT) -Map $@.map -o $@ --whole-archive $(LIBRARY).la --no-whole-archive
326
327$(LSONAME):
328 ln -s $(SLIBRARY) $@
329endif
330
331%.o: %.S | depend
332 $(CC_JOB) -c -MD -MP $(DEFS) $(CFLAGS) $(EXTRA_CFLAGS) $(AS_CFLAGS) -D__ASM__
333
334%.o: %.s | depend
335 $(CC_JOB) -c -MD -MP $(DEFS) $(CFLAGS) $(EXTRA_CFLAGS) $(AS_CFLAGS) -D__ASM__
336
337%.o: %.c | depend
338 $(CC_JOB) -c -MD -MP $(DEFS) $(CFLAGS) $(EXTRA_CFLAGS)
339
340%.test.o: %.c | depend
341 $(CC_JOB) -c -MD -MP $(DEFS) $(CFLAGS) $(EXTRA_CFLAGS) $(TEST_CFLAGS)
342
343%.lo: %.S | depend
344 $(CC_JOB) -c -MD -MP $(DEFS) $(LIB_CFLAGS) $(EXTRA_CFLAGS) $(AS_CFLAGS) -D__ASM__
345
346%.lo: %.s | depend
347 $(CC_JOB) -c -MD -MP $(DEFS) $(LIB_CFLAGS) $(EXTRA_CFLAGS) $(AS_CFLAGS) -D__ASM__
348
349%.lo: %.c | depend
350 $(CC_JOB) -c -MD -MP $(DEFS) $(LIB_CFLAGS) $(EXTRA_CFLAGS)
351
352-include $(DEPENDS)
353
Note: See TracBrowser for help on using the repository browser.