"make help" should not build the configurator first.
[oweals/busybox.git] / Makefile
1 # Makefile for busybox
2 #
3 # Copyright (C) 1999-2004 by Erik Andersen <andersen@codepoet.org>
4 #
5 # Licensed under GPLv2, see the file LICENSE in this tarball for details.
6 #
7
8 #--------------------------------------------------------------
9 # You shouldn't need to mess with anything beyond this point...
10 #--------------------------------------------------------------
11 noconfig_targets := menuconfig config oldconfig randconfig \
12         defconfig allyesconfig allnoconfig allbareconfig \
13         clean distclean help \
14         release tags
15
16 # the toplevel sourcedir
17 ifndef top_srcdir
18 # make-3.79.1 didn't support MAKEFILE_LIST
19 # for building out-of-tree, users of make-3.79.1 still have to pass top_srcdir=
20 # to make: make -f /srcs/busybox/Makefile top_srcdir=/srcs/busybox
21 ifdef MAKEFILE_LIST
22 top_srcdir:=$(shell cd $(dir $(firstword $(MAKEFILE_LIST))) && pwd)
23 else
24 top_srcdir:=$(CURDIR)
25 endif
26 endif
27 # toplevel directory of the object-tree
28 ifndef top_builddir
29 top_builddir:=$(CURDIR)
30 endif
31
32 export srctree=$(top_srcdir)
33 vpath %/Config.in $(srctree)
34
35 DIRS:=applets archival archival/libunarchive coreutils console-tools \
36         debianutils editors findutils init miscutils modutils networking \
37         networking/libiproute networking/udhcp procps loginutils shell \
38         sysklogd util-linux e2fsprogs libpwdgrp coreutils/libcoreutils libbb
39
40 SRC_DIRS:=$(patsubst %,$(top_srcdir)/%,$(DIRS))
41
42 # That's our default target when none is given on the command line
43 .PHONY: _all
44
45 _all: all
46
47 # see if we are in verbose mode
48 ifdef VERBOSE
49   CHECK_VERBOSE := -v
50   PACKAGE_BE_VERBOSE := $(VERBOSE)
51 endif
52 ifdef V
53   CHECK_VERBOSE := -v
54   PACKAGE_BE_VERBOSE := $(V)
55 endif
56
57 ifdef O
58   ifeq ("$(origin O)", "command line")
59     PACKAGE_OUTPUTDIR := $(shell cd $(O) && pwd)
60     top_builddir := $(PACKAGE_OUTPUTDIR)
61   endif
62 else
63 # If no alternate output-dir was specified, we build in cwd
64   PACKAGE_OUTPUTDIR := $(top_builddir)
65 endif
66
67 define check_gcc
68 $(if $(2),$(if $(shell $(CC) $(2) -S -o /dev/null -xc /dev/null > /dev/null 2>&1 && echo y),$(2),$(if $(3),$(3))),$(if $(3),$(3)))
69 endef
70
71 define check_ld
72 $(if $(2),$(if $(shell $(LD) $(2) -o /dev/null -b binary /dev/null > /dev/null 2>&1 && echo y),$(shell echo \-Wl,$(2)),$(if $(3),$(3))),$(if $(3),$(3)))
73 endef
74
75 #######################################################################
76 # make-3.79.1 doesn't support order-only prerequisites..
77 ifeq ($(MAKE_VERSION),3.79.1)
78 |: $(^) ;
79 endif
80 #######################################################################
81
82
83
84 # Handle building out of tree
85 ifneq ($(top_builddir),$(top_srcdir))
86 all_tree := $(patsubst %,$(top_builddir)/%,$(DIRS) scripts scripts/config include include/config)
87 $(all_tree):
88         @mkdir -p "$@"
89
90 saved-output := $(PACKAGE_OUTPUTDIR)
91
92 $(if $(wildcard $(PACKAGE_OUTPUTDIR)),, \
93      $(error output directory "$(saved-output)" does not exist))
94
95 .PHONY: $(filter $(noconfig_targets),$(MAKECMDGOALS))
96
97 $(PACKAGE_OUTPUTDIR)/Rules.mak:
98         @echo > $@
99         @echo top_srcdir=$(top_srcdir) >> $@
100         @echo top_builddir=$(PACKAGE_OUTPUTDIR) >> $@
101         @echo include $$\(top_srcdir\)/Rules.mak >> $@
102
103 $(PACKAGE_OUTPUTDIR)/Makefile:
104         @echo > $@
105         @echo top_srcdir=$(top_srcdir) >> $@
106         @echo top_builddir=$(PACKAGE_OUTPUTDIR) >> $@
107         @echo PACKAGE_SOURCEDIR='$$(top_srcdir)' >> $@
108         @echo include '$$(PACKAGE_SOURCEDIR)'/Makefile >> $@
109
110
111 buildtree := $(all_tree) $(PACKAGE_OUTPUTDIR)/Rules.mak $(PACKAGE_OUTPUTDIR)/Makefile
112
113 # We only need a copy of the Makefile for the config targets and reuse
114 # the rest from the source directory, i.e. we do not cp ALL_MAKEFILES.
115 scripts/config/Makefile: $(top_srcdir)/scripts/config/Makefile | $(buildtree)
116         @cp $(top_srcdir)/scripts/config/Makefile $@
117
118 else
119 all_tree := include/config
120 $(all_tree):
121         @mkdir -p "$@"
122 buildtree := $(all_tree)
123 endif # ifneq ($(PACKAGE_OUTPUTDIR),$(top_srcdir))
124
125 help:
126         @echo 'Cleaning:'
127         @echo '  clean                  - delete temporary files created by build'
128         @echo '  distclean              - delete all non-source files (including .config)'
129         @echo
130         @echo 'Build:'
131         @echo '  all                    - Executable and documentation'
132         @echo '  busybox                - the swiss-army executable'
133         @echo '  doc                    - docs/BusyBox.{txt,html,1}'
134         @echo
135         @echo 'Configuration:'
136         @echo '  allnoconfig            - disable all symbols in .config'
137         @echo '  allyesconfig           - enable all symbols in .config (see defconfig)'
138         @echo '  allbareconfig          - enable all applets without any sub-features'
139         @echo '  config         - text based configurator (of last resort)'
140         @echo '  defconfig              - set .config to largest generic configuration'
141         @echo '  menuconfig             - interactive curses-based configurator'
142         @echo '  oldconfig              - resolve any unresolved symbols in .config'
143         @echo
144         @echo 'Installation:'
145         @echo '  install                - install busybox into $prefix'
146         @echo '  uninstall'
147         @echo
148         @echo 'Development:'
149         @echo '  check                  - run the test suite for all applets'
150         @echo '  randconfig             - generate a random configuration'
151         @echo '  release                - create a distribution tarball'
152         @echo '  sizes                  - show size of all enabled busybox symbols'
153         @echo
154         @echo 'Make flags:'
155         @echo '  V=<number>             - print verbose make output (default: unset)'
156         @echo '                           0 print CC invocations'
157         @echo '                           1'
158         @echo '                           2 also print when make enters a directory'
159         @echo '                           3 also verbosely print shell invocations'
160
161 -include $(top_srcdir)/Rules.mak
162
163 ifneq ($(strip $(HAVE_DOT_CONFIG)),y)
164 # Default target if none was requested explicitly
165 all: menuconfig ;
166
167 ifneq ($(filter-out $(noconfig_targets),$(MAKECMDGOALS)),)
168 # warn if no configuration exists and we are asked to build a non-config target
169 .config:
170         @echo ""
171         @echo "No $(top_builddir)/$@ found!"
172         @echo "Please refer to 'make help', section Configuration."
173         @echo ""
174         @exit 1
175 else
176 # Avoid implicit rule to kick in by using an empty command
177 .config: $(buildtree) ;
178 endif
179 endif # ifneq ($(strip $(HAVE_DOT_CONFIG)),y)
180
181
182 # configuration
183 # ---------------------------------------------------------------------------
184
185 CONFIG_CONFIG_IN = $(top_srcdir)/Config.in
186
187 scripts/config/conf: scripts/config/Makefile
188         $(Q)$(MAKE) -C scripts/config conf
189
190 scripts/config/mconf: scripts/config/Makefile
191         $(Q)$(MAKE) -C scripts/config ncurses conf mconf
192
193 menuconfig: scripts/config/mconf
194         @[ -f .config ] || make $(MAKEFLAGS) defconfig
195         @./scripts/config/mconf $(CONFIG_CONFIG_IN)
196
197 config: scripts/config/conf
198         @./scripts/config/conf $(CONFIG_CONFIG_IN)
199
200 oldconfig: scripts/config/conf
201         @./scripts/config/conf -o $(CONFIG_CONFIG_IN)
202
203 randconfig: scripts/config/conf
204         @./scripts/config/conf -r $(CONFIG_CONFIG_IN)
205
206 allyesconfig: scripts/config/conf
207         @./scripts/config/conf -y $(CONFIG_CONFIG_IN)
208         @$(SED) -i -r -e "s/^(USING_CROSS_COMPILER)=.*/# \1 is not set/" .config
209         @./scripts/config/conf -o $(CONFIG_CONFIG_IN)
210
211 allnoconfig: scripts/config/conf
212         @./scripts/config/conf -n $(CONFIG_CONFIG_IN)
213
214 # defconfig is allyesconfig minus any features that are specialized enough
215 # or cause enough behavior change that the user really should switch them on
216 # manually if that's what they want.  Sort of "maximum sane config".
217
218 defconfig: scripts/config/conf
219         @./scripts/config/conf -y $(CONFIG_CONFIG_IN)
220         @$(SED) -i -r -e "s/^(USING_CROSS_COMPILER|CONFIG_(DEBUG.*|STATIC|SELINUX|BUILD_(AT_ONCE|LIBBUSYBOX)|FEATURE_(DEVFS|FULL_LIBBUSYBOX|SHARED_BUSYBOX|MTAB_SUPPORT|CLEAN_UP|UDHCP_DEBUG)|INSTALL_NO_USR))=.*/# \1 is not set/" .config
221         @./scripts/config/conf -o $(CONFIG_CONFIG_IN)
222
223 allbareconfig: scripts/config/conf
224         @./scripts/config/conf -y $(CONFIG_CONFIG_IN)
225         @$(SED) -i -r -e "s/^(USING_CROSS_COMPILER|CONFIG_(DEBUG|STATIC|SELINUX|DEVFSD|NC_GAPING_SECURITY_HOLE|BUILD_AT_ONCE)).*/# \1 is not set/" .config
226         @$(SED) -i -e "/FEATURE/s/=.*//;/^[^#]/s/.*FEATURE.*/# \0 is not set/;" .config
227         @echo "CONFIG_FEATURE_BUFFERS_GO_ON_STACK=y" >> .config
228         @./scripts/config/conf -o $(CONFIG_CONFIG_IN)
229
230 ifeq ($(strip $(HAVE_DOT_CONFIG)),y)
231
232 # Load all Config.in
233 -include $(top_builddir)/.config.cmd
234
235 endif # ifeq ($(strip $(HAVE_DOT_CONFIG)),y)
236
237 include $(patsubst %,%/Makefile.in,$(SRC_DIRS))
238
239 ifeq ($(strip $(HAVE_DOT_CONFIG)),y)
240 # Finally pull in the dependencies (headers and other includes) of the
241 # individual object files
242 -include $(top_builddir)/.depend
243
244 $(top_builddir)/applets/applets.o: $(top_builddir)/.config
245 # Everything is set.
246
247 all: busybox busybox.links doc ;
248
249 # Two modes of operation: legacy and IMA
250 # Legacy mode builds each object through an individual invocation of CC
251 # IMA compiles all sources at once (aka IPO aka IPA etc.)
252
253 ifeq ($(strip $(CONFIG_BUILD_AT_ONCE)),y)
254 libraries-y:=
255 # Which parts of the internal libs are requested?
256 # Per default we only want what was actually selected.
257 # -a denotes all while -y denotes the selected ones.
258 ifeq ($(strip $(CONFIG_FEATURE_FULL_LIBBUSYBOX)),y)
259 LIBRARY_DEFINE:=$(LIBRARY_DEFINE-a)
260 LIBRARY_SRC   :=$(LIBRARY_SRC-a)
261 else # CONFIG_FEATURE_FULL_LIBBUSYBOX
262 LIBRARY_DEFINE:=$(LIBRARY_DEFINE-y)
263 LIBRARY_SRC   :=$(LIBRARY_SRC-y)
264 endif # CONFIG_FEATURE_FULL_LIBBUSYBOX
265 APPLET_SRC:=$(APPLET_SRC-y)
266 APPLETS_DEFINE:=$(APPLETS_DEFINE-y)
267 else  # CONFIG_BUILD_AT_ONCE
268 # no --combine, build archives out of the individual .o
269 # This was the old way the binary was built.
270 libbusybox-obj:=archival/libunarchive/libunarchive.a \
271         networking/libiproute/libiproute.a \
272         libpwdgrp/libpwdgrp.a coreutils/libcoreutils/libcoreutils.a \
273         libbb/libbb.a
274 libbusybox-obj:=$(patsubst %,$(top_builddir)/%,$(libbusybox-obj))
275 ifeq ($(strip $(CONFIG_FEATURE_SHARED_BUSYBOX)),y)
276 # linking against libbusybox, so don't build the .a already contained in the .so
277 libraries-y:=$(filter-out $(libbusybox-obj),$(libraries-y))
278 endif # CONFIG_FEATURE_SHARED_BUSYBOX
279
280 endif # CONFIG_BUILD_AT_ONCE
281
282 ifeq ($(strip $(CONFIG_BUILD_LIBBUSYBOX)),y)
283 LD_LIBBUSYBOX:=libbusybox.so
284 LIBBUSYBOX_SONAME:=$(LD_LIBBUSYBOX).$(MAJOR_VERSION).$(MINOR_VERSION).$(SUBLEVEL_VERSION)
285 DO_INSTALL_LIBS:=$(LD_LIBBUSYBOX) \
286         $(LD_LIBBUSYBOX).$(MAJOR_VERSION) \
287         $(LD_LIBBUSYBOX).$(MAJOR_VERSION).$(MINOR_VERSION)
288
289 endif # CONFIG_BUILD_LIBBUSYBOX
290
291 ifeq ($(strip $(CONFIG_BUILD_AT_ONCE)),y)
292 ifneq ($(strip $(CONFIG_FEATURE_SHARED_BUSYBOX)),y)
293 # --combine but not linking against libbusybox, so compile lib*.c
294 BUSYBOX_SRC   := $(LIBRARY_SRC)
295 BUSYBOX_DEFINE:= $(LIBRARY_DEFINE)
296 endif # !CONFIG_FEATURE_SHARED_BUSYBOX
297 $(LIBBUSYBOX_SONAME): $(LIBRARY_SRC)
298 else # CONFIG_BUILD_AT_ONCE
299 $(LIBBUSYBOX_SONAME): $(libbusybox-obj)
300 AR_INTRO:=-Wl,--whole-archive
301 AR_EXTRO:=-Wl,--no-whole-archive
302 endif # CONFIG_BUILD_AT_ONCE
303
304
305 ifeq ($(strip $(CONFIG_FEATURE_SHARED_BUSYBOX)),y)
306 LDBUSYBOX:=-L$(top_builddir) -lbusybox
307 endif
308
309 ifeq ($(strip $(CONFIG_BUILD_LIBBUSYBOX)),y)
310 $(LIBBUSYBOX_SONAME):
311 ifndef MAJOR_VERSION
312         $(error MAJOR_VERSION needed for $@ is not defined)
313 endif
314         $(do_link) $(LIB_CFLAGS) $(CFLAGS_COMBINE) \
315         -Wl,-soname=$(LD_LIBBUSYBOX).$(MAJOR_VERSION) \
316         -Wl,-z,combreloc $(LIB_LDFLAGS) \
317         -o $(@) \
318         -Wl,--start-group \
319         $(LIBRARY_DEFINE) $(AR_INTRO) $(^) $(AR_EXTRO) \
320         -Wl,--end-group
321         @rm -f $(DO_INSTALL_LIBS)
322         @for i in $(DO_INSTALL_LIBS); do ln -s $(@) $$i ; done
323         $(do_strip)
324
325 endif # ifeq ($(strip $(CONFIG_BUILD_LIBBUSYBOX)),y)
326
327 busybox_unstripped: $(top_builddir)/.depend $(LIBBUSYBOX_SONAME) $(BUSYBOX_SRC) $(APPLET_SRC) $(libraries-y)
328         $(do_link) $(PROG_CFLAGS) $(PROG_LDFLAGS) $(CFLAGS_COMBINE) \
329         $(foreach f,$(^:.o=.c),$(CFLAGS-$(notdir $(patsubst %/$,%,$(dir $(f))))-$(notdir $(f)))) \
330         $(CFLAGS-$(@)) \
331         -o $@ -Wl,--start-group \
332         $(APPLETS_DEFINE) $(APPLET_SRC) \
333         $(BUSYBOX_DEFINE) $(BUSYBOX_SRC) \
334         $(libraries-y) \
335         $(LDBUSYBOX) $(LIBRARIES) \
336         -Wl,--end-group
337
338 busybox: busybox_unstripped
339         $(Q)cp busybox_unstripped busybox
340         $(do_strip)
341
342 busybox.links: $(top_srcdir)/applets/busybox.mkll include/bb_config.h $(top_srcdir)/include/applets.h
343         $(Q)-$(SHELL) $^ >$@
344
345 install: $(top_srcdir)/applets/install.sh busybox busybox.links
346         $(Q)DO_INSTALL_LIBS="$(strip $(LIBBUSYBOX_SONAME) $(DO_INSTALL_LIBS))" \
347                 $(SHELL) $< $(PREFIX) $(INSTALL_OPTS)
348 ifeq ($(strip $(CONFIG_FEATURE_SUID)),y)
349         @echo
350         @echo
351         @echo --------------------------------------------------
352         @echo You will probably need to make your busybox binary
353         @echo setuid root to ensure all configured applets will
354         @echo work properly.
355         @echo --------------------------------------------------
356         @echo
357 endif
358
359 uninstall: busybox.links
360         rm -f $(PREFIX)/bin/busybox
361         for i in `cat busybox.links` ; do rm -f $(PREFIX)$$i; done
362 ifneq ($(strip $(DO_INSTALL_LIBS)),n)
363         for i in $(LIBBUSYBOX_SONAME) $(DO_INSTALL_LIBS); do \
364                 rm -f $(PREFIX)$$i; \
365         done
366 endif
367
368 check test: busybox
369         bindir=$(top_builddir) srcdir=$(top_srcdir)/testsuite \
370         $(top_srcdir)/testsuite/runtest $(CHECK_VERBOSE)
371
372 sizes: busybox_unstripped
373         $(NM) --size-sort $(<)
374
375 # Documentation Targets
376 doc: docs/busybox.pod docs/BusyBox.txt docs/BusyBox.1 docs/BusyBox.html ;
377
378 docs/busybox.pod : $(top_srcdir)/docs/busybox_header.pod $(top_srcdir)/include/usage.h $(top_srcdir)/docs/busybox_footer.pod $(top_srcdir)/docs/autodocifier.pl
379         $(disp_doc)
380         $(Q)-mkdir -p docs
381         $(Q)-( cat $(top_srcdir)/docs/busybox_header.pod ; \
382             $(top_srcdir)/docs/autodocifier.pl $(top_srcdir)/include/usage.h ; \
383             cat $(top_srcdir)/docs/busybox_footer.pod ; ) > docs/busybox.pod
384
385 docs/BusyBox.txt: docs/busybox.pod
386         $(disp_doc)
387         $(Q)-mkdir -p docs
388         $(Q)-pod2text $< > $@
389
390 docs/BusyBox.1: docs/busybox.pod
391         $(disp_doc)
392         $(Q)-mkdir -p docs
393         $(Q)-pod2man --center=BusyBox --release="version $(VERSION)" \
394                 $< > $@
395
396 docs/BusyBox.html: docs/busybox.net/BusyBox.html
397         $(disp_doc)
398         $(Q)-mkdir -p docs
399         $(Q)-rm -f docs/BusyBox.html
400         $(Q)-cp docs/busybox.net/BusyBox.html docs/BusyBox.html
401
402 docs/busybox.net/BusyBox.html: docs/busybox.pod
403         $(Q)-mkdir -p docs/busybox.net
404         $(Q)-pod2html --noindex $< > \
405             docs/busybox.net/BusyBox.html
406         $(Q)-rm -f pod2htm*
407
408 # The nifty new dependency stuff
409 scripts/bb_mkdep: $(top_srcdir)/scripts/bb_mkdep.c
410         $(do_link.h)
411
412 DEP_INCLUDES := include/bb_config.h
413
414 ifeq ($(strip $(CONFIG_BBCONFIG)),y)
415 DEP_INCLUDES += include/bbconfigopts.h
416
417 include/bbconfigopts.h: .config
418         $(disp_gen)
419         $(Q)$(top_srcdir)/scripts/config/mkconfigs > $@
420 endif
421
422 depend dep: $(top_builddir)/.depend ;
423 $(top_builddir)/.depend: $(buildtree) scripts/bb_mkdep $(DEP_INCLUDES)
424         $(disp_gen)
425         $(Q)rm -f .depend
426         $(Q)scripts/bb_mkdep $(MKDEP_ARGS) \
427                 -I $(top_srcdir)/include $(top_srcdir) > $@.tmp
428         $(Q)mv $@.tmp $@
429
430 include/bb_config.h: .config
431         $(disp_gen)
432         @$(top_builddir)/scripts/config/conf -o $(CONFIG_CONFIG_IN)
433
434 endif # ifeq ($(strip $(HAVE_DOT_CONFIG)),y)
435
436 clean:
437         - rm -f docs/busybox.dvi docs/busybox.ps \
438             docs/busybox.pod docs/busybox.net/busybox.html \
439             docs/busybox pod2htm* *.gdb *.elf *~ core .*config.log \
440             docs/BusyBox.txt docs/BusyBox.1 docs/BusyBox.html \
441             docs/busybox.net/BusyBox.html busybox.links \
442             libbusybox.so* \
443             .config.old busybox busybox_unstripped
444         - rm -r -f _install testsuite/links
445         - find . -name .\*.flags -o -name \*.o  -o -name \*.om \
446             -o -name \*.os -o -name \*.osm -o -name \*.a | xargs rm -f
447
448 distclean: clean
449         - $(MAKE) -C scripts/config clean
450         - rm -f scripts/bb_mkdep
451         - rm -r -f include/config $(DEP_INCLUDES)
452         - find . -name .depend'*' | xargs rm -f 
453         rm -f .config .config.old .config.cmd
454
455 release: distclean #doc
456         cd ..; \
457         rm -r -f $(PROG)-$(VERSION); \
458         cp -a busybox $(PROG)-$(VERSION); \
459         \
460         find $(PROG)-$(VERSION)/ -type d \
461                 -name .svn \
462                 -print \
463                 -exec rm -r -f {} \; ; \
464         \
465         find $(PROG)-$(VERSION)/ -type f \
466                 -name .\#* \
467                 -print \
468                 -exec rm -f {} \; ; \
469         \
470         tar -cvzf $(PROG)-$(VERSION).tar.gz $(PROG)-$(VERSION)/;
471
472 tags:
473         ctags -R .
474
475 # keep these in sync with noconfig_targets above!
476 .PHONY: dummy subdirs check test depend dep buildtree \
477         menuconfig config oldconfig randconfig \
478         defconfig allyesconfig allnoconfig allbareconfig \
479         clean distclean \
480         release tags
481