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