Imported Upstream version 16.11
[deb_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 include $(RTE_SDK)/mk/internal/rte.depdirs-pre.mk
37
38 EXTLIB_BUILD ?= n
39
40 # VPATH contains at least SRCDIR
41 VPATH += $(SRCDIR)
42
43 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
44 LIB := $(patsubst %.a,%.so.$(LIBABIVER),$(LIB))
45 ifeq ($(EXTLIB_BUILD),n)
46 ifeq ($(CONFIG_RTE_NEXT_ABI),y)
47 LIB := $(LIB).1
48 endif
49 CPU_LDFLAGS += --version-script=$(SRCDIR)/$(EXPORT_MAP)
50 endif
51 endif
52
53
54 _BUILD = $(LIB)
55 _INSTALL = $(INSTALL-FILES-y) $(SYMLINK-FILES-y) $(RTE_OUTPUT)/lib/$(LIB)
56 _CLEAN = doclean
57
58 .PHONY: all
59 all: install
60
61 .PHONY: install
62 install: build _postinstall
63
64 _postinstall: build
65
66 .PHONY: build
67 build: _postbuild
68
69 exe2cmd = $(strip $(call dotfile,$(patsubst %,%.cmd,$(1))))
70
71 ifeq ($(LINK_USING_CC),1)
72 # Override the definition of LD here, since we're linking with CC
73 LD := $(CC) $(CPU_CFLAGS)
74 _CPU_LDFLAGS := $(call linkerprefix,$(CPU_LDFLAGS))
75 override EXTRA_LDFLAGS := $(call linkerprefix,$(EXTRA_LDFLAGS))
76 else
77 _CPU_LDFLAGS := $(CPU_LDFLAGS)
78 endif
79
80 # Translate DEPDIRS-y into LDLIBS
81 # Ignore (sub)directory dependencies which do not provide an actual library
82 _IGNORE_DIRS = lib/librte_eal/% lib/librte_compat
83 _DEPDIRS = $(filter-out $(_IGNORE_DIRS),$(DEPDIRS-y))
84 _LDDIRS = $(subst librte_ether,librte_ethdev,$(_DEPDIRS))
85 LDLIBS += $(subst lib/lib,-l,$(_LDDIRS))
86
87 O_TO_A = $(AR) crDs $(LIB) $(OBJS-y)
88 O_TO_A_STR = $(subst ','\'',$(O_TO_A)) #'# fix syntax highlight
89 O_TO_A_DISP = $(if $(V),"$(O_TO_A_STR)","  AR $(@)")
90 O_TO_A_CMD = "cmd_$@ = $(O_TO_A_STR)"
91 O_TO_A_DO = @set -e; \
92         echo $(O_TO_A_DISP); \
93         $(O_TO_A) && \
94         echo $(O_TO_A_CMD) > $(call exe2cmd,$(@))
95
96 ifneq ($(CC_SUPPORTS_Z),false)
97 NO_UNDEFINED := -z defs
98 endif
99
100 O_TO_S = $(LD) -L$(RTE_SDK_BIN)/lib $(_CPU_LDFLAGS) $(EXTRA_LDFLAGS) \
101           -shared $(OBJS-y) $(NO_UNDEFINED) $(LDLIBS) -Wl,-soname,$(LIB) -o $(LIB)
102 O_TO_S_STR = $(subst ','\'',$(O_TO_S)) #'# fix syntax highlight
103 O_TO_S_DISP = $(if $(V),"$(O_TO_S_STR)","  LD $(@)")
104 O_TO_S_DO = @set -e; \
105         echo $(O_TO_S_DISP); \
106         $(O_TO_S) && \
107         echo $(O_TO_S_CMD) > $(call exe2cmd,$(@))
108
109 -include .$(LIB).cmd
110
111 #
112 # Archive objects in .a file if needed
113 #
114 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
115 $(LIB): $(OBJS-y) $(DEP_$(LIB)) FORCE
116 ifeq ($(LIBABIVER),)
117         @echo "Must Specify a $(LIB) ABI version"
118         @false
119 endif
120         @[ -d $(dir $@) ] || mkdir -p $(dir $@)
121         $(if $(D),\
122                 @echo -n "$< -> $@ " ; \
123                 echo -n "file_missing=$(call boolean,$(file_missing)) " ; \
124                 echo -n "cmdline_changed=$(call boolean,$(call cmdline_changed,$(O_TO_S_STR))) " ; \
125                 echo -n "depfile_missing=$(call boolean,$(depfile_missing)) " ; \
126                 echo "depfile_newer=$(call boolean,$(depfile_newer)) ")
127         $(if $(or \
128                 $(file_missing),\
129                 $(call cmdline_changed,$(O_TO_S_STR)),\
130                 $(depfile_missing),\
131                 $(depfile_newer)),\
132                 $(O_TO_S_DO))
133
134 else
135 $(LIB): $(OBJS-y) $(DEP_$(LIB)) FORCE
136         @[ -d $(dir $@) ] || mkdir -p $(dir $@)
137         $(if $(D),\
138             @echo -n "$< -> $@ " ; \
139             echo -n "file_missing=$(call boolean,$(file_missing)) " ; \
140             echo -n "cmdline_changed=$(call boolean,$(call cmdline_changed,$(O_TO_A_STR))) " ; \
141             echo -n "depfile_missing=$(call boolean,$(depfile_missing)) " ; \
142             echo "depfile_newer=$(call boolean,$(depfile_newer)) ")
143         $(if $(or \
144             $(file_missing),\
145             $(call cmdline_changed,$(O_TO_A_STR)),\
146             $(depfile_missing),\
147             $(depfile_newer)),\
148             $(O_TO_A_DO))
149 endif
150
151 #
152 # install lib in $(RTE_OUTPUT)/lib
153 #
154 $(RTE_OUTPUT)/lib/$(LIB): $(LIB)
155         @echo "  INSTALL-LIB $(LIB)"
156         @[ -d $(RTE_OUTPUT)/lib ] || mkdir -p $(RTE_OUTPUT)/lib
157         $(Q)cp -f $(LIB) $(RTE_OUTPUT)/lib
158 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
159 ifeq ($(CONFIG_RTE_NEXT_ABI)$(EXTLIB_BUILD),yn)
160         $(Q)ln -s -f $< $(basename $(basename $@))
161 else
162         $(Q)ln -s -f $< $(basename $@)
163 endif
164 endif
165
166 #
167 # Clean all generated files
168 #
169 .PHONY: clean
170 clean: _postclean
171
172 .PHONY: doclean
173 doclean:
174         $(Q)rm -rf $(LIB) $(OBJS-all) $(DEPS-all) $(DEPSTMP-all) \
175           $(CMDS-all) $(INSTALL-FILES-all)
176         $(Q)rm -f $(_BUILD_TARGETS) $(_INSTALL_TARGETS) $(_CLEAN_TARGETS)
177
178 include $(RTE_SDK)/mk/internal/rte.compile-post.mk
179 include $(RTE_SDK)/mk/internal/rte.install-post.mk
180 include $(RTE_SDK)/mk/internal/rte.clean-post.mk
181 include $(RTE_SDK)/mk/internal/rte.build-post.mk
182 include $(RTE_SDK)/mk/internal/rte.depdirs-post.mk
183
184 .PHONY: FORCE
185 FORCE: