-include config.mk

BUILDTYPE ?= Release

PYTHON ?= python

DESTDIR ?=

SIGN ?=

PREFIX ?= /usr/local

FLAKY_TESTS ?= run

TEST_CI_ARGS ?=

STAGINGSERVER ?= node-www

LOGLEVEL ?= silent

OSTYPE := $(shell uname -s | tr '[A-Z]' '[a-z]')

COVTESTS ?= test-cov

GTEST_FILTER ?= "*"

GNUMAKEFLAGS += --no-print-directory

GCOV ?= gcov

PWD = $(CURDIR)

ifdef JOBS

PARALLEL_ARGS = -j $(JOBS)

else

PARALLEL_ARGS = -J

endif

ifdef ENABLE_V8_TAP

TAP_V8 := --junitout $(PWD)/v8-tap.xml

TAP_V8_INTL := --junitout $(PWD)/v8-intl-tap.xml

TAP_V8_BENCHMARKS := --junitout $(PWD)/v8-benchmarks-tap.xml

endif

V8_TEST_OPTIONS = $(V8_EXTRA_TEST_OPTIONS)

ifdef DISABLE_V8_I18N

V8_BUILD_OPTIONS += i18nsupport=off

endif

ifeq ($(OSTYPE), darwin)

GCOV = xcrun llvm-cov gcov

endif

BUILDTYPE_LOWER := $(shell echo $(BUILDTYPE) | tr '[A-Z]' '[a-z]')

# Determine EXEEXT

EXEEXT := $(shell $(PYTHON) -c \

"import sys; print('.exe' if sys.platform == 'win32' else '')")

NODE_EXE = node$(EXEEXT)

NODE ?= ./$(NODE_EXE)

NODE_G_EXE = node_g$(EXEEXT)

NPM ?= ./deps/npm/bin/npm-cli.js

# Flags for packaging.

BUILD_DOWNLOAD_FLAGS ?= --download=all

BUILD_INTL_FLAGS ?= --with-intl=small-icu

BUILD_RELEASE_FLAGS ?= $(BUILD_DOWNLOAD_FLAGS) $(BUILD_INTL_FLAGS)

# Default to verbose builds.

# To do quiet/pretty builds, run `make V=` to set V to an empty string,

# or set the V environment variable to an empty string.

V ?= 1

.PHONY: all

# BUILDTYPE=Debug builds both release and debug builds. If you want to compile

# just the debug build, run `make -C out BUILDTYPE=Debug` instead.

ifeq ($(BUILDTYPE),Release)

all: out/Makefile $(NODE_EXE) ## Default target, builds node in out/Release/node.

else

all: out/Makefile $(NODE_EXE) $(NODE_G_EXE)

endif

.PHONY: help

# To add a target to the help, add a double comment (##) on the target line.

help: ## Print help for targets with comments.

@printf "For more targets and info see the comments in the Makefile.\n\n"

@grep -E '^[a-zA-Z0-9._-]+:.*?## .*$$' Makefile | sort | \

awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}'

# The .PHONY is needed to ensure that we recursively use the out/Makefile

# to check for changes.

.PHONY: $(NODE_EXE) $(NODE_G_EXE)

# The -r/-L check stops it recreating the link if it is already in place,

# otherwise $(NODE_EXE) being a .PHONY target means it is always re-run.

# Without the check there is a race condition between the link being deleted

# and recreated which can break the addons build when running test-ci

# See comments on the build-addons target for some more info

$(NODE_EXE): config.gypi out/Makefile

$(MAKE) -C out BUILDTYPE=Release V=$(V)

if [ ! -r $@ -o ! -L $@ ]; then ln -fs out/Release/$(NODE_EXE) $@; fi

$(NODE_G_EXE): config.gypi out/Makefile

$(MAKE) -C out BUILDTYPE=Debug V=$(V)

if [ ! -r $@ -o ! -L $@ ]; then ln -fs out/Debug/$(NODE_EXE) $@; fi

CODE_CACHE_DIR ?= out/$(BUILDTYPE)/obj/gen

CODE_CACHE_FILE ?= $(CODE_CACHE_DIR)/node_code_cache.cc

ifeq ($(BUILDTYPE),Debug)

CONFIG_FLAGS += --debug

endif

.PHONY: with-code-cache

with-code-cache:

@echo $(CONFIG_FLAGS)

$(PYTHON) ./configure $(CONFIG_FLAGS)

$(MAKE)

mkdir -p $(CODE_CACHE_DIR)

out/$(BUILDTYPE)/$(NODE_EXE) --expose-internals tools/generate_code_cache.js $(CODE_CACHE_FILE)

$(PYTHON) ./configure --code-cache-path $(CODE_CACHE_FILE) $(CONFIG_FLAGS)

$(MAKE)

.PHONY: test-code-cache

test-code-cache: with-code-cache

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) code-cache

out/Makefile: common.gypi deps/uv/uv.gyp deps/http_parser/http_parser.gyp \

deps/zlib/zlib.gyp deps/v8/gypfiles/toolchain.gypi \

deps/v8/gypfiles/features.gypi deps/v8/gypfiles/v8.gyp node.gyp \

config.gypi

$(PYTHON) tools/gyp_node.py -f make

config.gypi: configure

@if [ -x config.status ]; then \

./config.status; \

else \

echo Missing or stale $@, please run ./$<; \

exit 1; \

fi

.PHONY: install

install: all ## Installs node into $PREFIX (default=/usr/local).

$(PYTHON) tools/install.py $@ '$(DESTDIR)' '$(PREFIX)'

.PHONY: uninstall

uninstall: ## Uninstalls node from $PREFIX (default=/usr/local).

$(PYTHON) tools/install.py $@ '$(DESTDIR)' '$(PREFIX)'

