doc: add generic build instructions for sample apps
[dpdk.git] / mk / rte.sdkbuild.mk
1 #   BSD LICENSE
2 #
3 #   Copyright(c) 2010-2015 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 #
33 # include rte.vars.mk if config file exists
34 #
35 ifeq (,$(wildcard $(RTE_OUTPUT)/.config))
36   $(error "need a make config first")
37 else
38   include $(RTE_SDK)/mk/rte.vars.mk
39 endif
40
41 # allow exec-env specific targets
42 -include $(RTE_SDK)/mk/exec-env/$(RTE_EXEC_ENV)/rte.custom.mk
43
44 buildtools: | lib
45 drivers: | lib buildtools
46 app: | lib buildtools drivers
47 test: | lib buildtools drivers
48
49 #
50 # build and clean targets
51 #
52
53 CLEANDIRS = $(addsuffix _clean,$(ROOTDIRS-y) $(ROOTDIRS-n) $(ROOTDIRS-))
54
55 .PHONY: build
56 build: $(ROOTDIRS-y)
57         @echo "Build complete [$(RTE_TARGET)]"
58
59 .PHONY: clean
60 clean: $(CLEANDIRS)
61         @rm -rf $(RTE_OUTPUT)/include $(RTE_OUTPUT)/app \
62                 $(RTE_OUTPUT)/lib \
63                 $(RTE_OUTPUT)/hostlib $(RTE_OUTPUT)/kmod
64         @[ -d $(RTE_OUTPUT)/include ] || mkdir -p $(RTE_OUTPUT)/include
65         @$(RTE_SDK)/buildtools/gen-config-h.sh $(RTE_OUTPUT)/.config \
66                 > $(RTE_OUTPUT)/include/rte_config.h
67         $(Q)$(MAKE) -f $(RTE_SDK)/GNUmakefile gcovclean
68         @echo Clean complete
69
70 .PHONY: test-build
71 test-build: test
72
73 .SECONDEXPANSION:
74 .PHONY: $(ROOTDIRS-y) $(ROOTDIRS-)
75 $(ROOTDIRS-y) $(ROOTDIRS-):
76         @[ -d $(BUILDDIR)/$@ ] || mkdir -p $(BUILDDIR)/$@
77         @echo "== Build $@"
78         $(Q)$(MAKE) S=$@ -f $(RTE_SRCDIR)/$@/Makefile -C $(BUILDDIR)/$@ all
79         @if [ $@ = drivers ]; then \
80                 $(MAKE) -f $(RTE_SDK)/mk/rte.combinedlib.mk; \
81         fi
82
83 %_clean:
84         @echo "== Clean $*"
85         $(Q)if [ -f $(RTE_SRCDIR)/$*/Makefile -a -d $(BUILDDIR)/$* ]; then \
86                 $(MAKE) S=$* -f $(RTE_SRCDIR)/$*/Makefile -C $(BUILDDIR)/$* clean ; \
87         fi
88
89 RTE_MAKE_SUBTARGET ?= all
90
91 %_sub: $(addsuffix _sub,$(*))
92         @echo $(addsuffix _sub,$(*))
93         @[ -d $(BUILDDIR)/$* ] || mkdir -p $(BUILDDIR)/$*
94         @echo "== Build $*"
95         $(Q)$(MAKE) S=$* -f $(RTE_SRCDIR)/$*/Makefile -C $(BUILDDIR)/$* \
96                 $(RTE_MAKE_SUBTARGET)
97
98 .PHONY: all
99 all: build
100
101 .PHONY: FORCE
102 FORCE: