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.50pre
  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 AR = $(CROSS)ar
  82 STRIPTOOL = $(CROSS)strip
  83
  84 # To compile vs uClibc, just use the compiler wrapper built by uClibc...
  85 # This make things very easy?  Everything should compile and work as
  86 # expected these days...
  87 #CC = ../uClibc/extra/gcc-uClibc/gcc-uClibc-i386
  88
  89 # To compile vs some other alternative libc, you may need to use/adjust
  90 # the following lines to meet your needs...
  91 #LIBCDIR=/usr/i486-linuxlibc1
  92 #LDFLAGS+=-nostdlib
  93 #LIBRARIES = $(LIBCDIR)/lib/libc.a -lgcc
  94 #CROSS_CFLAGS+=-nostdinc -I$(LIBCDIR)/include -I$(GCCINCDIR)
  95 #GCCINCDIR = $(shell gcc -print-search-dirs | sed -ne "s/install: \(.*\)/\1include/gp")
  96
  97 # use '-Os' optimization if available, else use -O2
  98 OPTIMIZATION := $(shell if $(CC) -Os -S -o /dev/null -xc /dev/null >/dev/null 2>&1; \
  99     then echo "-Os"; else echo "-O2" ; fi)
 100
 101 WARNINGS = -Wall
 102
 103 #
 104 #--------------------------------------------------------
 105 # If you're going to do a lot of builds with a non-vanilla configuration,
 106 # it makes sense to adjust parameters above, so you can type "make"
 107 # by itself, instead of following it by the same half-dozen overrides
 108 # every time.  The stuff below, on the other hand, is probably less
 109 # prone to casual user adjustment.
 110 #
 111
 112 ifeq ($(strip $(DOLFS)),true)
 113     # For large file summit support
 114     CFLAGS+=-D_FILE_OFFSET_BITS=64
 115 endif
 116 ifeq ($(strip $(DODMALLOC)),true)
 117     # For testing mem leaks with dmalloc
 118     CFLAGS+=-DDMALLOC
 119     LIBRARIES = -ldmalloc
 120     # Force debug=true, since this is useless when not debugging...
 121     DODEBUG = true
 122 endif
 123 ifeq ($(strip $(DODEBUG)),true)
 124     CFLAGS  += $(WARNINGS) -g -D_GNU_SOURCE
 125     LDFLAGS += -Wl,-warn-common
 126     STRIP    =
 127 else
 128     CFLAGS  += $(WARNINGS) $(OPTIMIZATION) -fomit-frame-pointer -D_GNU_SOURCE
 129     LDFLAGS += -s -Wl,-warn-common
 130     STRIP    = $(STRIPTOOL) --remove-section=.note --remove-section=.comment $(PROG)
 131 endif
 132 ifeq ($(strip $(DOSTATIC)),true)
 133     LDFLAGS += --static
 134     #
 135     #use '-ffunction-sections -fdata-sections' and '--gc-sections' (if they
 136     # work) to try and strip out any unused junk.  Doesn't do much for me,
 137     # but you may want to give it a shot...
 138     #
 139     #ifeq ($(shell $(CC) -ffunction-sections -fdata-sections -S \
 140     #   -o /dev/null -xc /dev/null 2>/dev/null && $(LD) \
 141     #                   --gc-sections -v >/dev/null && echo 1),1)
 142     #   CFLAGS += -ffunction-sections -fdata-sections
 143     #   LDFLAGS += --gc-sections
 144     #endif
 145 endif
 146
 147 ifndef $(PREFIX)
 148     PREFIX = `pwd`/_install
 149 endif
 150
 151 # Additional complications due to support for pristine source dir.
 152 # Include files in the build directory should take precedence over
 153 # the copy in BB_SRC_DIR, both during the compilation phase and the
 154 # shell script that finds the list of object files.
 155 # Work in progress by <ldoolitt@recycle.lbl.gov>.
 156 #
 157 ifneq ($(strip $(BB_SRC_DIR)),)
 158     VPATH = $(BB_SRC_DIR)
 159 endif
 160 #ifneq ($(strip $(VPATH)),)
 161 #    CFLAGS += -I- -I. $(patsubst %,-I%,$(subst :, ,$(VPATH)))
 162 #endif
 163
 164 # We need to set APPLET_SOURCES to something like
 165 #   $(shell busybox.sh Config.h)
 166 # but in a manner that works with VPATH and BB_SRC_DIR.
 167 # Possible ways to approach this:
 168 #
 169 #   1. Explicitly search through .:$(VPATH) for busybox.sh and config.h,
 170 #      then $(shell $(BUSYBOX_SH) $(CONFIG_H) $(BB_SRC_DIR))
 171 #
 172 #   2. Explicity search through .:$(VPATH) for slist.mk,
 173 #      then $(shell $(MAKE) -f $(SLIST_MK) VPATH=$(VPATH) BB_SRC_DIR=$(BB_SRC_DIR))
 174 #
 175 #   3. Create slist.mk in this directory, with commands embedded in
 176 #      a $(shell ...) command, and $(MAKE) it immediately.
 177 #
 178 #   4. Use a real rule within this makefile to create a file that sets
 179 #      APPLET_SOURCE_LIST, then include that file.  Has complications
 180 #      with the first trip through the makefile (before processing the
 181 #      include) trying to do too much, and a spurious warning the first
 182 #      time make is run.
 183 #
 184 # This is option 3:
 185 #
 186 #APPLET_SOURCES = $(shell \
 187 #   echo -e 'all: busybox.sh Config.h\n\t@ $$(SHELL) $$^ $$(BB_SRC_DIR)' >slist.mk; \
 188 #   make -f slist.mk VPATH=$(VPATH) BB_SRC_DIR=$(BB_SRC_DIR) \
 189 #)
 190 # And option 4:
 191 -include applet_source_list
 192
 193 OBJECTS   = $(APPLET_SOURCES:.c=.o) busybox.o messages.o usage.o utility.o
 194 CFLAGS    += $(CROSS_CFLAGS)
 195 CFLAGS    += -DBB_VER='"$(VERSION)"'
 196 CFLAGS    += -DBB_BT='"$(BUILDTIME)"'
 197 ifdef BB_INIT_SCRIPT
 198     CFLAGS += -DINIT_SCRIPT='"$(BB_INIT_SCRIPT)"'
 199 endif
 200
 201 ifneq ($(strip $(USE_SYSTEM_PWD_GRP)),true)
 202     PWD_GRP     = pwd_grp
 203     PWD_GRP_DIR = $(BB_SRC_DIR)$(PWD_GRP)
 204     PWD_LIB     = libpwd.a
 205     PWD_CSRC=__getpwent.c pwent.c getpwnam.c getpwuid.c putpwent.c getpw.c \
 206             fgetpwent.c __getgrent.c grent.c getgrnam.c getgrgid.c fgetgrent.c \
 207             initgroups.c setgroups.c
 208     PWD_OBJS=$(patsubst %.c,$(PWD_GRP)/%.o, $(PWD_CSRC))
 209     PWD_CFLAGS = -I$(PWD_GRP_DIR)
 210 else
 211     CFLAGS    += -DUSE_SYSTEM_PWD_GRP
 212 endif
 213
 214 # Put user-supplied flags at the end, where they
 215 # have a chance of winning.
 216 CFLAGS += $(CFLAGS_EXTRA)
 217
 218 .EXPORT_ALL_VARIABLES:
 219
 220 all: applet_source_list busybox busybox.links doc
 221
 222 applet_source_list: busybox.sh Config.h
 223         (echo -n "APPLET_SOURCES := "; $(SHELL) $^ $(BB_SRC_DIR)) > $@
 224
 225 doc: olddoc
 226
 227 # Old Docs...
 228 olddoc: docs/BusyBox.txt docs/BusyBox.1 docs/BusyBox.html
 229
 230 docs/BusyBox.txt: docs/busybox.pod
 231         @echo
 232         @echo BusyBox Documentation
 233         @echo
 234         -mkdir -p docs
 235         -pod2text $< > $@
 236
 237 docs/BusyBox.1: docs/busybox.pod
 238         - mkdir -p docs
 239         - pod2man --center=BusyBox --release="version $(VERSION)" \
 240                 $< > $@
 241
 242 docs/BusyBox.html: docs/busybox.lineo.com/BusyBox.html
 243         - mkdir -p docs
 244         -@ rm -f docs/BusyBox.html
 245         -@ ln -s busybox.lineo.com/BusyBox.html docs/BusyBox.html
 246
 247 docs/busybox.lineo.com/BusyBox.html: docs/busybox.pod
 248         -@ mkdir -p docs/busybox.lineo.com
 249         -  pod2html --noindex $< > \
 250             docs/busybox.lineo.com/BusyBox.html
 251         -@ rm -f pod2html*
 252
 253
 254 # New docs based on DOCBOOK SGML
 255 newdoc: docs/busybox.txt docs/busybox.pdf docs/busybox/busyboxdocumentation.html
 256
 257 docs/busybox.txt: docs/busybox.sgml
 258         @echo
 259         @echo BusyBox Documentation
 260         @echo
 261         - mkdir -p docs
 262         (cd docs; sgmltools -b txt busybox.sgml)
 263
 264 docs/busybox.dvi: docs/busybox.sgml
 265         - mkdir -p docs
 266         (cd docs; sgmltools -b dvi busybox.sgml)
 267
 268 docs/busybox.ps: docs/busybox.sgml
 269         - mkdir -p docs
 270         (cd docs; sgmltools -b ps busybox.sgml)
 271
 272 docs/busybox.pdf: docs/busybox.ps
 273         - mkdir -p docs
 274         (cd docs; ps2pdf busybox.ps)
 275
 276 docs/busybox/busyboxdocumentation.html: docs/busybox.sgml
 277         - mkdir -p docs
 278         (cd docs/busybox.lineo.com; sgmltools -b html ../busybox.sgml)
 279
 280
 281 busybox: $(PWD_LIB) $(OBJECTS)
 282         $(CC) $(LDFLAGS) -o $@ $^ $(LIBRARIES)
 283         $(STRIP)
 284
 285 # Without VPATH, rule expands to "/bin/sh busybox.mkll Config.h applets.h"
 286 # but with VPATH, some or all of those file names are resolved to the
 287 # directories in which they live.
 288 busybox.links: busybox.mkll Config.h applets.h
 289         - $(SHELL) $^ >$@
 290
 291 nfsmount.o cmdedit.o: %.o: %.h
 292 $(OBJECTS): %.o: %.c Config.h busybox.h applets.h Makefile
 293         $(CC) -I- $(CFLAGS) -I. $(patsubst %,-I%,$(subst :, ,$(BB_SRC_DIR))) -c $< -o $*.o
 294
 295 $(PWD_OBJS): %.o: %.c Config.h busybox.h applets.h Makefile
 296         - mkdir -p $(PWD_GRP)
 297         $(CC) $(CFLAGS) $(PWD_CFLAGS) -c $< -o $*.o
 298
 299 $(PWD_LIB): $(PWD_OBJS)
 300         $(AR) $(ARFLAGS) $(PWD_LIB) $^
 301
 302 usage.o: usage.h
 303
 304 utility.o: loop.h
 305
 306 loop.h: mk_loop_h.sh
 307         @ $(SHELL) $< > $@
 308
 309 test tests:
 310         cd tests && $(MAKE) all
 311
 312 clean:
 313         - cd tests && $(MAKE) clean
 314         - rm -f docs/BusyBox.txt docs/BusyBox.1 docs/BusyBox.html \
 315             docs/busybox.lineo.com/BusyBox.html
 316         - rm -f docs/busybox.txt docs/busybox.dvi docs/busybox.ps \
 317             docs/busybox.pdf docs/busybox.lineo.com/busybox.html
 318         - rm -f multibuild.log Config.h.orig
 319         - rm -rf docs/busybox _install $(PWD_LIB)
 320         - rm -f busybox.links loop.h *~ slist.mk core applet_source_list
 321         - find -name \*.o -exec rm -f {} \;
 322
 323 distclean: clean
 324         - rm -f busybox
 325         - cd tests && $(MAKE) distclean
 326
 327 install: install.sh busybox busybox.links
 328         $(SHELL) $< $(PREFIX)
 329
 330 install-hardlinks: install.sh busybox busybox.links
 331         $(SHELL) $< $(PREFIX) --hardlinks
 332
 333 debug_pristine:
 334         @ echo VPATH=\"$(VPATH)\"
 335         @ echo OBJECTS=\"$(OBJECTS)\"
 336
 337 dist release: distclean doc
 338         cd ..;                                  \
 339         rm -rf busybox-$(VERSION);              \
 340         cp -a busybox busybox-$(VERSION);       \
 341                                                 \
 342         find busybox-$(VERSION)/ -type d        \
 343                                  -name CVS      \
 344                                  -print         \
 345                 -exec rm -rf {} \;              \
 346                                                 \
 347         find busybox-$(VERSION)/ -type f        \
 348                                  -name .cvsignore \
 349                                  -print         \
 350                 -exec rm -f {}  \;              \
 351                                                 \
 352         find busybox-$(VERSION)/ -type f        \
 353                                  -name .\#*     \
 354                                  -print         \
 355                 -exec rm -f {} \;               \
 356                                                 \
 357         tar -cvzf busybox-$(VERSION).tar.gz busybox-$(VERSION)/;
 358
 359 .PHONY: tags
 360 tags:
 361         ctags -R .