.PHONY: clean

clean: ## Remove build artifacts.

$(RM) -r out/Makefile $(NODE_EXE) $(NODE_G_EXE) out/$(BUILDTYPE)/$(NODE_EXE) \

out/$(BUILDTYPE)/node.exp

@if [ -d out ]; then find out/ -name '*.o' -o -name '*.a' -o -name '*.d' | xargs $(RM) -r; fi

$(RM) -r node_modules

@if [ -d deps/icu ]; then echo deleting deps/icu; $(RM) -r deps/icu; fi

$(RM) test.tap

# Next one is legacy remove this at some point

$(RM) -r test/tmp*

$(RM) -r test/.tmp*

$(MAKE) test-addons-clean

$(MAKE) bench-addons-clean

.PHONY: distclean

distclean:

$(RM) -r out

$(RM) config.gypi icu_config.gypi config_fips.gypi

$(RM) config.mk

$(RM) -r $(NODE_EXE) $(NODE_G_EXE)

$(RM) -r node_modules

$(RM) -r deps/icu

$(RM) -r deps/icu4c*.tgz deps/icu4c*.zip deps/icu-tmp

$(RM) $(BINARYTAR).* $(TARBALL).*

.PHONY: check

check: test

.PHONY: coverage-clean

# Remove files generated by running coverage, put the non-instrumented lib back

# in place

coverage-clean:

if [ -d lib_ ]; then $(RM) -r lib; mv lib_ lib; fi

$(RM) -r node_modules

$(RM) -r gcovr build

$(RM) -r out/$(BUILDTYPE)/.coverage

$(RM) -r .cov_tmp

$(RM) out/$(BUILDTYPE)/obj.target/node/gen/*.gcda

$(RM) out/$(BUILDTYPE)/obj.target/node/src/*.gcda

$(RM) out/$(BUILDTYPE)/obj.target/node/src/tracing/*.gcda

$(RM) out/$(BUILDTYPE)/obj.target/node/gen/*.gcno

$(RM) out/$(BUILDTYPE)/obj.target/node/src/*.gcno

$(RM) out/$(BUILDTYPE)/obj.target/node/src/tracing/*.gcno

$(RM) out/$(BUILDTYPE)/obj.target/cctest/src/*.gcno

$(RM) out/$(BUILDTYPE)/obj.target/cctest/test/cctest/*.gcno

.PHONY: coverage

# Build and test with code coverage reporting. Leave the lib directory

# instrumented for any additional runs the user may want to make.

# For C++ coverage reporting, this needs to be run in conjunction with configure

# --coverage. html coverage reports will be created under coverage/

# Related CI job: node-test-commit-linux-coverage

coverage: coverage-test ## Run the tests and generate a coverage report.

.PHONY: coverage-build

coverage-build: all

mkdir -p node_modules

if [ ! -d node_modules/nyc ]; then \

$(NODE) ./deps/npm install nyc --no-save --no-package-lock; fi

if [ ! -d gcovr ]; then git clone -b 3.4 --depth=1 \

--single-branch git://github.com/gcovr/gcovr.git; fi

if [ ! -d build ]; then git clone --depth=1 \

--single-branch https://github.com/nodejs/build.git; fi

if [ ! -f gcovr/scripts/gcovr.orig ]; then \

(cd gcovr && patch -N -p1 < \

"$(CURDIR)/build/jenkins/scripts/coverage/gcovr-patches-3.4.diff"); fi

if [ -d lib_ ]; then $(RM) -r lib; mv lib_ lib; fi

mv lib lib_

NODE_DEBUG=nyc $(NODE) ./node_modules/.bin/nyc instrument --extension .js \

--extension .mjs --exit-on-error lib_/ lib/

$(MAKE)

.PHONY: coverage-test

coverage-test: coverage-build

$(RM) -r out/$(BUILDTYPE)/.coverage

$(RM) -r .cov_tmp

$(RM) out/$(BUILDTYPE)/obj.target/node/gen/*.gcda

$(RM) out/$(BUILDTYPE)/obj.target/node/src/*.gcda

$(RM) out/$(BUILDTYPE)/obj.target/node/src/tracing/*.gcda

$(RM) out/$(BUILDTYPE)/obj.target/node_lib/gen/*.gcda

$(RM) out/$(BUILDTYPE)/obj.target/node_lib/src/*.gcda

$(RM) out/$(BUILDTYPE)/obj.target/node_lib/src/tracing/*.gcda

-$(MAKE) $(COVTESTS)

mv lib lib__

mv lib_ lib

mkdir -p coverage .cov_tmp

$(NODE) ./node_modules/.bin/nyc merge 'out/Release/.coverage' \

.cov_tmp/libcov.json

(cd lib && .$(NODE) ../node_modules/.bin/nyc report \

--temp-directory "$(CURDIR)/.cov_tmp" \

--report-dir "$(CURDIR)/coverage")

-(cd out && "../gcovr/scripts/gcovr" --gcov-exclude='.*deps' \

--gcov-exclude='.*usr' -v -r Release/obj.target \

--html --html-detail -o ../coverage/cxxcoverage.html \

--gcov-executable="$(GCOV)")

mv lib lib_

mv lib__ lib

@echo -n "Javascript coverage %: "

@grep -B1 Lines coverage/index.html | head -n1 \

| sed 's/<[^>]*>//g'| sed 's/ //g'

@echo -n "C++ coverage %: "

@grep -A3 Lines coverage/cxxcoverage.html | grep style \

| sed 's/<[^>]*>//g'| sed 's/ //g'

.PHONY: cctest

# Runs the C++ tests using the built `cctest` executable.

cctest: all

@out/$(BUILDTYPE)/$@ --gtest_filter=$(GTEST_FILTER)

.PHONY: list-gtests

list-gtests:

ifeq (,$(wildcard out/$(BUILDTYPE)/cctest))

$(error Please run 'make cctest' first)

endif

@out/$(BUILDTYPE)/cctest --gtest_list_tests

.PHONY: v8

# Related CI job: node-test-commit-v8-linux

# Rebuilds deps/v8 as a git tree, pulls its third-party dependencies, and

# builds it.

v8:

tools/make-v8.sh $(V8_ARCH).$(BUILDTYPE_LOWER) $(V8_BUILD_OPTIONS)

.PHONY: jstest

jstest: build-addons build-addons-napi ## Runs addon tests and JS tests

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) \

--skip-tests=$(CI_SKIP_TESTS) \

$(CI_JS_SUITES) \

$(CI_NATIVE_SUITES)

.PHONY: test

# This does not run tests of third-party libraries inside deps.

test: all ## Runs default tests, linters, and builds docs.

# Build the addons before running the tests so the test results

# can be displayed together

$(MAKE) -s build-addons

$(MAKE) -s build-addons-napi

$(MAKE) -s cctest

$(MAKE) -s jstest

.PHONY: test-only

test-only: all ## For a quick test, does not run linter or build docs.

# Build the addons before running the tests so the test results

# can be displayed together

$(MAKE) build-addons

$(MAKE) build-addons-napi

$(MAKE) cctest

$(MAKE) jstest

# Used by `make coverage-test`

test-cov: all

# Build the addons before running the tests so the test results

# can be displayed together

$(MAKE) build-addons

$(MAKE) build-addons-napi

# $(MAKE) cctest

CI_SKIP_TESTS=core_line_numbers.js $(MAKE) jstest

test-parallel: all

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) parallel

test-valgrind: all

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) --valgrind sequential parallel message

test-check-deopts: all

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) --check-deopts parallel sequential

benchmark/napi/function_call/build/Release/binding.node: all \

benchmark/napi/function_call/napi_binding.c \

benchmark/napi/function_call/binding.cc \

benchmark/napi/function_call/binding.gyp

$(NODE) deps/npm/node_modules/node-gyp/bin/node-gyp rebuild \

--python="$(PYTHON)" \

--directory="$(shell pwd)/benchmark/napi/function_call" \

--nodedir="$(shell pwd)"

benchmark/napi/function_args/build/Release/binding.node: all \

benchmark/napi/function_args/napi_binding.c \

benchmark/napi/function_args/binding.cc \

benchmark/napi/function_args/binding.gyp

$(NODE) deps/npm/node_modules/node-gyp/bin/node-gyp rebuild \

--python="$(PYTHON)" \

--directory="$(shell pwd)/benchmark/napi/function_args" \

--nodedir="$(shell pwd)"

DOCBUILDSTAMP_PREREQS = tools/doc/addon-verify.js doc/api/addons.md

ifeq ($(OSTYPE),aix)

DOCBUILDSTAMP_PREREQS := $(DOCBUILDSTAMP_PREREQS) out/$(BUILDTYPE)/node.exp

endif

node_use_openssl = $(shell $(call available-node,"-p" \

"process.versions.openssl != undefined"))

test/addons/.docbuildstamp: $(DOCBUILDSTAMP_PREREQS) tools/doc/node_modules

ifeq ($(node_use_openssl),true)

$(RM) -r test/addons/??_*/

