native_client_sdk/src/tools/common.mk

   1 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 # Use of this source code is governed by a BSD-style license that can be
   3 # found in the LICENSE file.
   4
   5 #
   6 # GNU Make based build file.  For details on GNU Make see:
   7 #   http://www.gnu.org/software/make/manual/make.html
   8 #
   9
  10 #
  11 # Toolchain
  12 #
  13 # By default the VALID_TOOLCHAINS list contains pnacl, newlib and glibc.  If
  14 # your project only builds in one or the other then this should be overridden
  15 # accordingly.
  16 #
  17 ifneq ($(ENABLE_BIONIC),)
  18 ALL_TOOLCHAINS ?= pnacl newlib glibc clang-newlib bionic
  19 else
  20 ALL_TOOLCHAINS ?= pnacl newlib glibc clang-newlib
  21 endif
  22
  23 VALID_TOOLCHAINS ?= $(ALL_TOOLCHAINS)
  24 TOOLCHAIN ?= $(word 1,$(VALID_TOOLCHAINS))
  25
  26 #
  27 # Top Make file, which we want to trigger a rebuild on if it changes
  28 #
  29 TOP_MAKE := $(word 1,$(MAKEFILE_LIST))
  30
  31
  32 #
  33 # Figure out which OS we are running on.
  34 #
  35 GETOS := python $(NACL_SDK_ROOT)/tools/getos.py
  36 NACL_CONFIG := python $(NACL_SDK_ROOT)/tools/nacl_config.py
  37 FIXDEPS := python $(NACL_SDK_ROOT)/tools/fix_deps.py -c
  38 OSNAME := $(shell $(GETOS))
  39
  40
  41 #
  42 # TOOLCHAIN=all recursively calls this Makefile for all VALID_TOOLCHAINS.
  43 #
  44 ifeq ($(TOOLCHAIN),all)
  45
  46 # Define the default target
  47 all:
  48
  49 #
  50 # Generate a new MAKE command for each TOOLCHAIN.
  51 #
  52 # Note: We use targets for each toolchain (instead of an explicit recipe) so
  53 # each toolchain can be built in parallel.
  54 #
  55 # $1 = Toolchain Name
  56 #
  57 define TOOLCHAIN_RULE
  58 TOOLCHAIN_TARGETS += $(1)_TARGET
  59 .PHONY: $(1)_TARGET
  60 $(1)_TARGET:
  61         +$(MAKE) TOOLCHAIN=$(1) $(MAKECMDGOALS)
  62 endef
  63
  64 #
  65 # The target for all versions
  66 #
  67 USABLE_TOOLCHAINS=$(filter $(OSNAME) $(ALL_TOOLCHAINS),$(VALID_TOOLCHAINS))
  68
  69 ifeq ($(NO_HOST_BUILDS),1)
  70 USABLE_TOOLCHAINS:=$(filter-out $(OSNAME),$(USABLE_TOOLCHAINS))
  71 endif
  72
  73 # Define the toolchain targets for all usable toolchains via the macro.
  74 $(foreach tool,$(USABLE_TOOLCHAINS),$(eval $(call TOOLCHAIN_RULE,$(tool))))
  75
  76 .PHONY: all clean install
  77 all: $(TOOLCHAIN_TARGETS)
  78 clean: $(TOOLCHAIN_TARGETS)
  79 install: $(TOOLCHAIN_TARGETS)
  80
  81 else  # TOOLCHAIN=all
  82
  83 #
  84 # Verify we selected a valid toolchain for this example
  85 #
  86 ifeq (,$(findstring $(TOOLCHAIN),$(VALID_TOOLCHAINS)))
  87
  88 # Only fail to build if this is a top-level make. When building recursively, we
  89 # don't care if an example can't build with this toolchain.
  90 ifeq ($(MAKELEVEL),0)
  91   $(warning Availbile choices are: $(VALID_TOOLCHAINS))
  92   $(error Can not use TOOLCHAIN=$(TOOLCHAIN) on this example.)
  93 else
  94
  95 # Dummy targets for recursive make with unsupported toolchain...
  96 .PHONY: all clean install
  97 all:
  98 clean:
  99 install:
 100
 101 endif
 102
 103 else  # TOOLCHAIN is valid...
 104
 105 #
 106 # Build Configuration
 107 #
 108 # The SDK provides two sets of libraries, Debug and Release.  Debug libraries
 109 # are compiled without optimizations to make debugging easier.  By default
 110 # this will build a Release configuration. When debugging via "make debug",
 111 # build the debug configuration by default instead.
 112 #
 113 ifneq (,$(findstring debug,$(MAKECMDGOALS)))
 114 CONFIG ?= Debug
 115 else
 116 CONFIG ?= Release
 117 endif
 118
 119
 120 #
 121 # Verify we selected a valid configuration for this example.
 122 #
 123 VALID_CONFIGS ?= Debug Release
 124 ifeq (,$(findstring $(CONFIG),$(VALID_CONFIGS)))
 125   $(warning Availbile choices are: $(VALID_CONFIGS))
 126   $(error Can not use CONFIG=$(CONFIG) on this example.)
 127 endif
 128
 129
 130 #
 131 # Note for Windows:
 132 #   The GCC and LLVM toolchains (include the version of Make.exe that comes
 133 # with the SDK) expect and are capable of dealing with the '/' seperator.
 134 # For this reason, the tools in the SDK, including Makefiles and build scripts
 135 # have a preference for POSIX style command-line arguments.
 136 #
 137 # Keep in mind however that the shell is responsible for command-line escaping,
 138 # globbing, and variable expansion, so those may change based on which shell
 139 # is used.  For Cygwin shells this can include automatic and incorrect expansion
 140 # of response files (files starting with '@').
 141 #
 142 # Disable DOS PATH warning when using Cygwin based NaCl tools on Windows.
 143 #
 144 ifeq ($(OSNAME),win)
 145   # Always use cmd.exe as the shell on Windows. Otherwise Make may try to
 146   # search the path for sh.exe. If it is found in a path with a space, the
 147   # command will fail.
 148   SHELL := cmd.exe
 149   CYGWIN ?= nodosfilewarning
 150   export CYGWIN
 151 endif
 152
 153
 154 #
 155 # If NACL_SDK_ROOT is not already set, then set it relative to this makefile.
 156 #
 157 THIS_MAKEFILE := $(CURDIR)/$(lastword $(MAKEFILE_LIST))
 158 NACL_SDK_ROOT ?= $(realpath $(dir $(THIS_MAKEFILE))/..)
 159
 160
 161 #
 162 # Check that NACL_SDK_ROOT is set to a valid location.
 163 # We use the existence of tools/oshelpers.py to verify the validity of the SDK
 164 # root.
 165 #
 166 ifeq (,$(wildcard $(NACL_SDK_ROOT)/tools/oshelpers.py))
 167   $(error NACL_SDK_ROOT is set to an invalid location: $(NACL_SDK_ROOT))
 168 endif
 169
 170
 171 #
 172 # If this makefile is part of a valid nacl SDK, but NACL_SDK_ROOT is set
 173 # to a different location this is almost certainly a local configuration
 174 # error.
 175 #
 176 LOCAL_ROOT := $(realpath $(dir $(THIS_MAKEFILE))/..)
 177 ifneq (,$(wildcard $(LOCAL_ROOT)/tools/oshelpers.py))
 178   ifneq ($(realpath $(NACL_SDK_ROOT)), $(realpath $(LOCAL_ROOT)))
 179     $(error common.mk included from an SDK that does not match the current NACL_SDK_ROOT)
 180   endif
 181 endif
 182
 183
 184 #
 185 # Alias for standard POSIX file system commands
 186 #
 187 OSHELPERS = python $(NACL_SDK_ROOT)/tools/oshelpers.py
 188 WHICH := $(OSHELPERS) which
 189 ifdef V
 190 RM := $(OSHELPERS) rm
 191 CP := $(OSHELPERS) cp
 192 MKDIR := $(OSHELPERS) mkdir
 193 MV := $(OSHELPERS) mv
 194 else
 195 RM := @$(OSHELPERS) rm
 196 CP := @$(OSHELPERS) cp
 197 MKDIR := @$(OSHELPERS) mkdir
 198 MV := @$(OSHELPERS) mv
 199 endif
 200
 201
 202
 203 #
 204 # Compute path to requested NaCl Toolchain
 205 #
 206 TC_PATH := $(abspath $(NACL_SDK_ROOT)/toolchain)
 207
 208
 209 #
 210 # Check for required minimum SDK version.
 211 # A makefile can declare NACL_SDK_VERSION_MIN of the form "<major>.<position>",
 212 # where <major> is the major Chromium version number, and <position> is the
 213 # Chromium Cr-Commit-Position number. eg. "39.295386".
 214 #
 215 ifdef NACL_SDK_VERSION_MIN
 216   VERSION_CHECK:=$(shell $(GETOS) --check-version=$(NACL_SDK_VERSION_MIN) 2>&1)
 217   ifneq ($(VERSION_CHECK),)
 218     $(error $(VERSION_CHECK))
 219   endif
 220 endif
 221
 222
 223 #
 224 # The default target
 225 #
 226 # If no targets are specified on the command-line, the first target listed in
 227 # the makefile becomes the default target.  By convention this is usually called
 228 # the 'all' target.  Here we leave it blank to be first, but define it later
 229 #
 230 all:
 231 .PHONY: all
 232
 233
 234 #
 235 # The install target is used to install built libraries to thier final destination.
 236 # By default this is the NaCl SDK 'lib' folder.
 237 #
 238 install:
 239 .PHONY: install
 240
 241 ifdef SEL_LDR
 242 STANDALONE = 1
 243 endif
 244
 245 OUTBASE ?= .
 246 ifdef STANDALONE
 247 OUTDIR := $(OUTBASE)/$(TOOLCHAIN)/standalone_$(CONFIG)
 248 else
 249 OUTDIR := $(OUTBASE)/$(TOOLCHAIN)/$(CONFIG)
 250 endif
 251 STAMPDIR ?= $(OUTDIR)
 252 LIBDIR ?= $(NACL_SDK_ROOT)/lib
 253
 254
 255 #
 256 # Target to remove temporary files
 257 #
 258 .PHONY: clean
 259 clean:
 260         $(RM) -f $(TARGET).nmf
 261         $(RM) -rf $(OUTDIR)
 262         $(RM) -rf user-data-dir
 263
 264
 265 #
 266 # Rules for output directories.
 267 #
 268 # Output will be places in a directory name based on Toolchain and configuration
 269 # be default this will be "newlib/Debug".  We use a python wrapped MKDIR to
 270 # proivde a cross platform solution. The use of '|' checks for existance instead
 271 # of timestamp, since the directory can update when files change.
 272 #
 273 %dir.stamp :
 274         $(MKDIR) -p $(dir $@)
 275         @echo Directory Stamp > $@
 276
 277
 278 #
 279 # Dependency Macro
 280 #
 281 # $1 = Name of stamp
 282 # $2 = Directory for the sub-make
 283 # $3 = Extra Settings
 284 #
 285 define DEPEND_RULE
 286 ifndef IGNORE_DEPS
 287 .PHONY: rebuild_$(1)
 288
 289 rebuild_$(1) :| $(STAMPDIR)/dir.stamp
 290 ifeq (,$(2))
 291         +$(MAKE) -C $(NACL_SDK_ROOT)/src/$(1) STAMPDIR=$(abspath $(STAMPDIR)) $(abspath $(STAMPDIR)/$(1).stamp) $(3)
 292 else
 293         +$(MAKE) -C $(2) STAMPDIR=$(abspath $(STAMPDIR)) $(abspath $(STAMPDIR)/$(1).stamp) $(3)
 294 endif
 295
 296 all: rebuild_$(1)
 297 $(STAMPDIR)/$(1).stamp: rebuild_$(1)
 298
 299 else
 300
 301 .PHONY: $(STAMPDIR)/$(1).stamp
 302 $(STAMPDIR)/$(1).stamp:
 303         @echo Ignore $(1)
 304 endif
 305 endef
 306
 307 ifeq ($(TOOLCHAIN),win)
 308 ifdef STANDALONE
 309 HOST_EXT = .exe
 310 else
 311 HOST_EXT = .dll
 312 endif
 313 else
 314 ifdef STANDALONE
 315 HOST_EXT =
 316 else
 317 HOST_EXT = .so
 318 endif
 319 endif
 320
 321
 322 #
 323 # Common Compile Options
 324 #
 325 # For example, -DNDEBUG is added to release builds by default
 326 # so that calls to assert(3) are not included in the build.
 327 #
 328 ifeq ($(CONFIG),Release)
 329 POSIX_CFLAGS ?= -g -O2 -pthread -MMD -DNDEBUG
 330 NACL_LDFLAGS ?= -O2
 331 PNACL_LDFLAGS ?= -O2
 332 else
 333 POSIX_CFLAGS ?= -g -O0 -pthread -MMD -DNACL_SDK_DEBUG
 334 endif
 335
 336 NACL_CFLAGS ?= -Wno-long-long -Werror
 337 NACL_CXXFLAGS ?= -Wno-long-long -Werror
 338 NACL_LDFLAGS += -Wl,-as-needed -pthread
 339
 340 #
 341 # Default Paths
 342 #
 343 INC_PATHS := $(shell $(NACL_CONFIG) -t $(TOOLCHAIN) --include-dirs) $(EXTRA_INC_PATHS)
 344 LIB_PATHS := $(NACL_SDK_ROOT)/lib $(EXTRA_LIB_PATHS)
 345
 346 #
 347 # Define a LOG macro that allow a command to be run in quiet mode where
 348 # the command echoed is not the same as the actual command executed.
 349 # The primary use case for this is to avoid echoing the full compiler
 350 # and linker command in the default case.  Defining V=1 will restore
 351 # the verbose behavior
 352 #
 353 # $1 = The name of the tool being run
 354 # $2 = The target file being built
 355 # $3 = The full command to run
 356 #
 357 ifdef V
 358 define LOG
 359 $(3)
 360 endef
 361 else
 362 ifeq ($(OSNAME),win)
 363 define LOG
 364 @echo   $(1) $(2) && $(3)
 365 endef
 366 else
 367 define LOG
 368 @echo "  $(1) $(2)" && $(3)
 369 endef
 370 endif
 371 endif
 372
 373
 374 #
 375 # Convert a source path to a object file path.
 376 #
 377 # $1 = Source Name
 378 # $2 = Arch suffix
 379 #
 380 define SRC_TO_OBJ
 381 $(OUTDIR)/$(basename $(subst ..,__,$(1)))$(2).o
 382 endef
 383
 384
 385 #
 386 # Convert a source path to a dependency file path.
 387 # We use the .deps extension for dependencies.  These files are generated by
 388 # fix_deps.py based on the .d files which gcc generates.  We don't reference
 389 # the .d files directly so that we can avoid the the case where the compile
 390 # failed but still generated a .d file (in that case the .d file would not
 391 # be processed by fix_deps.py)
 392 #
 393 # $1 = Source Name
 394 # $2 = Arch suffix
 395 #
 396 define SRC_TO_DEP
 397 $(patsubst %.o,%.deps,$(call SRC_TO_OBJ,$(1),$(2)))
 398 endef
 399
 400 #
 401 # The gcc-generated deps files end in .d
 402 #
 403 define SRC_TO_DEP_PRE_FIXUP
 404 $(patsubst %.o,%.d,$(call SRC_TO_OBJ,$(1),$(2)))
 405 endef
 406
 407
 408 #
 409 # If the requested toolchain is a NaCl or PNaCl toolchain, the use the
 410 # macros and targets defined in nacl.mk, otherwise use the host sepecific
 411 # macros and targets.
 412 #
 413 ifneq (,$(findstring $(TOOLCHAIN),linux mac))
 414 include $(NACL_SDK_ROOT)/tools/host_gcc.mk
 415 endif
 416
 417 ifneq (,$(findstring $(TOOLCHAIN),win))
 418 include $(NACL_SDK_ROOT)/tools/host_vc.mk
 419 endif
 420
 421 ifneq (,$(findstring $(TOOLCHAIN),glibc newlib bionic clang-newlib))
 422 include $(NACL_SDK_ROOT)/tools/nacl_gcc.mk
 423 endif
 424
 425 ifneq (,$(findstring $(TOOLCHAIN),pnacl))
 426 include $(NACL_SDK_ROOT)/tools/nacl_llvm.mk
 427 endif
 428
 429 #
 430 # File to redirect to to in order to hide output.
 431 #
 432 ifeq ($(OSNAME),win)
 433 DEV_NULL = nul
 434 else
 435 DEV_NULL = /dev/null
 436 endif
 437
 438
 439 #
 440 # Variables for running examples with Chrome.
 441 #
 442 RUN_PY := python $(NACL_SDK_ROOT)/tools/run.py
 443 HTTPD_PY := python $(NACL_SDK_ROOT)/tools/httpd.py
 444
 445 # Add this to launch Chrome with additional environment variables defined.
 446 # Each element should be specified as KEY=VALUE, with whitespace separating
 447 # key-value pairs. e.g.
 448 # CHROME_ENV=FOO=1 BAR=2 BAZ=3
 449 CHROME_ENV ?=
 450
 451 # Additional arguments to pass to Chrome.
 452 CHROME_ARGS += --enable-nacl --enable-pnacl --no-first-run
 453 CHROME_ARGS += --user-data-dir=$(CURDIR)/user-data-dir
 454
 455
 456 # Paths to Debug and Release versions of the Host Pepper plugins
 457 PPAPI_DEBUG = $(abspath $(OSNAME)/Debug/$(TARGET)$(HOST_EXT));application/x-ppapi-debug
 458 PPAPI_RELEASE = $(abspath $(OSNAME)/Release/$(TARGET)$(HOST_EXT));application/x-ppapi-release
 459
 460
 461 SYSARCH := $(shell $(GETOS) --nacl-arch)
 462 SEL_LDR_PATH := python $(NACL_SDK_ROOT)/tools/sel_ldr.py
 463
 464 #
 465 # Common Compile Options
 466 #
 467 ifeq ($(CONFIG),Debug)
 468 SEL_LDR_ARGS += --debug-libs
 469 endif
 470
 471 ifndef STANDALONE
 472 #
 473 # Assign a sensible default to CHROME_PATH.
 474 #
 475 CHROME_PATH ?= $(shell $(GETOS) --chrome 2> $(DEV_NULL))
 476
 477 #
 478 # Verify we can find the Chrome executable if we need to launch it.
 479 #
 480
 481 NULL :=
 482 SPACE := $(NULL) # one space after NULL is required
 483 CHROME_PATH_ESCAPE := $(subst $(SPACE),\ ,$(CHROME_PATH))
 484
 485 ifeq ($(OSNAME),win)
 486   SANDBOX_ARGS := --no-sandbox
 487 endif
 488
 489 GDB_PATH := $(shell $(NACL_CONFIG) -t $(TOOLCHAIN) --tool=gdb)
 490
 491 .PHONY: check_for_chrome
 492 check_for_chrome:
 493 ifeq (,$(wildcard $(CHROME_PATH_ESCAPE)))
 494         $(warning No valid Chrome found at CHROME_PATH=$(CHROME_PATH))
 495         $(error Set CHROME_PATH via an environment variable, or command-line.)
 496 else
 497         $(warning Using chrome at: $(CHROME_PATH))
 498 endif
 499 PAGE ?= index.html
 500 PAGE_TC_CONFIG ?= "$(PAGE)?tc=$(TOOLCHAIN)&config=$(CONFIG)"
 501
 502 .PHONY: run
 503 run: check_for_chrome all $(PAGE)
 504         $(RUN_PY) -C $(CURDIR) -P $(PAGE_TC_CONFIG) \
 505             $(addprefix -E ,$(CHROME_ENV)) -- "$(CHROME_PATH)" \
 506             $(CHROME_ARGS) \
 507             --register-pepper-plugins="$(PPAPI_DEBUG),$(PPAPI_RELEASE)"
 508
 509 .PHONY: run_package
 510 run_package: check_for_chrome all
 511         @echo "$(TOOLCHAIN) $(CONFIG)" > $(CURDIR)/run_package_config
 512         "$(CHROME_PATH)" --load-and-launch-app=$(CURDIR) $(CHROME_ARGS)
 513
 514 GDB_ARGS += -D $(GDB_PATH)
 515 # PNaCl's nexe is acquired with "remote get nexe <path>" instead of the NMF.
 516 ifeq (,$(findstring $(TOOLCHAIN),pnacl))
 517 GDB_ARGS += -D --eval-command="nacl-manifest $(abspath $(OUTDIR))/$(TARGET).nmf"
 518 GDB_ARGS += -D $(GDB_DEBUG_TARGET)
 519 endif
 520
 521 .PHONY: debug
 522 debug: check_for_chrome all $(PAGE)
 523         $(RUN_PY) $(GDB_ARGS) \
 524             -C $(CURDIR) -P $(PAGE_TC_CONFIG) \
 525             $(addprefix -E ,$(CHROME_ENV)) -- "$(CHROME_PATH)" \
 526             $(CHROME_ARGS) $(SANDBOX_ARGS) --enable-nacl-debug \
 527             --register-pepper-plugins="$(PPAPI_DEBUG),$(PPAPI_RELEASE)"
 528
 529 .PHONY: serve
 530 serve: all
 531         $(HTTPD_PY) -C $(CURDIR)
 532 endif
 533
 534 # uppercase aliases (for backward compatibility)
 535 .PHONY: CHECK_FOR_CHROME DEBUG LAUNCH RUN
 536 CHECK_FOR_CHROME: check_for_chrome
 537 DEBUG: debug
 538 LAUNCH: run
 539 RUN: run
 540
 541 endif  # TOOLCHAIN is valid...
 542
 543 endif  # TOOLCHAIN=all