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