[ -x $(NODE) ] && $(NODE) $< || node $<

touch $@

else

@echo "Skipping .docbuildstamp (no crypto)"

endif

ADDONS_BINDING_GYPS := \

$(filter-out test/addons/??_*/binding.gyp, \

$(wildcard test/addons/*/binding.gyp))

ADDONS_BINDING_SOURCES := \

$(filter-out test/addons/??_*/*.cc, $(wildcard test/addons/*/*.cc)) \

$(filter-out test/addons/??_*/*.h, $(wildcard test/addons/*/*.h))

ADDONS_PREREQS := config.gypi \

deps/npm/node_modules/node-gyp/package.json tools/build-addons.js \

deps/uv/include/*.h deps/v8/include/*.h \

src/node.h src/node_buffer.h src/node_object_wrap.h src/node_version.h

define run_build_addons

env npm_config_loglevel=$(LOGLEVEL) npm_config_nodedir="$$PWD" \

npm_config_python="$(PYTHON)" $(NODE) "$$PWD/tools/build-addons" \

"$$PWD/deps/npm/node_modules/node-gyp/bin/node-gyp.js" \

$1

touch $2

endef

# Implicitly depends on $(NODE_EXE), see the build-addons rule for rationale.

# Depends on node-gyp package.json so that build-addons is (re)executed when

# node-gyp is updated as part of an npm update.

test/addons/.buildstamp: $(ADDONS_PREREQS) \

$(ADDONS_BINDING_GYPS) $(ADDONS_BINDING_SOURCES) \

test/addons/.docbuildstamp

@$(call run_build_addons,"$$PWD/test/addons",$@)

.PHONY: build-addons

# .buildstamp needs $(NODE_EXE) but cannot depend on it

# directly because it calls make recursively. The parent make cannot know

# if the subprocess touched anything so it pessimistically assumes that

# .buildstamp is out of date and need a rebuild.

# Just goes to show that recursive make really is harmful...

# TODO(bnoordhuis) Force rebuild after gyp update.

build-addons: | $(NODE_EXE) test/addons/.buildstamp

ADDONS_NAPI_BINDING_GYPS := \

$(filter-out test/addons-napi/??_*/binding.gyp, \

$(wildcard test/addons-napi/*/binding.gyp))

ADDONS_NAPI_BINDING_SOURCES := \

$(filter-out test/addons-napi/??_*/*.c, $(wildcard test/addons-napi/*/*.c)) \

$(filter-out test/addons-napi/??_*/*.cc, $(wildcard test/addons-napi/*/*.cc)) \

$(filter-out test/addons-napi/??_*/*.h, $(wildcard test/addons-napi/*/*.h))

# Implicitly depends on $(NODE_EXE), see the build-addons-napi rule for rationale.

test/addons-napi/.buildstamp: $(ADDONS_PREREQS) \

$(ADDONS_NAPI_BINDING_GYPS) $(ADDONS_NAPI_BINDING_SOURCES) \

src/node_api.h src/node_api_types.h

@$(call run_build_addons,"$$PWD/test/addons-napi",$@)

.PHONY: build-addons-napi

# .buildstamp needs $(NODE_EXE) but cannot depend on it

# directly because it calls make recursively. The parent make cannot know

# if the subprocess touched anything so it pessimistically assumes that

# .buildstamp is out of date and need a rebuild.

# Just goes to show that recursive make really is harmful...

# TODO(bnoordhuis) Force rebuild after gyp or node-gyp update.

build-addons-napi: | $(NODE_EXE) test/addons-napi/.buildstamp

.PHONY: clear-stalled

clear-stalled:

# Clean up any leftover processes but don't error if found.

ps awwx | grep Release/node | grep -v grep | cat

@PS_OUT=`ps awwx | grep Release/node | grep -v grep | awk '{print $$1}'`; \

if [ "$${PS_OUT}" ]; then \

echo $${PS_OUT} | xargs kill -9; \

fi

test-build: | all build-addons build-addons-napi

test-build-addons-napi: all build-addons-napi

.PHONY: test-all

test-all: test-build ## Run everything in test/.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=debug,release

test-all-valgrind: test-build

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=debug,release --valgrind

CI_NATIVE_SUITES ?= addons addons-napi

CI_JS_SUITES ?= default

CI_DOC := doctool

.PHONY: test-ci-native

# Build and test addons without building anything else

# Related CI job: node-test-commit-arm-fanned

test-ci-native: LOGLEVEL := info

test-ci-native: | test/addons/.buildstamp test/addons-napi/.buildstamp

$(PYTHON) tools/test.py $(PARALLEL_ARGS) -p tap --logfile test.tap \

--mode=$(BUILDTYPE_LOWER) --flaky-tests=$(FLAKY_TESTS) \

$(TEST_CI_ARGS) $(CI_NATIVE_SUITES)

.PHONY: test-ci-js

# This target should not use a native compiler at all

# Related CI job: node-test-commit-arm-fanned

test-ci-js: | clear-stalled

$(PYTHON) tools/test.py $(PARALLEL_ARGS) -p tap --logfile test.tap \

--mode=$(BUILDTYPE_LOWER) --flaky-tests=$(FLAKY_TESTS) \

$(TEST_CI_ARGS) $(CI_JS_SUITES)

# Clean up any leftover processes, error if found.

ps awwx | grep Release/node | grep -v grep | cat

@PS_OUT=`ps awwx | grep Release/node | grep -v grep | awk '{print $$1}'`; \

if [ "$${PS_OUT}" ]; then \

echo $${PS_OUT} | xargs kill -9; exit 1; \

fi

.PHONY: test-ci

# Related CI jobs: most CI tests, excluding node-test-commit-arm-fanned

test-ci: LOGLEVEL := info

test-ci: | clear-stalled build-addons build-addons-napi doc-only

out/Release/cctest --gtest_output=tap:cctest.tap

$(PYTHON) tools/test.py $(PARALLEL_ARGS) -p tap --logfile test.tap \

--mode=$(BUILDTYPE_LOWER) --flaky-tests=$(FLAKY_TESTS) \

$(TEST_CI_ARGS) $(CI_JS_SUITES) $(CI_NATIVE_SUITES) $(CI_DOC)

# Clean up any leftover processes, error if found.

ps awwx | grep Release/node | grep -v grep | cat

@PS_OUT=`ps awwx | grep Release/node | grep -v grep | awk '{print $$1}'`; \

if [ "$${PS_OUT}" ]; then \

echo $${PS_OUT} | xargs kill -9; exit 1; \

fi

.PHONY: build-ci

# Prepare the build for running the tests.

# Related CI jobs: most CI tests, excluding node-test-commit-arm-fanned

build-ci:

$(PYTHON) ./configure $(CONFIG_FLAGS)

$(MAKE)

.PHONY: run-ci

# Run by CI tests, exceptions:

# - node-test-commit-arm-fanned (Raspberry Pis), where the binaries are

# cross-compiled, then transferred elsewhere to run different subsets

# of tests. See `test-ci-native` and `test-ci-js`.

# - node-test-commit-linux-coverage: where the build and the tests need

# to be instrumented, see `coverage`.

run-ci: build-ci

$(MAKE) test-ci

test-release: test-build

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER)

test-debug: test-build

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=debug

test-message: test-build

$(PYTHON) tools/test.py $(PARALLEL_ARGS) message

test-simple: | cctest # Depends on 'all'.

$(PYTHON) tools/test.py $(PARALLEL_ARGS) parallel sequential

test-pummel: all

$(PYTHON) tools/test.py $(PARALLEL_ARGS) pummel

test-internet: all

$(PYTHON) tools/test.py $(PARALLEL_ARGS) internet

test-node-inspect: $(NODE_EXE)

USE_EMBEDDED_NODE_INSPECT=1 $(NODE) tools/test-npm-package \

--install deps/node-inspect test

test-tick-processor: all

$(PYTHON) tools/test.py $(PARALLEL_ARGS) tick-processor

.PHONY: test-hash-seed

# Verifies the hash seed used by V8 for hashing is random.

test-hash-seed: all

$(NODE) test/pummel/test-hash-seed.js

.PHONY: test-doc

test-doc: doc-only ## Builds, lints, and verifies the docs.

$(MAKE) lint

$(PYTHON) tools/test.py $(PARALLEL_ARGS) $(CI_DOC)

test-known-issues: all

$(PYTHON) tools/test.py $(PARALLEL_ARGS) known_issues

# Related CI job: node-test-npm

test-npm: $(NODE_EXE) ## Run the npm test suite on deps/npm.

$(NODE) tools/test-npm-package --install --logfile=test-npm.tap deps/npm test-node

test-npm-publish: $(NODE_EXE)

npm_package_config_publishtest=true $(NODE) deps/npm/test/run.js

.PHONY: test-addons-napi

test-addons-napi: test-build-addons-napi

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) addons-napi

.PHONY: test-addons-napi-clean

test-addons-napi-clean:

$(RM) -r test/addons-napi/*/build

$(RM) test/addons-napi/.buildstamp

.PHONY: test-addons

test-addons: test-build test-addons-napi

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) addons

.PHONY: test-addons-clean

test-addons-clean:

$(RM) -r test/addons/??_*/

$(RM) -r test/addons/*/build

$(RM) test/addons/.buildstamp test/addons/.docbuildstamp

$(MAKE) test-addons-napi-clean

test-async-hooks:

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) async-hooks

test-with-async-hooks:

$(MAKE) build-addons

$(MAKE) build-addons-napi

$(MAKE) cctest

NODE_TEST_WITH_ASYNC_HOOKS=1 $(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) \

$(CI_JS_SUITES) \

$(CI_NATIVE_SUITES)

.PHONY: test-v8

.PHONY: test-v8-all

.PHONY: test-v8-benchmarks

.PHONY: test-v8-intl

.PHONY: test-v8-updates

ifneq ("","$(wildcard deps/v8/tools/run-tests.py)")

# Related CI job: node-test-commit-v8-linux

test-v8: v8 ## Runs the V8 test suite on deps/v8.

deps/v8/tools/run-tests.py --gn --arch=$(V8_ARCH) \

--mode=$(BUILDTYPE_LOWER) $(V8_TEST_OPTIONS) \

mjsunit cctest debugger inspector message preparser \

$(TAP_V8)

@echo Testing hash seed

$(MAKE) test-hash-seed

test-v8-intl: v8

deps/v8/tools/run-tests.py --gn --arch=$(V8_ARCH) \

--mode=$(BUILDTYPE_LOWER) intl \

$(TAP_V8_INTL)

test-v8-benchmarks: v8

deps/v8/tools/run-tests.py --gn --arch=$(V8_ARCH) --mode=$(BUILDTYPE_LOWER) \

benchmarks \

$(TAP_V8_BENCHMARKS)

test-v8-updates:

$(PYTHON) tools/test.py $(PARALLEL_ARGS) --mode=$(BUILDTYPE_LOWER) v8-updates

test-v8-all: test-v8 test-v8-intl test-v8-benchmarks test-v8-updates

# runs all v8 tests

else

test-v8 test-v8-intl test-v8-benchmarks test-v8-all:

@echo "Testing v8 is not available through the source tarball."

@echo "Use the git repo instead:" \

"$ git clone https://github.com/nodejs/node.git"

endif

# Google Analytics ID used for tracking API docs page views, empty

# DOCS_ANALYTICS means no tracking scripts will be included in the

# generated .html files

DOCS_ANALYTICS ?=

apidoc_dirs = out/doc out/doc/api out/doc/api/assets

apidoc_sources = $(wildcard doc/api/*.md)

apidocs_html = $(addprefix out/,$(apidoc_sources:.md=.html))

apidocs_json = $(addprefix out/,$(apidoc_sources:.md=.json))

apiassets = $(subst api_assets,api/assets,$(addprefix out/,$(wildcard doc/api_assets/*)))

.PHONY: doc-only

doc-only: tools/doc/node_modules \

$(apidoc_dirs) $(apiassets) ## Builds the docs with the local or the global Node.js binary.

@$(MAKE) out/doc/api/all.html out/doc/api/all.json

.PHONY: doc

doc: $(NODE_EXE) doc-only

out/doc:

mkdir -p $@

# If it's a source tarball, doc/api already contains the generated docs.

# Just copy everything under doc/api over.

out/doc/api: doc/api

mkdir -p $@

cp -r doc/api out/doc

# If it's a source tarball, assets are already in doc/api/assets

out/doc/api/assets:

mkdir -p $@

if [ -d doc/api/assets ]; then cp -r doc/api/assets out/doc/api; fi;

# If it's not a source tarball, we need to copy assets from doc/api_assets

out/doc/api/assets/%: doc/api_assets/% out/doc/api/assets

@cp $< $@

# Use -e to double check in case it's a broken link

# Use $(PWD) so we can cd to anywhere before calling this

available-node = \

if [ -x $(PWD)/$(NODE) ] && [ -e $(PWD)/$(NODE) ]; then \

$(PWD)/$(NODE) $(1); \

elif [ -x `which node` ] && [ -e `which node` ] && [ `which node` ]; then \

`which node` $(1); \

else \

echo "No available node, cannot run \"node $(1)\""; \

exit 1; \

fi;

run-npm-install = $(PWD)/$(NPM) install --production --no-package-lock

run-npm-ci = $(PWD)/$(NPM) ci

tools/doc/node_modules/js-yaml/package.json:

cd tools/doc && $(call available-node,$(run-npm-install))

gen-api = tools/doc/generate.js --node-version=$(FULLVERSION) \

--analytics=$(DOCS_ANALYTICS) $< --output-directory=out/doc/api

out/doc/api/%.json out/doc/api/%.html: doc/api/%.md tools/doc/generate.js \

tools/doc/html.js tools/doc/json.js

$(call available-node, $(gen-api))

out/doc/api/all.html: $(apidocs_html) tools/doc/allhtml.js

$(call available-node, tools/doc/allhtml.js)

out/doc/api/all.json: $(apidocs_json) tools/doc/alljson.js

$(call available-node, tools/doc/alljson.js)

.PHONY: docopen

docopen: $(apidocs_html)

@$(PYTHON) -mwebbrowser file://$(PWD)/out/doc/api/all.html

.PHONY: docclean

docclean:

$(RM) -r out/doc

RAWVER=$(shell $(PYTHON) tools/getnodeversion.py)

VERSION=v$(RAWVER)

# For nightly builds, you must set DISTTYPE to "nightly", "next-nightly" or

# "custom". For the nightly and next-nightly case, you need to set DATESTRING

# and COMMIT in order to properly name the build.

# For the rc case you need to set CUSTOMTAG to an appropriate CUSTOMTAG number

ifndef DISTTYPE

DISTTYPE=release

endif

ifeq ($(DISTTYPE),release)

FULLVERSION=$(VERSION)

else # ifeq ($(DISTTYPE),release)

ifeq ($(DISTTYPE),custom)

ifndef CUSTOMTAG

$(error CUSTOMTAG is not set for DISTTYPE=custom)

endif # ifndef CUSTOMTAG

TAG=$(CUSTOMTAG)

else # ifeq ($(DISTTYPE),custom)

ifndef DATESTRING

$(error DATESTRING is not set for nightly)

endif # ifndef DATESTRING

ifndef COMMIT

$(error COMMIT is not set for nightly)

endif # ifndef COMMIT

ifneq ($(DISTTYPE),nightly)

ifneq ($(DISTTYPE),next-nightly)

$(error DISTTYPE is not release, custom, nightly or next-nightly)

endif # ifneq ($(DISTTYPE),next-nightly)

endif # ifneq ($(DISTTYPE),nightly)

TAG=$(DISTTYPE)$(DATESTRING)$(COMMIT)

endif # ifeq ($(DISTTYPE),custom)

FULLVERSION=$(VERSION)-$(TAG)

endif # ifeq ($(DISTTYPE),release)

DISTTYPEDIR ?= $(DISTTYPE)

RELEASE=$(shell sed -ne 's/\#define NODE_VERSION_IS_RELEASE \([01]\)/\1/p' src/node_version.h)

PLATFORM=$(shell uname | tr '[:upper:]' '[:lower:]')

NPMVERSION=v$(shell cat deps/npm/package.json | grep '"version"' | sed 's/^[^:]*: "\([^"]*\)",.*/\1/')

UNAME_M=$(shell uname -m)

ifeq ($(findstring x86_64,$(UNAME_M)),x86_64)

DESTCPU ?= x64

else

ifeq ($(findstring ppc64,$(UNAME_M)),ppc64)

DESTCPU ?= ppc64

else

ifeq ($(findstring ppc,$(UNAME_M)),ppc)

DESTCPU ?= ppc

else

ifeq ($(findstring s390x,$(UNAME_M)),s390x)

DESTCPU ?= s390x

else

ifeq ($(findstring s390,$(UNAME_M)),s390)

DESTCPU ?= s390

else

ifeq ($(findstring arm,$(UNAME_M)),arm)

DESTCPU ?= arm

else

ifeq ($(findstring aarch64,$(UNAME_M)),aarch64)

DESTCPU ?= aarch64

else

ifeq ($(findstring powerpc,$(shell uname -p)),powerpc)

DESTCPU ?= ppc64

else

DESTCPU ?= x86

endif

endif

endif

endif

endif

endif

endif

endif

ifeq ($(DESTCPU),x64)

ARCH=x64

else

ifeq ($(DESTCPU),arm)

ARCH=arm

else

ifeq ($(DESTCPU),aarch64)

ARCH=arm64

else

ifeq ($(DESTCPU),ppc64)

ARCH=ppc64

else

ifeq ($(DESTCPU),ppc)

ARCH=ppc

else

ifeq ($(DESTCPU),s390)

ARCH=s390

else

ifeq ($(DESTCPU),s390x)

ARCH=s390x

else

ARCH=x86

endif

endif

endif

endif

endif

endif

endif

# node and v8 use different arch names (e.g. node 'x86' vs v8 'ia32').

# pass the proper v8 arch name to $V8_ARCH based on user-specified $DESTCPU.

ifeq ($(DESTCPU),x86)

V8_ARCH=ia32

else

V8_ARCH ?= $(DESTCPU)

endif

# enforce "x86" over "ia32" as the generally accepted way of referring to 32-bit intel

ifeq ($(ARCH),ia32)

override ARCH=x86

endif

ifeq ($(DESTCPU),ia32)

override DESTCPU=x86

endif

TARNAME=node-$(FULLVERSION)

TARBALL=$(TARNAME).tar

# Custom user-specified variation, use it directly

ifdef VARIATION

BINARYNAME=$(TARNAME)-$(PLATFORM)-$(ARCH)-$(VARIATION)

else

BINARYNAME=$(TARNAME)-$(PLATFORM)-$(ARCH)

endif

BINARYTAR=$(BINARYNAME).tar

# OSX doesn't have xz installed by default, http://macpkg.sourceforge.net/

XZ=$(shell which xz > /dev/null 2>&1; echo $$?)

XZ_COMPRESSION ?= 9e

PKG=$(TARNAME).pkg

MACOSOUTDIR=out/macos

.PHONY: release-only

release-only:

@if [ "$(DISTTYPE)" != "nightly" ] && [ "$(DISTTYPE)" != "next-nightly" ] && \

`grep -q REPLACEME doc/api/*.md`; then \

echo 'Please update REPLACEME in Added: tags in doc/api/*.md (See doc/releases.md)' ; \

exit 1 ; \

fi

@if [ "$(DISTTYPE)" != "nightly" ] && [ "$(DISTTYPE)" != "next-nightly" ] && \

`grep -q DEP...X doc/api/deprecations.md`; then \

echo 'Please update DEP...X in doc/api/deprecations.md (See doc/releases.md)' ; \

exit 1 ; \

fi

@if [ "$(shell git status --porcelain | egrep -v '^\?\? ')" = "" ]; then \

exit 0 ; \

else \

echo "" >&2 ; \

echo "The git repository is not clean." >&2 ; \

echo "Please commit changes before building release tarball." >&2 ; \

echo "" >&2 ; \

git status --porcelain | egrep -v '^\?\?' >&2 ; \

echo "" >&2 ; \

exit 1 ; \

fi

@if [ "$(DISTTYPE)" != "release" -o "$(RELEASE)" = "1" ]; then \

exit 0; \

else \

echo "" >&2 ; \

echo "#NODE_VERSION_IS_RELEASE is set to $(RELEASE)." >&2 ; \

echo "Did you remember to update src/node_version.h?" >&2 ; \

echo "" >&2 ; \

exit 1 ; \

fi

$(PKG): release-only

$(RM) -r $(MACOSOUTDIR)

mkdir -p $(MACOSOUTDIR)/installer/productbuild

cat tools/macos-installer/productbuild/distribution.xml.tmpl \

| sed -E "s/\\{nodeversion\\}/$(FULLVERSION)/g" \

| sed -E "s/\\{npmversion\\}/$(NPMVERSION)/g" \

>$(MACOSOUTDIR)/installer/productbuild/distribution.xml ; \

@for dirname in tools/macos-installer/productbuild/Resources/*/; do \

lang=$$(basename $$dirname) ; \

mkdir -p $(MACOSOUTDIR)/installer/productbuild/Resources/$$lang ; \

printf "Found localization directory $$dirname\n" ; \

cat $$dirname/welcome.html.tmpl \

| sed -E "s/\\{nodeversion\\}/$(FULLVERSION)/g" \

| sed -E "s/\\{npmversion\\}/$(NPMVERSION)/g" \

>$(MACOSOUTDIR)/installer/productbuild/Resources/$$lang/welcome.html ; \

cat $$dirname/conclusion.html.tmpl \

| sed -E "s/\\{nodeversion\\}/$(FULLVERSION)/g" \

| sed -E "s/\\{npmversion\\}/$(NPMVERSION)/g" \

>$(MACOSOUTDIR)/installer/productbuild/Resources/$$lang/conclusion.html ; \

done

$(PYTHON) ./configure \

--dest-cpu=x64 \

--tag=$(TAG) \

--release-urlbase=$(RELEASE_URLBASE) \

$(CONFIG_FLAGS) $(BUILD_RELEASE_FLAGS)

$(MAKE) install V=$(V) DESTDIR=$(MACOSOUTDIR)/dist/node

SIGN="$(CODESIGN_CERT)" PKGDIR="$(MACOSOUTDIR)/dist/node/usr/local" bash \

tools/osx-codesign.sh

mkdir -p $(MACOSOUTDIR)/dist/npm/usr/local/lib/node_modules

mkdir -p $(MACOSOUTDIR)/pkgs

mv $(MACOSOUTDIR)/dist/node/usr/local/lib/node_modules/npm \

$(MACOSOUTDIR)/dist/npm/usr/local/lib/node_modules

unlink $(MACOSOUTDIR)/dist/node/usr/local/bin/npm

unlink $(MACOSOUTDIR)/dist/node/usr/local/bin/npx

$(NODE) tools/license2rtf.js < LICENSE > \

$(MACOSOUTDIR)/installer/productbuild/Resources/license.rtf

cp doc/osx_installer_logo.png $(MACOSOUTDIR)/installer/productbuild/Resources

pkgbuild --version $(FULLVERSION) \

--identifier org.nodejs.node.pkg \

--root $(MACOSOUTDIR)/dist/node $(MACOSOUTDIR)/pkgs/node-$(FULLVERSION).pkg

pkgbuild --version $(NPMVERSION) \

--identifier org.nodejs.npm.pkg \

--root $(MACOSOUTDIR)/dist/npm \

--scripts ./tools/macos-installer/pkgbuild/npm/scripts \

$(MACOSOUTDIR)/pkgs/npm-$(NPMVERSION).pkg

productbuild --distribution $(MACOSOUTDIR)/installer/productbuild/distribution.xml \

--resources $(MACOSOUTDIR)/installer/productbuild/Resources \

--package-path $(MACOSOUTDIR)/pkgs ./$(PKG)

SIGN="$(PRODUCTSIGN_CERT)" PKG="$(PKG)" bash tools/osx-productsign.sh

.PHONY: pkg

# Builds the macOS installer for releases.

pkg: $(PKG)

# Note: this is strictly for release builds on release machines only.

pkg-upload: pkg

ssh $(STAGINGSERVER) "mkdir -p nodejs/$(DISTTYPEDIR)/$(FULLVERSION)"

chmod 664 $(TARNAME).pkg

scp -p $(TARNAME).pkg $(STAGINGSERVER):nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME).pkg

ssh $(STAGINGSERVER) "touch nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME).pkg.done"

$(TARBALL): release-only $(NODE_EXE) doc

git checkout-index -a -f --prefix=$(TARNAME)/

mkdir -p $(TARNAME)/doc/api

cp doc/node.1 $(TARNAME)/doc/node.1

cp -r out/doc/api/* $(TARNAME)/doc/api/

$(RM) -r $(TARNAME)/.editorconfig

$(RM) -r $(TARNAME)/.git*

$(RM) -r $(TARNAME)/.mailmap

$(RM) -r $(TARNAME)/deps/openssl/openssl/demos

$(RM) -r $(TARNAME)/deps/openssl/openssl/doc

$(RM) -r $(TARNAME)/deps/openssl/openssl/test

$(RM) -r $(TARNAME)/deps/uv/docs

$(RM) -r $(TARNAME)/deps/uv/samples

$(RM) -r $(TARNAME)/deps/uv/test

$(RM) -r $(TARNAME)/deps/v8/samples

$(RM) -r $(TARNAME)/deps/v8/test

$(RM) -r $(TARNAME)/deps/v8/tools/profviz

$(RM) -r $(TARNAME)/deps/v8/tools/run-tests.py

$(RM) -r $(TARNAME)/deps/zlib/contrib # too big, unused

$(RM) -r $(TARNAME)/doc/images # too big

$(RM) -r $(TARNAME)/test*.tap

$(RM) -r $(TARNAME)/tools/cpplint.py

$(RM) -r $(TARNAME)/tools/eslint-rules

$(RM) -r $(TARNAME)/tools/license-builder.sh

$(RM) -r $(TARNAME)/tools/node_modules

$(RM) -r $(TARNAME)/tools/osx-*

$(RM) -r $(TARNAME)/tools/osx-pkg.pmdoc

$(RM) -r $(TARNAME)/tools/pkgsrc

$(RM) -r $(TARNAME)/tools/remark-cli

$(RM) -r $(TARNAME)/tools/remark-preset-lint-node

find $(TARNAME)/ -name ".eslint*" -maxdepth 2 | xargs $(RM)

find $(TARNAME)/ -type l | xargs $(RM) # annoying on windows

tar -cf $(TARNAME).tar $(TARNAME)

$(RM) -r $(TARNAME)

gzip -c -f -9 $(TARNAME).tar > $(TARNAME).tar.gz

ifeq ($(XZ), 0)

xz -c -f -$(XZ_COMPRESSION) $(TARNAME).tar > $(TARNAME).tar.xz

endif

$(RM) $(TARNAME).tar

.PHONY: tar

tar: $(TARBALL) ## Create a source tarball.

# Note: this is strictly for release builds on release machines only.

tar-upload: tar

ssh $(STAGINGSERVER) "mkdir -p nodejs/$(DISTTYPEDIR)/$(FULLVERSION)"

chmod 664 $(TARNAME).tar.gz

scp -p $(TARNAME).tar.gz $(STAGINGSERVER):nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME).tar.gz

ssh $(STAGINGSERVER) "touch nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME).tar.gz.done"

ifeq ($(XZ), 0)

chmod 664 $(TARNAME).tar.xz

scp -p $(TARNAME).tar.xz $(STAGINGSERVER):nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME).tar.xz

ssh $(STAGINGSERVER) "touch nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME).tar.xz.done"

endif

# Note: this is strictly for release builds on release machines only.

doc-upload: doc

ssh $(STAGINGSERVER) "mkdir -p nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/docs/"

chmod -R ug=rw-x+X,o=r+X out/doc/

scp -pr out/doc/* $(STAGINGSERVER):nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/docs/

ssh $(STAGINGSERVER) "touch nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/docs.done"

.PHONY: $(TARBALL)-headers

$(TARBALL)-headers: release-only

$(PYTHON) ./configure \

--prefix=/ \

--dest-cpu=$(DESTCPU) \

--tag=$(TAG) \

--release-urlbase=$(RELEASE_URLBASE) \

$(CONFIG_FLAGS) $(BUILD_RELEASE_FLAGS)

HEADERS_ONLY=1 $(PYTHON) tools/install.py install '$(TARNAME)' '/'

find $(TARNAME)/ -type l | xargs $(RM)

tar -cf $(TARNAME)-headers.tar $(TARNAME)

$(RM) -r $(TARNAME)

gzip -c -f -9 $(TARNAME)-headers.tar > $(TARNAME)-headers.tar.gz

ifeq ($(XZ), 0)

xz -c -f -$(XZ_COMPRESSION) $(TARNAME)-headers.tar > $(TARNAME)-headers.tar.xz

endif

$(RM) $(TARNAME)-headers.tar

tar-headers: $(TARBALL)-headers ## Build the node header tarball.

tar-headers-upload: tar-headers

ssh $(STAGINGSERVER) "mkdir -p nodejs/$(DISTTYPEDIR)/$(FULLVERSION)"

chmod 664 $(TARNAME)-headers.tar.gz

scp -p $(TARNAME)-headers.tar.gz $(STAGINGSERVER):nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME)-headers.tar.gz

ssh $(STAGINGSERVER) "touch nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME)-headers.tar.gz.done"

ifeq ($(XZ), 0)

chmod 664 $(TARNAME)-headers.tar.xz

scp -p $(TARNAME)-headers.tar.xz $(STAGINGSERVER):nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME)-headers.tar.xz

ssh $(STAGINGSERVER) "touch nodejs/$(DISTTYPEDIR)/$(FULLVERSION)/$(TARNAME)-headers.tar.xz.done"

endif

$(BINARYTAR): release-only

$(RM) -r $(BINARYNAME)

$(RM) -r out/deps out/Release

$(PYTHON) ./configure \

--prefix=/ \

--dest-cpu=$(DESTCPU) \