33dd1e11324a6002694df40d02333280c615dcd0
[oweals/busybox.git] / Makefile
1 # Makefile for busybox
2 #
3 # Copyright (C) 1999,2000,2001 Erik Andersen <andersee@debian.org>
4 #
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 2 of the License, or
8 # (at your option) any later version.
9 #
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 # General Public License for more details.
14 #
15 # You should have received a copy of the GNU General Public License
16 # along with this program; if not, write to the Free Software
17 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18 #
19
20 PROG      := busybox
21 VERSION   := 0.49
22 BUILDTIME := $(shell TZ=UTC date --utc "+%Y.%m.%d-%H:%M%z")
23 export VERSION
24
25 # With a modern GNU make(1) (highly recommended, that's what all the
26 # developers use), all of the following configuration values can be
27 # overridden at the command line.  For example:
28 #   make CROSS=powerpc-linux- BB_SRC_DIR=$HOME/busybox PREFIX=/mnt/app
29
30 # If you want to add some simple compiler switches (like -march=i686),
31 # especially from the command line, use this instead of CFLAGS directly.
32 # For optimization overrides, it's better still to set OPTIMIZATION.
33 CFLAGS_EXTRA =
34  
35 # If you want a static binary, turn this on.
36 DOSTATIC = false
37
38 # Set the following to `true' to make a debuggable build.
39 # Leave this set to `false' for production use.
40 # eg: `make DODEBUG=true tests'
41 # Do not enable this for production builds...
42 DODEBUG = false
43
44 # Setting this to `true' will cause busybox to directly use the system's
45 # password and group functions.  Assuming you use GNU libc, when this is
46 # `true', you will need to install the /etc/nsswitch.conf configuration file
47 # and the required libnss_* libraries. This generally makes your embedded
48 # system quite a bit larger... If you leave this off, busybox will directly
49 # use the /etc/password, /etc/group files (and your system will be smaller, and
50 # I will get fewer emails asking about how glibc NSS works).  Enabling this adds
51 # just 1.4k to the binary size (which is a _lot_ less then glibc NSS costs),
52 # Most people will want to leave this set to false.
53 USE_SYSTEM_PWD_GRP = false
54
55 # This enables compiling with dmalloc ( http://dmalloc.com/ )
56 # which is an excellent public domain mem leak and malloc problem
57 # detector.  To enable dmalloc, before running busybox you will
58 # want to first set up your environment.
59 # eg: `export DMALLOC_OPTIONS=debug=0x14f47d83,inter=100,log=logfile`
60 # Do not enable this for production builds...
61 DODMALLOC = false
62
63 # If you want large file summit support, turn this on.
64 # This has no effect if you don't have a kernel with lfs
65 # support, and a system with libc-2.1.3 or later.
66 # Some of the programs that can benefit from lfs support
67 # are dd, gzip, mount, tar, and mkfs_minix.
68 # LFS allows you to use the above programs for files
69 # larger than 2GB!
70 DOLFS = false
71
72 # If you have a "pristine" source directory, point BB_SRC_DIR to it.
73 # Experimental and incomplete; tell the mailing list
74 # <busybox@opensource.lineo.com> if you do or don't like it so far.
75 BB_SRC_DIR = .
76
77 # If you are running a cross compiler, you may want to set this
78 # to something more interesting, like "powerpc-linux-".
79 CROSS =
80 CC = $(CROSS)gcc
81 STRIPTOOL = $(CROSS)strip
82
83 # To compile vs uClibc, just use the compiler wrapper built by uClibc...
84 # Isn't that easy?  Right now, uClibc needs BB_FEATURE_NFSMOUNT disabled 
85 # since uClibc's nfs support isn't ready yet.
86 #CC = ../uClibc/extra/gcc-uClibc/gcc-uClibc-i386
87
88 # To compile vs some other alternative libc, you may need to use/adjust
89 # the following lines to meet your needs...
90 #LIBCDIR=/usr/i486-linuxlibc1/
91 #LDFLAGS+=-nostdlib
92 #LIBRARIES = $(LIBCDIR)/libc.a -lgcc
93 #CROSS_CFLAGS+=-nostdinc -I$(LIBCDIR)/include -I$(GCCINCDIR)
94 #GCCINCDIR = $(shell gcc -print-search-dirs | sed -ne "s/install: \(.*\)/\1include/gp")
95
96 #--------------------------------------------------------
97
98 # use '-Os' optimization if available, else use -O2
99 OPTIMIZATION = $(shell if $(CC) -Os -S -o /dev/null -xc /dev/null >/dev/null 2>&1; \
100     then echo "-Os"; else echo "-O2" ; fi)
101
102 WARNINGS = -Wall
103
104 ifeq ($(DOLFS),true)
105     # For large file summit support
106     CFLAGS+=-D_FILE_OFFSET_BITS=64
107 endif
108 ifeq ($(DODMALLOC),true)
109     # For testing mem leaks with dmalloc
110     CFLAGS+=-DDMALLOC
111     LIBRARIES = -ldmalloc
112     # Force debug=true, since this is useless when not debugging...
113     DODEBUG = true
114 endif
115 ifeq ($(DODEBUG),true)
116     CFLAGS  += $(WARNINGS) -g -D_GNU_SOURCE
117     LDFLAGS += -Wl,-warn-common
118     STRIP    =
119 else
120     CFLAGS  += $(WARNINGS) $(OPTIMIZATION) -fomit-frame-pointer -D_GNU_SOURCE
121     LDFLAGS += -s -Wl,-warn-common
122     STRIP    = $(STRIPTOOL) --remove-section=.note --remove-section=.comment $(PROG)
123 endif
124 ifeq ($(DOSTATIC),true)
125     LDFLAGS += --static
126     #
127     #use '-ffunction-sections -fdata-sections' and '--gc-sections' (if they 
128     # work) to try and strip out any unused junk.  Doesn't do much for me, 
129     # but you may want to give it a shot...
130     #
131     #ifeq ($(shell $(CC) -ffunction-sections -fdata-sections -S \
132     #   -o /dev/null -xc /dev/null 2>/dev/null && $(LD) \
133     #                   --gc-sections -v >/dev/null && echo 1),1)
134     #   CFLAGS += -ffunction-sections -fdata-sections
135     #   LDFLAGS += --gc-sections
136     #endif
137 endif
138
139 ifndef $(PREFIX)
140     PREFIX = `pwd`/_install
141 endif
142
143 # Additional complications due to support for pristine source dir.
144 # Config.h in the build directory should take precedence over the
145 # copy in BB_SRC_DIR, both during the compilation phase and the
146 # shell script that finds the list of object files.
147 #
148 # Work in progress by <ldoolitt@recycle.lbl.gov>.
149 # If it gets in your way, set DISABLE_VPATH=yes
150 ifeq ($(DISABLE_VPATH),yes)
151     CONFIG_H = Config.h
152 else
153     VPATH = .:$(BB_SRC_DIR)
154     CONFIG_LIST = $(addsuffix /Config.h,$(subst :, ,$(VPATH)))
155     CONFIG_H    = $(word 1,$(shell ls -f -1 $(CONFIG_LIST) 2>/dev/null))
156     CFLAGS += -I- $(patsubst %,-I%,$(subst :, ,$(VPATH)))
157 endif
158
159 OBJECTS   = $(shell $(BB_SRC_DIR)/busybox.sh $(CONFIG_H) $(BB_SRC_DIR)) busybox.o messages.o usage.o utility.o
160 CFLAGS    += $(CROSS_CFLAGS)
161 CFLAGS    += -DBB_VER='"$(VERSION)"'
162 CFLAGS    += -DBB_BT='"$(BUILDTIME)"'
163 ifdef BB_INIT_SCRIPT
164     CFLAGS += -DINIT_SCRIPT='"$(BB_INIT_SCRIPT)"'
165 endif
166
167 ifneq ($(USE_SYSTEM_PWD_GRP),true)
168     PWD_LIB   = pwd_grp/libpwd.a
169     LIBRARIES += $(PWD_LIB)
170 else
171     CFLAGS    += -DUSE_SYSTEM_PWD_GRP
172 endif
173
174
175 # Put user-supplied flags at the end, where they
176 # have a chance of winning.
177 CFLAGS += $(CFLAGS_EXTRA)
178
179 .EXPORT_ALL_VARIABLES:
180
181 all: busybox busybox.links doc
182
183 doc: olddoc
184
185 # Old Docs...
186 olddoc: docs/BusyBox.txt docs/BusyBox.1 docs/BusyBox.html
187
188 docs/BusyBox.txt: docs/busybox.pod
189         @echo
190         @echo BusyBox Documentation
191         @echo
192         -mkdir -p docs
193         -pod2text $(BB_SRC_DIR)/docs/busybox.pod > docs/BusyBox.txt
194
195 docs/BusyBox.1: docs/busybox.pod
196         - mkdir -p docs
197         - pod2man --center=BusyBox --release="version $(VERSION)" \
198                 $(BB_SRC_DIR)/docs/busybox.pod > docs/BusyBox.1
199
200 docs/BusyBox.html: docs/busybox.lineo.com/BusyBox.html
201         -@ rm -f docs/BusyBox.html
202         -@ ln -s busybox.lineo.com/BusyBox.html docs/BusyBox.html
203
204 docs/busybox.lineo.com/BusyBox.html: docs/busybox.pod
205         -@ mkdir -p docs/busybox.lineo.com
206         -  pod2html --noindex $(BB_SRC_DIR)/docs/busybox.pod > \
207             docs/busybox.lineo.com/BusyBox.html
208         -@ rm -f pod2html*
209
210
211 # New docs based on DOCBOOK SGML
212 newdoc: docs/busybox.txt docs/busybox.pdf docs/busybox/busyboxdocumentation.html
213
214 docs/busybox.txt: docs/busybox.sgml
215         @echo
216         @echo BusyBox Documentation
217         @echo
218         - mkdir -p docs
219         (cd docs; sgmltools -b txt busybox.sgml)
220
221 docs/busybox.dvi: docs/busybox.sgml
222         - mkdir -p docs
223         (cd docs; sgmltools -b dvi busybox.sgml)
224
225 docs/busybox.ps: docs/busybox.sgml
226         - mkdir -p docs
227         (cd docs; sgmltools -b ps busybox.sgml)
228
229 docs/busybox.pdf: docs/busybox.ps
230         - mkdir -p docs
231         (cd docs; ps2pdf busybox.ps)
232
233 docs/busybox/busyboxdocumentation.html: docs/busybox.sgml
234         - mkdir -p docs
235         (cd docs/busybox.lineo.com; sgmltools -b html ../busybox.sgml)
236
237
238
239 busybox: $(PWD_LIB) $(OBJECTS) 
240         $(CC) $(LDFLAGS) -o $@ $^ $(LIBRARIES)
241         $(STRIP)
242
243 $(PWD_LIB):
244         $(MAKE) -eC pwd_grp
245
246 busybox.links: Config.h applets.h
247         - $(BB_SRC_DIR)/busybox.mkll $(CONFIG_H) $(BB_SRC_DIR)/applets.h >$@
248
249 nfsmount.o cmdedit.o: %.o: %.h
250 $(OBJECTS): %.o: %.c Config.h busybox.h applets.h Makefile
251
252 utility.o: loop.h
253
254 loop.h: mk_loop_h.sh
255         @ sh $<
256
257 test tests:
258         cd tests && $(MAKE) all
259
260 clean:
261         - cd tests && $(MAKE) clean
262         - cd pwd_grp && $(MAKE) clean
263         - rm -f docs/BusyBox.txt docs/BusyBox.1 docs/BusyBox.html \
264             docs/busybox.lineo.com/BusyBox.html
265         - rm -f docs/busybox.txt docs/busybox.dvi docs/busybox.ps \
266             docs/busybox.pdf docs/busybox.lineo.com/busybox.html
267         - rm -f multibuild.log Config.h.orig
268         - rm -rf docs/busybox _install
269         - rm -f busybox.links loop.h *~ *.o core
270
271 distclean: clean
272         - rm -f busybox
273         - cd tests && $(MAKE) distclean
274
275 install: busybox busybox.links
276         $(BB_SRC_DIR)/install.sh $(PREFIX)
277
278 install-hardlinks: busybox busybox.links
279         $(BB_SRC_DIR)/install.sh $(PREFIX) --hardlinks
280
281 debug_pristine:
282         @ echo VPATH=\"$(VPATH)\"
283         @ echo CONFIG_LIST=\"$(CONFIG_LIST)\"
284         @ echo CONFIG_H=\"$(CONFIG_H)\"
285         @ echo OBJECTS=\"$(OBJECTS)\"
286
287 dist release: distclean doc
288         cd ..;                                  \
289         rm -rf busybox-$(VERSION);              \
290         cp -a busybox busybox-$(VERSION);       \
291                                                 \
292         find busybox-$(VERSION)/ -type d        \
293                                  -name CVS      \
294                                  -print         \
295                 | xargs rm -rf;                 \
296                                                 \
297         find busybox-$(VERSION)/ -type f        \
298                                  -name .cvsignore \
299                                  -print         \
300                 | xargs rm -f;                  \
301                                                 \
302         find busybox-$(VERSION)/ -type f        \
303                                  -name .\#*     \
304                                  -print         \
305                 | xargs rm -f;                  \
306                                                 \
307         tar -cvzf busybox-$(VERSION).tar.gz busybox-$(VERSION)/;
308
309 .PHONY: tags
310 tags:
311         ctags -R .