summaryrefslogtreecommitdiff
path: root/deps/uv/README.md
diff options
context:
space:
mode:
authorcjihrig <cjihrig@gmail.com>2018-09-21 10:14:00 -0400
committerDaniel Bevenius <daniel.bevenius@gmail.com>2018-09-24 07:14:45 +0200
commit2790db5e3d74c4f7521cc27a1115228700dd4049 (patch)
tree14690a4e418d74d387491dc7afcbcde02c62e99b /deps/uv/README.md
parentea8000f1195801cf602946c6bd85b8b5dbe83d43 (diff)
downloadandroid-node-v8-2790db5e3d74c4f7521cc27a1115228700dd4049.tar.gz
android-node-v8-2790db5e3d74c4f7521cc27a1115228700dd4049.tar.bz2
android-node-v8-2790db5e3d74c4f7521cc27a1115228700dd4049.zip
deps: upgrade to libuv 1.23.1
PR-URL: https://github.com/nodejs/node/pull/22997 Reviewed-By: Anna Henningsen <anna@addaleax.net> Reviewed-By: Matteo Collina <matteo.collina@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Diffstat (limited to 'deps/uv/README.md')
-rw-r--r--deps/uv/README.md79
1 files changed, 77 insertions, 2 deletions
diff --git a/deps/uv/README.md b/deps/uv/README.md
index cb9e26c1e0..b24b722612 100644
--- a/deps/uv/README.md
+++ b/deps/uv/README.md
@@ -282,8 +282,31 @@ Make sure that you specify the architecture you wish to build for in the
Run:
+For arm
+
+```bash
+$ source ./android-configure-arm NDK_PATH gyp [API_LEVEL]
+$ make -C out
+```
+
+or for arm64
+
+```bash
+$ source ./android-configure-arm64 NDK_PATH gyp [API_LEVEL]
+$ make -C out
+```
+
+or for x86
+
+```bash
+$ source ./android-configure-x86 NDK_PATH gyp [API_LEVEL]
+$ make -C out
+```
+
+or for x86_64
+
```bash
-$ source ./android-configure NDK_PATH gyp [API_LEVEL]
+$ source ./android-configure-x86_64 NDK_PATH gyp [API_LEVEL]
$ make -C out
```
@@ -310,14 +333,66 @@ $ ninja -C out/Release
### Running tests
-Run:
+#### Build
+
+Build (includes tests):
```bash
$ ./gyp_uv.py -f make
$ make -C out
+```
+
+#### Run all tests
+
+```bash
$ ./out/Debug/run-tests
```
+#### Run one test
+
+The list of all tests is in `test/test-list.h`.
+
+This invocation will cause the `run-tests` driver to fork and execute `TEST_NAME` in a child process:
+
+```bash
+$ ./out/Debug/run-tests TEST_NAME
+```
+
+This invocation will cause the `run-tests` driver to execute the test within the `run-tests` process:
+
+```bash
+$ ./out/Debug/run-tests TEST_NAME TEST_NAME
+```
+
+#### Debugging tools
+
+When running the test from within the `run-tests` process (`run-tests TEST_NAME TEST_NAME`), tools like gdb and valgrind work normally.
+When running the test from a child of the `run-tests` process (`run-tests TEST_NAME`), use these tools in a fork-aware manner.
+
+##### Fork-aware gdb
+
+Use the [follow-fork-mode](https://sourceware.org/gdb/onlinedocs/gdb/Forks.html) setting:
+
+```
+$ gdb --args out/Debug/run-tests TEST_NAME
+
+(gdb) set follow-fork-mode child
+...
+```
+
+##### Fork-aware valgrind
+
+Use the `--trace-children=yes` parameter:
+
+```bash
+$ valgrind --trace-children=yes -v --tool=memcheck --leak-check=full --track-origins=yes --leak-resolution=high --show-reachable=yes --log-file=memcheck.log out/Debug/run-tests TEST_NAME
+```
+
+### Running benchmarks
+
+See the section on running tests.
+The benchmark driver is `out/Debug/run-benchmarks` and the benchmarks are listed in `test/benchmark-list.h`.
+
## Supported Platforms
Check the [SUPPORTED_PLATFORMS file](SUPPORTED_PLATFORMS.md).