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