4df8849a0864deb641a7fa640d0823e7c9672b6d
[dpdk.git] / mk / rte.lib.mk
1 # SPDX-License-Identifier: BSD-3-Clause
2 # Copyright(c) 2010-2014 Intel Corporation
3
4 include $(RTE_SDK)/mk/internal/rte.compile-pre.mk
5 include $(RTE_SDK)/mk/internal/rte.install-pre.mk
6 include $(RTE_SDK)/mk/internal/rte.clean-pre.mk
7 include $(RTE_SDK)/mk/internal/rte.build-pre.mk
8
9 EXTLIB_BUILD ?= n
10
11 # VPATH contains at least SRCDIR
12 VPATH += $(SRCDIR)
13
14 ifneq ($(CONFIG_RTE_MAJOR_ABI),)
15 ifneq ($(LIBABIVER),)
16 LIBABIVER := $(CONFIG_RTE_MAJOR_ABI)
17 endif
18 endif
19
20 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
21 LIB := $(patsubst %.a,%.so.$(LIBABIVER),$(LIB))
22 ifeq ($(EXTLIB_BUILD),n)
23 ifeq ($(CONFIG_RTE_MAJOR_ABI),)
24 ifeq ($(CONFIG_RTE_NEXT_ABI),y)
25 LIB := $(LIB).1
26 endif
27 endif
28 CPU_LDFLAGS += --version-script=$(SRCDIR)/$(EXPORT_MAP)
29 endif
30 endif
31
32
33 _BUILD = $(LIB)
34 PREINSTALL = $(SYMLINK-FILES-y)
35 _INSTALL = $(INSTALL-FILES-y) $(RTE_OUTPUT)/lib/$(LIB)
36 _CLEAN = doclean
37
38 LDLIBS += $(EXECENV_LDLIBS-y)
39
40 .PHONY: all
41 all: install
42
43 .PHONY: install
44 ifeq ($(SYMLINK-FILES-y),)
45 install: build _postinstall
46 else
47 install: _preinstall build _postinstall
48 build: _preinstall
49 endif
50
51 _postinstall: build
52
53 .PHONY: build
54 build: _postbuild
55
56 exe2cmd = $(strip $(call dotfile,$(patsubst %,%.cmd,$(1))))
57
58 ifeq ($(LINK_USING_CC),1)
59 # Override the definition of LD here, since we're linking with CC
60 LD := $(CC) $(CPU_CFLAGS) $(EXTRA_CFLAGS)
61 _CPU_LDFLAGS := $(call linkerprefix,$(CPU_LDFLAGS))
62 override EXTRA_LDFLAGS := $(call linkerprefix,$(EXTRA_LDFLAGS))
63 else
64 _CPU_LDFLAGS := $(CPU_LDFLAGS)
65 endif
66
67 O_TO_A = $(AR) crDs $(LIB) $(OBJS-y)
68 O_TO_A_STR = $(subst ','\'',$(O_TO_A)) #'# fix syntax highlight
69 O_TO_A_DISP = $(if $(V),"$(O_TO_A_STR)","  AR $(@)")
70 O_TO_A_CMD = "cmd_$@ = $(O_TO_A_STR)"
71 O_TO_A_DO = @set -e; \
72         echo $(O_TO_A_DISP); \
73         $(O_TO_A) && \
74         echo $(O_TO_A_CMD) > $(call exe2cmd,$(@))
75
76 ifneq ($(CC_SUPPORTS_Z),false)
77 NO_UNDEFINED := -z defs
78 endif
79
80 O_TO_S = $(LD) -L$(RTE_SDK_BIN)/lib $(_CPU_LDFLAGS) $(EXTRA_LDFLAGS) \
81           -shared $(OBJS-y) $(NO_UNDEFINED) $(LDLIBS) -Wl,-soname,$(LIB) -o $(LIB)
82 O_TO_S_STR = $(subst ','\'',$(O_TO_S)) #'# fix syntax highlight
83 O_TO_S_DISP = $(if $(V),"$(O_TO_S_STR)","  LD $(@)")
84 O_TO_S_DO = @set -e; \
85         echo $(O_TO_S_DISP); \
86         $(O_TO_S) && \
87         echo $(O_TO_S_CMD) > $(call exe2cmd,$(@))
88
89 -include .$(LIB).cmd
90
91 #
92 # Archive objects in .a file if needed
93 #
94 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
95 $(LIB): $(OBJS-y) $(DEP_$(LIB)) FORCE
96 ifeq ($(LIBABIVER),)
97         @echo "Must Specify a $(LIB) ABI version"
98         @false
99 endif
100         @[ -d $(dir $@) ] || mkdir -p $(dir $@)
101         $(if $(D),\
102                 @echo -n "$< -> $@ " ; \
103                 echo -n "file_missing=$(call boolean,$(file_missing)) " ; \
104                 echo -n "cmdline_changed=$(call boolean,$(call cmdline_changed,$(O_TO_S_STR))) " ; \
105                 echo -n "depfile_missing=$(call boolean,$(depfile_missing)) " ; \
106                 echo "depfile_newer=$(call boolean,$(depfile_newer)) ")
107         $(if $(or \
108                 $(file_missing),\
109                 $(call cmdline_changed,$(O_TO_S_STR)),\
110                 $(depfile_missing),\
111                 $(depfile_newer)),\
112                 $(O_TO_S_DO))
113
114 else
115 $(LIB): $(OBJS-y) $(DEP_$(LIB)) FORCE
116         @[ -d $(dir $@) ] || mkdir -p $(dir $@)
117         $(if $(D),\
118             @echo -n "$< -> $@ " ; \
119             echo -n "file_missing=$(call boolean,$(file_missing)) " ; \
120             echo -n "cmdline_changed=$(call boolean,$(call cmdline_changed,$(O_TO_A_STR))) " ; \
121             echo -n "depfile_missing=$(call boolean,$(depfile_missing)) " ; \
122             echo "depfile_newer=$(call boolean,$(depfile_newer)) ")
123         $(if $(or \
124             $(file_missing),\
125             $(call cmdline_changed,$(O_TO_A_STR)),\
126             $(depfile_missing),\
127             $(depfile_newer)),\
128             $(O_TO_A_DO))
129 endif
130
131 #
132 # install lib in $(RTE_OUTPUT)/lib
133 #
134 $(RTE_OUTPUT)/lib/$(LIB): $(LIB)
135         @echo "  INSTALL-LIB $(LIB)"
136         @[ -d $(RTE_OUTPUT)/lib ] || mkdir -p $(RTE_OUTPUT)/lib
137         $(Q)cp -f $(LIB) $(RTE_OUTPUT)/lib
138 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),y)
139         $(Q)ln -s -f $< $(shell echo $@ | sed 's/\.so.*/.so/')
140 endif
141
142 #
143 # Clean all generated files
144 #
145 .PHONY: clean
146 clean: _postclean
147
148 .PHONY: doclean
149 doclean:
150         $(Q)rm -rf $(LIB) $(OBJS-all) $(DEPS-all) $(DEPSTMP-all) \
151           $(CMDS-all) .$(LIB).cmd $(INSTALL-FILES-all) *.pmd.c *.pmd.o
152         $(Q)rm -f $(_BUILD_TARGETS) $(_INSTALL_TARGETS) $(_CLEAN_TARGETS)
153
154 include $(RTE_SDK)/mk/internal/rte.compile-post.mk
155 include $(RTE_SDK)/mk/internal/rte.install-post.mk
156 include $(RTE_SDK)/mk/internal/rte.clean-post.mk
157 include $(RTE_SDK)/mk/internal/rte.build-post.mk
158
159 .PHONY: FORCE
160 FORCE: