mk: install symlinks before build step
[dpdk.git] / mk / rte.lib.mk
1 #   BSD LICENSE
2 #
3 #   Copyright(c) 2010-2014 Intel Corporation. All rights reserved.
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
14 #       the documentation and/or other materials provided with the
15 #       distribution.
16 #     * Neither the name of Intel Corporation nor the names of its
17 #       contributors may be used to endorse or promote products derived
18 #       from this software without specific prior written permission.
19 #
20 #   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21 #   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22 #   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23 #   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24 #   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25 #   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26 #   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27 #   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28 #   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29 #   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30 #   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31
32 include $(RTE_SDK)/mk/internal/rte.compile-pre.mk
33 include $(RTE_SDK)/mk/internal/rte.install-pre.mk
34 include $(RTE_SDK)/mk/internal/rte.clean-pre.mk
35 include $(RTE_SDK)/mk/internal/rte.build-pre.mk
36
37 EXTLIB_BUILD ?= n
38
39 # VPATH contains at least SRCDIR
40 VPATH += $(SRCDIR)
41
42 ifneq ($(CONFIG_RTE_MAJOR_ABI),)
43 ifneq ($(LIBABIVER),)
44 LIBABIVER := $(CONFIG_RTE_MAJOR_ABI)
45 endif
46 endif
47
48 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
49 LIB := $(patsubst %.a,%.so.$(LIBABIVER),$(LIB))
50 ifeq ($(EXTLIB_BUILD),n)
51 ifeq ($(CONFIG_RTE_MAJOR_ABI),)
52 ifeq ($(CONFIG_RTE_NEXT_ABI),y)
53 LIB := $(LIB).1
54 endif
55 endif
56 CPU_LDFLAGS += --version-script=$(SRCDIR)/$(EXPORT_MAP)
57 endif
58 endif
59
60
61 _BUILD = $(LIB)
62 PREINSTALL = $(SYMLINK-FILES-y)
63 _INSTALL = $(INSTALL-FILES-y) $(RTE_OUTPUT)/lib/$(LIB)
64 _CLEAN = doclean
65
66 .PHONY: all
67 all: install
68
69 .PHONY: install
70 ifeq ($(SYMLINK-FILES-y),)
71 install: build _postinstall
72 else
73 install: _preinstall build _postinstall
74 build: _preinstall
75 endif
76
77 _postinstall: build
78
79 .PHONY: build
80 build: _postbuild
81
82 exe2cmd = $(strip $(call dotfile,$(patsubst %,%.cmd,$(1))))
83
84 ifeq ($(LINK_USING_CC),1)
85 # Override the definition of LD here, since we're linking with CC
86 LD := $(CC) $(CPU_CFLAGS) $(EXTRA_CFLAGS)
87 _CPU_LDFLAGS := $(call linkerprefix,$(CPU_LDFLAGS))
88 override EXTRA_LDFLAGS := $(call linkerprefix,$(EXTRA_LDFLAGS))
89 else
90 _CPU_LDFLAGS := $(CPU_LDFLAGS)
91 endif
92
93 # Translate DEPDIRS into LDLIBS
94 # Ignore (sub)directory dependencies which do not provide an actual library
95 _IGNORE_DIRS = librte_eal/% librte_compat
96 _DEPDIRS = $(filter-out $(_IGNORE_DIRS),$(DEPDIRS))
97 _LDDIRS = $(subst librte_ether,librte_ethdev,$(_DEPDIRS))
98 LDLIBS += $(subst lib,-l,$(_LDDIRS))
99
100 O_TO_A = $(AR) crDs $(LIB) $(OBJS-y)
101 O_TO_A_STR = $(subst ','\'',$(O_TO_A)) #'# fix syntax highlight
102 O_TO_A_DISP = $(if $(V),"$(O_TO_A_STR)","  AR $(@)")
103 O_TO_A_CMD = "cmd_$@ = $(O_TO_A_STR)"
104 O_TO_A_DO = @set -e; \
105         echo $(O_TO_A_DISP); \
106         $(O_TO_A) && \
107         echo $(O_TO_A_CMD) > $(call exe2cmd,$(@))
108
109 ifneq ($(CC_SUPPORTS_Z),false)
110 NO_UNDEFINED := -z defs
111 endif
112
113 O_TO_S = $(LD) -L$(RTE_SDK_BIN)/lib $(_CPU_LDFLAGS) $(EXTRA_LDFLAGS) \
114           -shared $(OBJS-y) $(NO_UNDEFINED) $(LDLIBS) -Wl,-soname,$(LIB) -o $(LIB)
115 O_TO_S_STR = $(subst ','\'',$(O_TO_S)) #'# fix syntax highlight
116 O_TO_S_DISP = $(if $(V),"$(O_TO_S_STR)","  LD $(@)")
117 O_TO_S_DO = @set -e; \
118         echo $(O_TO_S_DISP); \
119         $(O_TO_S) && \
120         echo $(O_TO_S_CMD) > $(call exe2cmd,$(@))
121
122 -include .$(LIB).cmd
123
124 #
125 # Archive objects in .a file if needed
126 #
127 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
128 $(LIB): $(OBJS-y) $(DEP_$(LIB)) FORCE
129 ifeq ($(LIBABIVER),)
130         @echo "Must Specify a $(LIB) ABI version"
131         @false
132 endif
133         @[ -d $(dir $@) ] || mkdir -p $(dir $@)
134         $(if $(D),\
135                 @echo -n "$< -> $@ " ; \
136                 echo -n "file_missing=$(call boolean,$(file_missing)) " ; \
137                 echo -n "cmdline_changed=$(call boolean,$(call cmdline_changed,$(O_TO_S_STR))) " ; \
138                 echo -n "depfile_missing=$(call boolean,$(depfile_missing)) " ; \
139                 echo "depfile_newer=$(call boolean,$(depfile_newer)) ")
140         $(if $(or \
141                 $(file_missing),\
142                 $(call cmdline_changed,$(O_TO_S_STR)),\
143                 $(depfile_missing),\
144                 $(depfile_newer)),\
145                 $(O_TO_S_DO))
146
147 else
148 $(LIB): $(OBJS-y) $(DEP_$(LIB)) FORCE
149         @[ -d $(dir $@) ] || mkdir -p $(dir $@)
150         $(if $(D),\
151             @echo -n "$< -> $@ " ; \
152             echo -n "file_missing=$(call boolean,$(file_missing)) " ; \
153             echo -n "cmdline_changed=$(call boolean,$(call cmdline_changed,$(O_TO_A_STR))) " ; \
154             echo -n "depfile_missing=$(call boolean,$(depfile_missing)) " ; \
155             echo "depfile_newer=$(call boolean,$(depfile_newer)) ")
156         $(if $(or \
157             $(file_missing),\
158             $(call cmdline_changed,$(O_TO_A_STR)),\
159             $(depfile_missing),\
160             $(depfile_newer)),\
161             $(O_TO_A_DO))
162 endif
163
164 #
165 # install lib in $(RTE_OUTPUT)/lib
166 #
167 $(RTE_OUTPUT)/lib/$(LIB): $(LIB)
168         @echo "  INSTALL-LIB $(LIB)"
169         @[ -d $(RTE_OUTPUT)/lib ] || mkdir -p $(RTE_OUTPUT)/lib
170         $(Q)cp -f $(LIB) $(RTE_OUTPUT)/lib
171 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
172         $(Q)ln -s -f $< $(shell echo $@ | sed 's/\.so.*/.so/')
173 endif
174
175 #
176 # Clean all generated files
177 #
178 .PHONY: clean
179 clean: _postclean
180
181 .PHONY: doclean
182 doclean:
183         $(Q)rm -rf $(LIB) $(OBJS-all) $(DEPS-all) $(DEPSTMP-all) \
184           $(CMDS-all) .$(LIB).cmd $(INSTALL-FILES-all) *.pmd.c *.pmd.o
185         $(Q)rm -f $(_BUILD_TARGETS) $(_INSTALL_TARGETS) $(_CLEAN_TARGETS)
186
187 include $(RTE_SDK)/mk/internal/rte.compile-post.mk
188 include $(RTE_SDK)/mk/internal/rte.install-post.mk
189 include $(RTE_SDK)/mk/internal/rte.clean-post.mk
190 include $(RTE_SDK)/mk/internal/rte.build-post.mk
191
192 .PHONY: FORCE
193 FORCE: