doc: fix spelling in bonding guide
[dpdk.git] / mk / rte.app.mk
1 #   BSD LICENSE
2 #
3 #   Copyright(c) 2010-2015 Intel Corporation. All rights reserved.
4 #   Copyright(c) 2014-2015 6WIND S.A.
5 #   All rights reserved.
6 #
7 #   Redistribution and use in source and binary forms, with or without
8 #   modification, are permitted provided that the following conditions
9 #   are met:
10 #
11 #     * Redistributions of source code must retain the above copyright
12 #       notice, this list of conditions and the following disclaimer.
13 #     * Redistributions in binary form must reproduce the above copyright
14 #       notice, this list of conditions and the following disclaimer in
15 #       the documentation and/or other materials provided with the
16 #       distribution.
17 #     * Neither the name of Intel Corporation nor the names of its
18 #       contributors may be used to endorse or promote products derived
19 #       from this software without specific prior written permission.
20 #
21 #   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22 #   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23 #   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24 #   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25 #   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26 #   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27 #   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 #   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 #   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 #   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31 #   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32
33 include $(RTE_SDK)/mk/internal/rte.compile-pre.mk
34 include $(RTE_SDK)/mk/internal/rte.install-pre.mk
35 include $(RTE_SDK)/mk/internal/rte.clean-pre.mk
36 include $(RTE_SDK)/mk/internal/rte.build-pre.mk
37 include $(RTE_SDK)/mk/internal/rte.depdirs-pre.mk
38
39 # VPATH contains at least SRCDIR
40 VPATH += $(SRCDIR)
41
42 _BUILD = $(APP)
43 _INSTALL = $(INSTALL-FILES-y) $(SYMLINK-FILES-y)
44 _INSTALL += $(RTE_OUTPUT)/app/$(APP) $(RTE_OUTPUT)/app/$(APP).map
45 POSTINSTALL += target-appinstall
46 _CLEAN = doclean
47 POSTCLEAN += target-appclean
48
49 ifeq ($(NO_LDSCRIPT),)
50 LDSCRIPT = $(RTE_LDSCRIPT)
51 endif
52
53 # default path for libs
54 _LDLIBS-y += -L$(RTE_SDK_BIN)/lib
55
56 #
57 # Order is important: from higher level to lower level
58 #
59
60 _LDLIBS-y += --whole-archive
61
62 _LDLIBS-$(CONFIG_RTE_BUILD_COMBINE_LIBS)    += -l$(RTE_LIBNAME)
63
64 ifeq ($(CONFIG_RTE_BUILD_COMBINE_LIBS),n)
65
66 _LDLIBS-$(CONFIG_RTE_LIBRTE_DISTRIBUTOR)    += -lrte_distributor
67 _LDLIBS-$(CONFIG_RTE_LIBRTE_REORDER)        += -lrte_reorder
68
69 ifeq ($(CONFIG_RTE_EXEC_ENV_LINUXAPP),y)
70 _LDLIBS-$(CONFIG_RTE_LIBRTE_KNI)            += -lrte_kni
71 _LDLIBS-$(CONFIG_RTE_LIBRTE_IVSHMEM)        += -lrte_ivshmem
72 endif
73
74 _LDLIBS-$(CONFIG_RTE_LIBRTE_PIPELINE)       += -lrte_pipeline
75 _LDLIBS-$(CONFIG_RTE_LIBRTE_TABLE)          += -lrte_table
76 _LDLIBS-$(CONFIG_RTE_LIBRTE_PORT)           += -lrte_port
77 _LDLIBS-$(CONFIG_RTE_LIBRTE_TIMER)          += -lrte_timer
78 _LDLIBS-$(CONFIG_RTE_LIBRTE_HASH)           += -lrte_hash
79 _LDLIBS-$(CONFIG_RTE_LIBRTE_JOBSTATS)       += -lrte_jobstats
80 _LDLIBS-$(CONFIG_RTE_LIBRTE_LPM)            += -lrte_lpm
81 _LDLIBS-$(CONFIG_RTE_LIBRTE_POWER)          += -lrte_power
82 _LDLIBS-$(CONFIG_RTE_LIBRTE_ACL)            += -lrte_acl
83 _LDLIBS-$(CONFIG_RTE_LIBRTE_METER)          += -lrte_meter
84
85 _LDLIBS-$(CONFIG_RTE_LIBRTE_SCHED)          += -lrte_sched
86 _LDLIBS-$(CONFIG_RTE_LIBRTE_SCHED)          += -lm
87 _LDLIBS-$(CONFIG_RTE_LIBRTE_SCHED)          += -lrt
88
89 _LDLIBS-$(CONFIG_RTE_LIBRTE_VHOST)          += -lrte_vhost
90
91 endif # ! CONFIG_RTE_BUILD_COMBINE_LIBS
92
93 _LDLIBS-$(CONFIG_RTE_LIBRTE_PMD_PCAP)       += -lpcap
94
95 ifeq ($(CONFIG_RTE_LIBRTE_VHOST_NUMA),y)
96 _LDLIBS-$(CONFIG_RTE_LIBRTE_VHOST)          += -lnuma
97 endif
98
99 ifeq ($(CONFIG_RTE_LIBRTE_VHOST_USER),n)
100 _LDLIBS-$(CONFIG_RTE_LIBRTE_VHOST)          += -lfuse
101 endif
102
103 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),n)
104 _LDLIBS-$(CONFIG_RTE_LIBRTE_MLX4_PMD)       += -libverbs
105 endif # ! CONFIG_RTE_BUILD_SHARED_LIBS
106
107 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),n)
108 _LDLIBS-$(CONFIG_RTE_LIBRTE_MLX5_PMD)       += -libverbs
109 endif # ! CONFIG_RTE_BUILD_SHARED_LIBS
110
111 _LDLIBS-$(CONFIG_RTE_LIBRTE_BNX2X_PMD)      += -lz
112
113 _LDLIBS-y += --start-group
114
115 ifeq ($(CONFIG_RTE_BUILD_COMBINE_LIBS),n)
116
117 _LDLIBS-$(CONFIG_RTE_LIBRTE_KVARGS)         += -lrte_kvargs
118 _LDLIBS-$(CONFIG_RTE_LIBRTE_MBUF)           += -lrte_mbuf
119 _LDLIBS-$(CONFIG_RTE_LIBRTE_IP_FRAG)        += -lrte_ip_frag
120 _LDLIBS-$(CONFIG_RTE_LIBRTE_ETHER)          += -lethdev
121 _LDLIBS-$(CONFIG_RTE_LIBRTE_MEMPOOL)        += -lrte_mempool
122 _LDLIBS-$(CONFIG_RTE_LIBRTE_RING)           += -lrte_ring
123 _LDLIBS-$(CONFIG_RTE_LIBRTE_EAL)            += -lrte_eal
124 _LDLIBS-$(CONFIG_RTE_LIBRTE_CMDLINE)        += -lrte_cmdline
125 _LDLIBS-$(CONFIG_RTE_LIBRTE_CFGFILE)        += -lrte_cfgfile
126 _LDLIBS-$(CONFIG_RTE_LIBRTE_PMD_BOND)       += -lrte_pmd_bond
127
128 _LDLIBS-$(CONFIG_RTE_LIBRTE_PMD_XENVIRT)    += -lrte_pmd_xenvirt
129 _LDLIBS-$(CONFIG_RTE_LIBRTE_PMD_XENVIRT)    += -lxenstore
130
131 ifeq ($(CONFIG_RTE_BUILD_SHARED_LIB),n)
132 # plugins (link only if static libraries)
133
134 _LDLIBS-$(CONFIG_RTE_LIBRTE_VMXNET3_PMD)    += -lrte_pmd_vmxnet3_uio
135 _LDLIBS-$(CONFIG_RTE_LIBRTE_VIRTIO_PMD)     += -lrte_pmd_virtio
136 _LDLIBS-$(CONFIG_RTE_LIBRTE_BNX2X_PMD)      += -lrte_pmd_bnx2x
137 _LDLIBS-$(CONFIG_RTE_LIBRTE_CXGBE_PMD)      += -lrte_pmd_cxgbe
138 _LDLIBS-$(CONFIG_RTE_LIBRTE_ENIC_PMD)       += -lrte_pmd_enic
139 _LDLIBS-$(CONFIG_RTE_LIBRTE_I40E_PMD)       += -lrte_pmd_i40e
140 _LDLIBS-$(CONFIG_RTE_LIBRTE_FM10K_PMD)      += -lrte_pmd_fm10k
141 _LDLIBS-$(CONFIG_RTE_LIBRTE_IXGBE_PMD)      += -lrte_pmd_ixgbe
142 _LDLIBS-$(CONFIG_RTE_LIBRTE_E1000_PMD)      += -lrte_pmd_e1000
143 _LDLIBS-$(CONFIG_RTE_LIBRTE_MLX4_PMD)       += -lrte_pmd_mlx4
144 _LDLIBS-$(CONFIG_RTE_LIBRTE_MLX5_PMD)       += -lrte_pmd_mlx5
145 _LDLIBS-$(CONFIG_RTE_LIBRTE_MPIPE_PMD)      += -lrte_pmd_mpipe -lgxio
146 _LDLIBS-$(CONFIG_RTE_LIBRTE_PMD_RING)       += -lrte_pmd_ring
147 _LDLIBS-$(CONFIG_RTE_LIBRTE_PMD_PCAP)       += -lrte_pmd_pcap
148 _LDLIBS-$(CONFIG_RTE_LIBRTE_PMD_AF_PACKET)  += -lrte_pmd_af_packet
149 _LDLIBS-$(CONFIG_RTE_LIBRTE_PMD_NULL)       += -lrte_pmd_null
150
151 endif # ! $(CONFIG_RTE_BUILD_SHARED_LIB)
152
153 endif # ! CONFIG_RTE_BUILD_COMBINE_LIBS
154
155 _LDLIBS-y += $(EXECENV_LDLIBS)
156 _LDLIBS-y += --end-group
157 _LDLIBS-y += --no-whole-archive
158
159 LDLIBS += $(_LDLIBS-y) $(CPU_LDLIBS) $(EXTRA_LDLIBS)
160
161 .PHONY: all
162 all: install
163
164 .PHONY: install
165 install: build _postinstall
166
167 _postinstall: build
168
169 .PHONY: build
170 build: _postbuild
171
172 exe2cmd = $(strip $(call dotfile,$(patsubst %,%.cmd,$(1))))
173
174 ifeq ($(LINK_USING_CC),1)
175 override EXTRA_LDFLAGS := $(call linkerprefix,$(EXTRA_LDFLAGS))
176 O_TO_EXE = $(CC) $(CFLAGS) $(LDFLAGS_$(@)) \
177         -Wl,-Map=$(@).map,--cref -o $@ $(OBJS-y) $(call linkerprefix,$(LDFLAGS)) \
178         $(EXTRA_LDFLAGS) $(call linkerprefix,$(LDLIBS))
179 else
180 O_TO_EXE = $(LD) $(LDFLAGS) $(LDFLAGS_$(@)) $(EXTRA_LDFLAGS) \
181         -Map=$(@).map --cref -o $@ $(OBJS-y) $(LDLIBS)
182 endif
183 O_TO_EXE_STR = $(subst ','\'',$(O_TO_EXE)) #'# fix syntax highlight
184 O_TO_EXE_DISP = $(if $(V),"$(O_TO_EXE_STR)","  LD $(@)")
185 O_TO_EXE_CMD = "cmd_$@ = $(O_TO_EXE_STR)"
186 O_TO_EXE_DO = @set -e; \
187         echo $(O_TO_EXE_DISP); \
188         $(O_TO_EXE) && \
189         echo $(O_TO_EXE_CMD) > $(call exe2cmd,$(@))
190
191 -include .$(APP).cmd
192
193 # path where libraries are retrieved
194 LDLIBS_PATH := $(subst -Wl$(comma)-L,,$(filter -Wl$(comma)-L%,$(LDLIBS)))
195 LDLIBS_PATH += $(subst -L,,$(filter -L%,$(LDLIBS)))
196
197 # list of .a files that are linked to this application
198 LDLIBS_NAMES := $(patsubst -l%,lib%.a,$(filter -l%,$(LDLIBS)))
199 LDLIBS_NAMES += $(patsubst -Wl$(comma)-l%,lib%.a,$(filter -Wl$(comma)-l%,$(LDLIBS)))
200
201 # list of found libraries files (useful for deps). If not found, the
202 # library is silently ignored and dep won't be checked
203 LDLIBS_FILES := $(wildcard $(foreach dir,$(LDLIBS_PATH),\
204         $(addprefix $(dir)/,$(LDLIBS_NAMES))))
205
206 #
207 # Compile executable file if needed
208 #
209 $(APP): $(OBJS-y) $(LDLIBS_FILES) $(DEP_$(APP)) $(LDSCRIPT) FORCE
210         @[ -d $(dir $@) ] || mkdir -p $(dir $@)
211         $(if $(D),\
212                 @echo -n "$< -> $@ " ; \
213                 echo -n "file_missing=$(call boolean,$(file_missing)) " ; \
214                 echo -n "cmdline_changed=$(call boolean,$(call cmdline_changed,$(O_TO_EXE_STR))) " ; \
215                 echo -n "depfile_missing=$(call boolean,$(depfile_missing)) " ; \
216                 echo "depfile_newer=$(call boolean,$(depfile_newer)) ")
217         $(if $(or \
218                 $(file_missing),\
219                 $(call cmdline_changed,$(O_TO_EXE_STR)),\
220                 $(depfile_missing),\
221                 $(depfile_newer)),\
222                 $(O_TO_EXE_DO))
223
224 #
225 # install app in $(RTE_OUTPUT)/app
226 #
227 $(RTE_OUTPUT)/app/$(APP): $(APP)
228         @echo "  INSTALL-APP $(APP)"
229         @[ -d $(RTE_OUTPUT)/app ] || mkdir -p $(RTE_OUTPUT)/app
230         $(Q)cp -f $(APP) $(RTE_OUTPUT)/app
231
232 #
233 # install app map file in $(RTE_OUTPUT)/app
234 #
235 $(RTE_OUTPUT)/app/$(APP).map: $(APP)
236         @echo "  INSTALL-MAP $(APP).map"
237         @[ -d $(RTE_OUTPUT)/app ] || mkdir -p $(RTE_OUTPUT)/app
238         $(Q)cp -f $(APP).map $(RTE_OUTPUT)/app
239
240 #
241 # Clean all generated files
242 #
243 .PHONY: clean
244 clean: _postclean
245         $(Q)rm -f $(_BUILD_TARGETS) $(_INSTALL_TARGETS) $(_CLEAN_TARGETS)
246
247 .PHONY: doclean
248 doclean:
249         $(Q)rm -rf $(APP) $(OBJS-all) $(DEPS-all) $(DEPSTMP-all) \
250           $(CMDS-all) $(INSTALL-FILES-all) .$(APP).cmd
251
252
253 include $(RTE_SDK)/mk/internal/rte.compile-post.mk
254 include $(RTE_SDK)/mk/internal/rte.install-post.mk
255 include $(RTE_SDK)/mk/internal/rte.clean-post.mk
256 include $(RTE_SDK)/mk/internal/rte.build-post.mk
257 include $(RTE_SDK)/mk/internal/rte.depdirs-post.mk
258
259 ifneq ($(wildcard $(RTE_SDK)/mk/target/$(RTE_TARGET)/rte.app.mk),)
260 include $(RTE_SDK)/mk/target/$(RTE_TARGET)/rte.app.mk
261 else
262 include $(RTE_SDK)/mk/target/generic/rte.app.mk
263 endif
264
265 .PHONY: FORCE
266 FORCE: