Makefile

   1 ## -----------------------------------------------------------------------
   2 ##
   3 ##   Copyright 1998-2009 H. Peter Anvin - All Rights Reserved
   4 ##   Copyright 2009-2014 Intel Corporation; author: H. Peter Anvin
   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, Inc., 53 Temple Place Ste 330,
   9 ##   Boston MA 02111-1307, USA; either version 2 of the License, or
  10 ##   (at your option) any later version; incorporated herein by reference.
  11 ##
  12 ## -----------------------------------------------------------------------
  13
  14 #
  15 # Main Makefile for SYSLINUX
  16 #
  17
  18 all_firmware := bios efi32 efi64
  19
  20 #
  21 # topdir is only set when we are doing a recursive make. Do a bunch of
  22 # initialisation if it's unset since this is the first invocation.
  23 #
  24 ifeq ($(topdir),)
  25
  26 topdir = $(CURDIR)
  27
  28 #
  29 # Because we need to build modules multiple times, e.g. for BIOS,
  30 # efi32, efi64, we output all object and executable files to a
  31 # separate object directory for each firmware.
  32 #
  33 # The output directory can be customised by setting the O=/obj/path/
  34 # variable when invoking make. If no value is specified the default
  35 # directory is the top-level of the Syslinux source.
  36 #
  37 ifeq ("$(origin O)", "command line")
  38         OBJDIR := $(O)
  39 else
  40         OBJDIR = $(topdir)
  41 endif
  42
  43 # If the output directory does not exist we bail because that is the
  44 # least surprising thing to do.
  45 cd-output := $(shell cd $(OBJDIR) && /bin/pwd)
  46 $(if $(cd-output),, \
  47         $(error output directory "$(OBJDIR)" does not exist))
  48
  49 #
  50 # These environment variables are exported to every invocation of
  51 # make,
  52 #
  53 # 'topdir' - the top-level directory containing the Syslinux source
  54 # 'objdir' - the top-level directory of output files for this firmware
  55 # 'MAKEDIR' - contains Makefile fragments
  56 # 'OBJDIR' - the top-level directory of output files
  57 #
  58 # There are also a handful of variables that are passed to each
  59 # sub-make,
  60 #
  61 # SRC - source tree location of the module being compiled
  62 # OBJ - output tree location of the module being compiled
  63 #
  64 # A couple of rules for writing Makefiles,
  65 #
  66 # - Do not use relative paths, use the above variables
  67 # - You can write $(SRC) a lot less if you add it to VPATH
  68 #
  69
  70 MAKEDIR = $(topdir)/mk
  71 export MAKEDIR topdir OBJDIR
  72
  73 include $(MAKEDIR)/syslinux.mk
  74 -include $(OBJDIR)/version.mk
  75
  76 private-targets = prerel unprerel official release burn isolinux.iso \
  77                   preupload upload test unittest regression spotless
  78
  79 ifeq ($(MAKECMDGOALS),)
  80         MAKECMDGOALS += all
  81 endif
  82
  83 #
  84 # The 'bios', 'efi32' and 'efi64' are dummy targets. Their only
  85 # purpose is to instruct us which output directories need
  86 # creating. Which means that we always need a *real* target, such as
  87 # 'all', appended to the make goals.
  88 #
  89 firmware = $(all_firmware)
  90 real-target := $(filter-out $(firmware), $(MAKECMDGOALS))
  91 real-firmware := $(filter $(firmware), $(MAKECMDGOALS))
  92
  93 ifeq ($(real-target),)
  94         real-target = all
  95 endif
  96
  97 ifeq ($(real-firmware),)
  98         real-firmware = $(firmware)
  99 endif
 100
 101 .PHONY: $(filter-out $(private-targets), $(MAKECMDGOALS))
 102 $(filter-out $(private-targets), $(MAKECMDGOALS)):
 103         $(MAKE) -C $(OBJDIR) -f $(CURDIR)/Makefile SRC="$(topdir)" \
 104                 OBJ=$(OBJDIR) objdir=$(OBJDIR) $(MAKECMDGOALS)
 105
 106 unittest:
 107         printf "Executing unit tests\n"
 108         $(MAKE) -C core/mem/tests all
 109         $(MAKE) -C com32/lib/syslinux/tests all
 110
 111 regression:
 112         $(MAKE) -C tests SRC="$(topdir)/tests" OBJ="$(topdir)/tests" \
 113                 objdir=$(OBJDIR) \
 114                 -f $(topdir)/tests/Makefile all
 115
 116 test: unittest regression
 117
 118 # Hook to add private Makefile targets for the maintainer.
 119 -include $(topdir)/Makefile.private
 120
 121 else # ifeq ($(topdir),)
 122
 123 include $(MAKEDIR)/syslinux.mk
 124
 125 # Hook to add private Makefile targets for the maintainer.
 126 -include $(topdir)/Makefile.private
 127
 128 #
 129 # The BTARGET refers to objects that are derived from ldlinux.asm; we
 130 # like to keep those uniform for debugging reasons; however, distributors
 131 # want to recompile the installers (ITARGET).
 132 #
 133 # BOBJECTS and IOBJECTS are the same thing, except used for
 134 # installation, so they include objects that may be in subdirectories
 135 # with their own Makefiles.  Finally, there is a list of those
 136 # directories.
 137 #
 138
 139 ifndef EFI_BUILD
 140 MODULES = memdisk/memdisk \
 141         com32/menu/*.c32 com32/modules/*.c32 com32/mboot/*.c32 \
 142         com32/hdt/*.c32 com32/rosh/*.c32 com32/gfxboot/*.c32 \
 143         com32/sysdump/*.c32 com32/lua/src/*.c32 com32/chain/*.c32 \
 144         com32/lib/*.c32 com32/libutil/*.c32 com32/gpllib/*.c32 \
 145         com32/elflink/ldlinux/*.c32 com32/cmenu/libmenu/*.c32
 146 else
 147 # FIXME: Prune other BIOS-centric modules
 148 MODULES = com32/menu/*.c32 com32/modules/*.c32 com32/mboot/*.c32 \
 149         com32/hdt/*.c32 com32/rosh/*.c32 com32/gfxboot/*.c32 \
 150         com32/sysdump/*.c32 com32/lua/src/*.c32 com32/chain/*.c32 \
 151         com32/lib/*.c32 com32/libutil/*.c32 com32/gpllib/*.c32 \
 152         com32/cmenu/libmenu/*.c32 com32/elflink/ldlinux/$(LDLINUX)
 153 endif
 154
 155 # List of module objects that should be installed for all derivatives
 156 INSTALLABLE_MODULES = $(MODULES)
 157
 158 # syslinux.exe is BTARGET so as to not require everyone to have the
 159 # mingw suite installed
 160 BTARGET  = version.gen version.h $(OBJDIR)/version.mk
 161 BOBJECTS = $(BTARGET) \
 162         mbr/*.bin \
 163         core/pxelinux.0 core/lpxelinux.0 \
 164         core/isolinux.bin core/isolinux-debug.bin \
 165         gpxe/gpxelinux.0 dos/syslinux.com \
 166         win32/syslinux.exe win64/syslinux64.exe \
 167         dosutil/*.com dosutil/*.sys \
 168         $(MODULES)
 169
 170 # BSUBDIRs build the on-target binary components.
 171 # ISUBDIRs build the installer (host) components.
 172 #
 173 # Note: libinstaller is both a BSUBDIR and an ISUBDIR.  It contains
 174 # files that depend only on the B phase, but may have to be regenerated
 175 # for "make installer".
 176
 177 ifdef EFI_BUILD
 178
 179 BSUBDIRS = codepage com32 lzo core mbr sample efi txt
 180 ISUBDIRS =
 181
 182 INSTALLSUBDIRS = efi
 183
 184 NETINSTALLABLE = efi/syslinux.efi $(INSTALLABLE_MODULES)
 185
 186 else
 187
 188 BSUBDIRS = codepage com32 lzo core memdisk mbr gpxe sample \
 189            diag libinstaller dos win32 win64 dosutil txt
 190
 191 ITARGET  =
 192 IOBJECTS = $(ITARGET) \
 193         utils/gethostip utils/isohybrid utils/mkdiskimage \
 194         mtools/syslinux linux/syslinux extlinux/extlinux
 195 ISUBDIRS = libinstaller mtools linux extlinux utils
 196
 197 # Things to install in /usr/bin
 198 INSTALL_BIN   = mtools/syslinux
 199 # Things to install in /sbin
 200 INSTALL_SBIN  = extlinux/extlinux
 201 # Things to install in /usr/lib/syslinux
 202 INSTALL_AUX   = core/pxelinux.0 gpxe/gpxelinux.0 gpxe/gpxelinuxk.0 \
 203                 core/isolinux.bin core/isolinux-debug.bin \
 204                 dos/syslinux.com core/lpxelinux.0 \
 205                 mbr/*.bin $(INSTALLABLE_MODULES)
 206 INSTALL_AUX_OPT = win32/syslinux.exe win64/syslinux64.exe
 207 INSTALL_DIAG  = diag/mbr/handoff.bin \
 208                 diag/geodsp/geodsp1s.img.xz diag/geodsp/geodspms.img.xz
 209
 210 # These directories manage their own installables
 211 INSTALLSUBDIRS = com32 utils dosutil
 212
 213 # Things to install in /boot/extlinux
 214 EXTBOOTINSTALL = $(INSTALLABLE_MODULES)
 215
 216 # Things to install in /tftpboot
 217 NETINSTALLABLE = core/pxelinux.0 gpxe/gpxelinux.0 core/lpxelinux.0 \
 218                  $(INSTALLABLE_MODULES)
 219
 220 endif # ifdef EFI_BUILD
 221
 222 .PHONY: subdirs $(BSUBDIRS) $(ISUBDIRS) test
 223
 224 ifeq ($(HAVE_FIRMWARE),)
 225
 226 firmware = $(all_firmware)
 227
 228 # If no firmware was specified the rest of MAKECMDGOALS applies to all
 229 # firmware.
 230 ifeq ($(filter $(firmware),$(MAKECMDGOALS)),)
 231 all strip tidy clean dist install installer netinstall: $(all_firmware)
 232
 233 else
 234
 235 # Don't do anything for the rest of MAKECMDGOALS at this level. It
 236 # will be handled for each of $(firmware).
 237 strip tidy clean dist install installer netinstall:
 238
 239 endif
 240
 241 # Convert 'make bios strip' to 'make strip', etc for rest of the Makefiles.
 242 MAKECMDGOALS := $(filter-out $(firmware),$(MAKECMDGOALS))
 243 ifeq ($(MAKECMDGOALS),)
 244         MAKECMDGOALS += all
 245 endif
 246
 247 #
 248 # You'd think that we'd be able to use the 'define' directive to
 249 # abstract the code for invoking make(1) in the output directory, but
 250 # by using 'define' we lose the ability to build in parallel.
 251 #
 252 .PHONY: $(firmware)
 253 bios:
 254         @mkdir -p $(OBJ)/bios
 255         $(MAKE) -C $(OBJ)/bios -f $(SRC)/Makefile SRC="$(SRC)" \
 256                 objdir=$(OBJ)/bios OBJ=$(OBJ)/bios HAVE_FIRMWARE=1 \
 257                 FIRMWARE=BIOS \
 258                 ARCH=i386 LDLINUX=ldlinux.c32 $(MAKECMDGOALS)
 259
 260 efi32:
 261         @mkdir -p $(OBJ)/efi32
 262         $(MAKE) -C $(OBJ)/efi32 -f $(SRC)/Makefile SRC="$(SRC)" \
 263                 objdir=$(OBJ)/efi32 OBJ=$(OBJ)/efi32 HAVE_FIRMWARE=1 \
 264                 ARCH=i386 BITS=32 EFI_BUILD=1 LDLINUX=ldlinux.e32 \
 265                 FIRMWARE=EFI32 \
 266                 $(MAKECMDGOALS)
 267
 268 efi64:
 269         @mkdir -p $(OBJ)/efi64
 270         $(MAKE) -C $(OBJ)/efi64 -f $(SRC)/Makefile SRC="$(SRC)" \
 271                 objdir=$(OBJ)/efi64 OBJ=$(OBJ)/efi64 HAVE_FIRMWARE=1 \
 272                 ARCH=x86_64 BITS=64 EFI_BUILD=1 LDLINUX=ldlinux.e64 \
 273                 FIRMWARE=EFI64 \
 274                 $(MAKECMDGOALS)
 275
 276 else # ifeq($(HAVE_FIRMWARE),)
 277
 278 all: all-local subdirs
 279
 280 all-local: $(BTARGET) $(ITARGET)
 281         -ls -l $(BOBJECTS) $(IOBJECTS)
 282 subdirs: $(BSUBDIRS) $(ISUBDIRS)
 283
 284 $(sort $(ISUBDIRS) $(BSUBDIRS)):
 285         @mkdir -p $@
 286         $(MAKE) -C $@ SRC="$(SRC)/$@" OBJ="$(OBJ)/$@" \
 287                 -f $(SRC)/$@/Makefile $(MAKECMDGOALS)
 288
 289 $(ITARGET):
 290         @mkdir -p $@
 291         $(MAKE) -C $@ SRC="$(SRC)/$@" OBJ="$(OBJ)/$@" \
 292                 -f $(SRC)/$@/Makefile $(MAKECMDGOALS)
 293
 294 $(BINFILES):
 295         @mkdir -p $@
 296         $(MAKE) -C $@ SRC="$(SRC)/$@" OBJ="$(OBJ)/$@" \
 297                 -f $(SRC)/$@/Makefile $(MAKECMDGOALS)
 298
 299 #
 300 # List the dependencies to help out parallel builds.
 301 dos extlinux linux mtools win32 win64: libinstaller
 302 libinstaller: core
 303 utils: mbr
 304 core: com32
 305 efi: core
 306 gpxe: core
 307
 308 installer: installer-local
 309         set -e; for i in $(ISUBDIRS); \
 310                 do $(MAKE) -C $$i SRC="$(SRC)/$$i" OBJ="$(OBJ)/$$i" \
 311                 -f $(SRC)/$$i/Makefile all; done
 312
 313
 314 installer-local: $(ITARGET) $(BINFILES)
 315
 316 strip: strip-local
 317         set -e; for i in $(ISUBDIRS); \
 318                 do $(MAKE) -C $$i SRC="$(SRC)/$$i" OBJ="$(OBJ)/$$i" \
 319                 -f $(SRC)/$$i/Makefile strip; done
 320         -ls -l $(BOBJECTS) $(IOBJECTS)
 321
 322 strip-local:
 323
 324 version.gen: $(topdir)/version $(topdir)/version.pl
 325         $(PERL) $(topdir)/version.pl $< $@ '%define < @'
 326 version.h: $(topdir)/version $(topdir)/version.pl
 327         $(PERL) $(topdir)/version.pl $< $@ '#define < @'
 328
 329 local-install: installer
 330         mkdir -m 755 -p $(INSTALLROOT)$(BINDIR)
 331         install -m 755 -c $(INSTALL_BIN) $(INSTALLROOT)$(BINDIR)
 332         mkdir -m 755 -p $(INSTALLROOT)$(SBINDIR)
 333         install -m 755 -c $(INSTALL_SBIN) $(INSTALLROOT)$(SBINDIR)
 334         mkdir -m 755 -p $(INSTALLROOT)$(AUXDIR)
 335         install -m 644 -c $(INSTALL_AUX) $(INSTALLROOT)$(AUXDIR)
 336         -install -m 644 -c $(INSTALL_AUX_OPT) $(INSTALLROOT)$(AUXDIR)
 337         mkdir -m 755 -p $(INSTALLROOT)$(DIAGDIR)
 338         install -m 644 -c $(INSTALL_DIAG) $(INSTALLROOT)$(DIAGDIR)
 339         mkdir -m 755 -p $(INSTALLROOT)$(MANDIR)/man1
 340         install -m 644 -c $(topdir)/man/*.1 $(INSTALLROOT)$(MANDIR)/man1
 341         : mkdir -m 755 -p $(INSTALLROOT)$(MANDIR)/man8
 342         : install -m 644 -c man/*.8 $(INSTALLROOT)$(MANDIR)/man8
 343
 344 ifndef EFI_BUILD
 345 install: local-install
 346         set -e ; for i in $(INSTALLSUBDIRS) ; \
 347                 do $(MAKE) -C $$i SRC="$(SRC)/$$i" OBJ="$(OBJ)/$$i" \
 348                 -f $(SRC)/$$i/Makefile $@; done
 349 else
 350 install:
 351         mkdir -m 755 -p $(INSTALLROOT)$(AUXDIR)/efi$(BITS)
 352         set -e ; for i in $(INSTALLSUBDIRS) ; \
 353                 do $(MAKE) -C $$i SRC="$(SRC)/$$i" OBJ="$(OBJ)/$$i" \
 354                 BITS="$(BITS)" AUXDIR="$(AUXDIR)/efi$(BITS)" \
 355                 -f $(SRC)/$$i/Makefile $@; done
 356         -install -m 644 $(INSTALLABLE_MODULES) $(INSTALLROOT)$(AUXDIR)/efi$(BITS)
 357         install -m 644 com32/elflink/ldlinux/$(LDLINUX) $(INSTALLROOT)$(AUXDIR)/efi$(BITS)
 358 endif
 359
 360 ifdef EFI_BUILD
 361 netinstall:
 362         mkdir -p $(INSTALLROOT)$(TFTPBOOT)/efi$(BITS)
 363         install -m 644 $(NETINSTALLABLE) $(INSTALLROOT)$(TFTPBOOT)/efi$(BITS)
 364 else
 365 netinstall: installer
 366         mkdir -p $(INSTALLROOT)$(TFTPBOOT)
 367         install -m 644 $(NETINSTALLABLE) $(INSTALLROOT)$(TFTPBOOT)
 368 endif
 369
 370 extbootinstall: installer
 371         mkdir -m 755 -p $(INSTALLROOT)$(EXTLINUXDIR)
 372         install -m 644 $(EXTBOOTINSTALL) $(INSTALLROOT)$(EXTLINUXDIR)
 373
 374 install-all: install netinstall extbootinstall
 375
 376 local-tidy:
 377         rm -f *.o *.elf *_bin.c stupid.* patch.offset
 378         rm -f *.lsr *.lst *.map *.sec *.tmp
 379         rm -f $(OBSOLETE)
 380
 381 tidy: local-tidy $(BESUBDIRS) $(IESUBDIRS) $(BSUBDIRS) $(ISUBDIRS)
 382
 383 local-clean:
 384         rm -f $(ITARGET)
 385
 386 clean: local-tidy local-clean $(BESUBDIRS) $(IESUBDIRS) $(BSUBDIRS) $(ISUBDIRS)
 387
 388 local-dist:
 389         find . \( -name '*~' -o -name '#*' -o -name core \
 390                 -o -name '.*.d' -o -name .depend \) -type f -print0 \
 391         | xargs -0rt rm -f
 392
 393 dist: local-dist local-tidy $(BESUBDIRS) $(IESUBDIRS) $(BSUBDIRS) $(ISUBDIRS)
 394
 395 # Shortcut to build linux/syslinux using klibc
 396 klibc:
 397         $(MAKE) clean
 398         $(MAKE) CC=klcc ITARGET= ISUBDIRS='linux extlinux' BSUBDIRS=
 399 endif # ifeq ($(HAVE_FIRMWARE),)
 400
 401 endif # ifeq ($(topdir),)
 402
 403 local-spotless:
 404         find . \( -name '*~' -o -name '#*' -o -name core \
 405                 -o -name '.*.d' -o -name .depend -o -name '*.so.*' \) \
 406                 -type f -print0 \
 407         | xargs -0rt rm -f
 408
 409 spotless: local-spotless
 410         rm -rf $(all_firmware)
 411
 412 #
 413 # Common rules that are needed by every invocation of make.
 414 #
 415 $(OBJDIR)/version.mk: $(topdir)/version $(topdir)/version.pl
 416         $(PERL) $(topdir)/version.pl $< $@ '< := @'