mbuf: rename physical address to IOVA
[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 O_TO_A = $(AR) crDs $(LIB) $(OBJS-y)
94 O_TO_A_STR = $(subst ','\'',$(O_TO_A)) #'# fix syntax highlight
95 O_TO_A_DISP = $(if $(V),"$(O_TO_A_STR)","  AR $(@)")
96 O_TO_A_CMD = "cmd_$@ = $(O_TO_A_STR)"
97 O_TO_A_DO = @set -e; \
98         echo $(O_TO_A_DISP); \
99         $(O_TO_A) && \
100         echo $(O_TO_A_CMD) > $(call exe2cmd,$(@))
101
102 ifneq ($(CC_SUPPORTS_Z),false)
103 NO_UNDEFINED := -z defs
104 endif
105
106 O_TO_S = $(LD) -L$(RTE_SDK_BIN)/lib $(_CPU_LDFLAGS) $(EXTRA_LDFLAGS) \
107           -shared $(OBJS-y) $(NO_UNDEFINED) $(LDLIBS) -Wl,-soname,$(LIB) -o $(LIB)
108 O_TO_S_STR = $(subst ','\'',$(O_TO_S)) #'# fix syntax highlight
109 O_TO_S_DISP = $(if $(V),"$(O_TO_S_STR)","  LD $(@)")
110 O_TO_S_DO = @set -e; \
111         echo $(O_TO_S_DISP); \
112         $(O_TO_S) && \
113         echo $(O_TO_S_CMD) > $(call exe2cmd,$(@))
114
115 -include .$(LIB).cmd
116
117 #
118 # Archive objects in .a file if needed
119 #
120 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
121 $(LIB): $(OBJS-y) $(DEP_$(LIB)) FORCE
122 ifeq ($(LIBABIVER),)
123         @echo "Must Specify a $(LIB) ABI version"
124         @false
125 endif
126         @[ -d $(dir $@) ] || mkdir -p $(dir $@)
127         $(if $(D),\
128                 @echo -n "$< -> $@ " ; \
129                 echo -n "file_missing=$(call boolean,$(file_missing)) " ; \
130                 echo -n "cmdline_changed=$(call boolean,$(call cmdline_changed,$(O_TO_S_STR))) " ; \
131                 echo -n "depfile_missing=$(call boolean,$(depfile_missing)) " ; \
132                 echo "depfile_newer=$(call boolean,$(depfile_newer)) ")
133         $(if $(or \
134                 $(file_missing),\
135                 $(call cmdline_changed,$(O_TO_S_STR)),\
136                 $(depfile_missing),\
137                 $(depfile_newer)),\
138                 $(O_TO_S_DO))
139
140 else
141 $(LIB): $(OBJS-y) $(DEP_$(LIB)) FORCE
142         @[ -d $(dir $@) ] || mkdir -p $(dir $@)
143         $(if $(D),\
144             @echo -n "$< -> $@ " ; \
145             echo -n "file_missing=$(call boolean,$(file_missing)) " ; \
146             echo -n "cmdline_changed=$(call boolean,$(call cmdline_changed,$(O_TO_A_STR))) " ; \
147             echo -n "depfile_missing=$(call boolean,$(depfile_missing)) " ; \
148             echo "depfile_newer=$(call boolean,$(depfile_newer)) ")
149         $(if $(or \
150             $(file_missing),\
151             $(call cmdline_changed,$(O_TO_A_STR)),\
152             $(depfile_missing),\
153             $(depfile_newer)),\
154             $(O_TO_A_DO))
155 endif
156
157 #
158 # install lib in $(RTE_OUTPUT)/lib
159 #
160 $(RTE_OUTPUT)/lib/$(LIB): $(LIB)
161         @echo "  INSTALL-LIB $(LIB)"
162         @[ -d $(RTE_OUTPUT)/lib ] || mkdir -p $(RTE_OUTPUT)/lib
163         $(Q)cp -f $(LIB) $(RTE_OUTPUT)/lib
164 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
165         $(Q)ln -s -f $< $(shell echo $@ | sed 's/\.so.*/.so/')
166 endif
167
168 #
169 # Clean all generated files
170 #
171 .PHONY: clean
172 clean: _postclean
173
174 .PHONY: doclean
175 doclean:
176         $(Q)rm -rf $(LIB) $(OBJS-all) $(DEPS-all) $(DEPSTMP-all) \
177           $(CMDS-all) .$(LIB).cmd $(INSTALL-FILES-all) *.pmd.c *.pmd.o
178         $(Q)rm -f $(_BUILD_TARGETS) $(_INSTALL_TARGETS) $(_CLEAN_TARGETS)
179
180 include $(RTE_SDK)/mk/internal/rte.compile-post.mk
181 include $(RTE_SDK)/mk/internal/rte.install-post.mk
182 include $(RTE_SDK)/mk/internal/rte.clean-post.mk
183 include $(RTE_SDK)/mk/internal/rte.build-post.mk
184
185 .PHONY: FORCE
186 FORCE: