diff options
author | gengjiawen <technicalcute@gmail.com> | 2020-03-23 20:07:29 +0800 |
---|---|---|
committer | Beth Griggs <Bethany.Griggs@uk.ibm.com> | 2020-04-07 16:25:10 +0100 |
commit | 94767b95eb4a9ea078ce472974cb5652874aa06b (patch) | |
tree | 9d1c425475ae1cd0c76ac44140807627c8873566 /BUILDING.md | |
parent | b2e77003c53cb87be49db7215f27d7e0dc38feab (diff) | |
download | node-new-94767b95eb4a9ea078ce472974cb5652874aa06b.tar.gz |
doc: add ASAN build instructions
PR-URL: https://github.com/nodejs/node/pull/32436
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Matheus Marchini <mat@mmarchini.me>
Diffstat (limited to 'BUILDING.md')
-rw-r--r-- | BUILDING.md | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/BUILDING.md b/BUILDING.md index 6d62837e61..ac67d7464d 100644 --- a/BUILDING.md +++ b/BUILDING.md @@ -28,6 +28,7 @@ file a new issue. * [Running Coverage](#running-coverage) * [Building the documentation](#building-the-documentation) * [Building a debug build](#building-a-debug-build) + * [Building an ASAN build](#building-an-asan-build) * [Troubleshooting Unix and macOS builds](#troubleshooting-unix-and-macos-builds) * [Windows](#windows) * [Prerequisites](#prerequisites) @@ -491,6 +492,22 @@ $ gdb /opt/node-debug/node core.node.8.1535359906 $ backtrace ``` +#### Building an ASAN build + +[ASAN](https://github.com/google/sanitizers) can help detect various memory +related bugs. ASAN builds are currently only supported on linux. +If you want to check it on Windows or macOS or you want a consistent toolchain +on Linux, you can try [Docker](https://www.docker.com/products/docker-desktop) + (using an image like `gengjiawen/node-build:2020-02-14`). + +The `--debug` is not necessary and will slow down build and testing, but it can +show clear stacktrace if ASAN hits an issue. + +``` console +$ ./configure --debug --enable-asan && make -j4 +$ make test-only +``` + #### Troubleshooting Unix and macOS builds Stale builds can sometimes result in `file not found` errors while building. |