summaryrefslogtreecommitdiff
path: root/readme.md
diff options
context:
space:
mode:
authorFranziskus Kiefer <franziskuskiefer@gmail.com>2017-01-19 09:26:39 +0100
committerFranziskus Kiefer <franziskuskiefer@gmail.com>2017-01-19 09:26:39 +0100
commita32a6fb2756f0dfded13e60db61087d97631572a (patch)
treea231fdf7a0b4c8cea1744382dac0a969c496559e /readme.md
parent152a0107dacb2889d300cf55420dbb7a14d1252d (diff)
downloadnss-hg-a32a6fb2756f0dfded13e60db61087d97631572a.tar.gz
update readme, r=ttaubert DONTBUILD
Differential Revision: https://nss-review.dev.mozaws.net/D159
Diffstat (limited to 'readme.md')
-rw-r--r--readme.md54
1 files changed, 28 insertions, 26 deletions
diff --git a/readme.md b/readme.md
index 5c7d89f37..0073bb698 100644
--- a/readme.md
+++ b/readme.md
@@ -34,15 +34,16 @@ After changing into the NSS directory a typical build is done as follows
./build.sh
Once the build is done the build output is found in the directory
-`../dist/*.OBJ`, where `*` will be a name dynamically derived from your system's
-architecture. Exported header files can be found in the `include` directory,
-library files in directory `lib`, and tools in directory `bin`. In order to run
-the tools, set your system environment to use the libraries of your build from
-the "lib" directory, e.g., using the `LD_LIBRARY_PATH` or `DYLD_LIBRARY_PATH`.
+`../dist/Debug` for debug builds and `../dist/Release` for opt builds.
+Exported header files can be found in the `include` directory, library files in
+directory `lib`, and tools in directory `bin`. In order to run the tools, set
+your system environment to use the libraries of your build from the "lib"
+directory, e.g., using the `LD_LIBRARY_PATH` or `DYLD_LIBRARY_PATH`.
- Usage: ${0##*/} [-hcv] [-j <n>] [--nspr] [--gyp|-g] [--opt|-o] [-m32]
+ Usage: build.sh [-hcv] [-j <n>] [--nspr] [--gyp|-g] [--opt|-o] [-m32]
[--test] [--fuzz] [--pprof] [--scan-build[=output]]
[--asan] [--ubsan] [--msan] [--sancov[=edge|bb|func|...]]
+ [--ct-verif] [--disable-tests]
This script builds NSS with gyp and ninja.
@@ -51,26 +52,27 @@ the "lib" directory, e.g., using the `LD_LIBRARY_PATH` or `DYLD_LIBRARY_PATH`.
NSS build tool options:
- -h display this help and exit
- -c clean before build
- -v verbose build
- -j <n> run at most <n> concurrent jobs
- --nspr force a rebuild of NSPR
- --gyp|-g force a rerun of gyp
- --opt|-o do an opt build
- -m32 do a 32-bit build on a 64-bit system
- --test ignore map files and export everything we have
- --fuzz enable fuzzing mode. this always enables test builds
- --pprof build with gperftool support
- --scan-build run the build with scan-build (scan-build has to be in the path)
- --scan-build=/out/path sets the output path for scan-build
- --asan do an asan build
- --ubsan do an ubsan build
- --ubsan=bool,shift,... sets specific UB sanitizers
- --msan do an msan build
- --sancov do sanitize coverage builds
- --sancov=func sets coverage to function level for example
-
+ -h display this help and exit
+ -c clean before build
+ -v verbose build
+ -j <n> run at most <n> concurrent jobs
+ --nspr force a rebuild of NSPR
+ --gyp|-g force a rerun of gyp
+ --opt|-o do an opt build
+ -m32 do a 32-bit build on a 64-bit system
+ --test ignore map files and export everything we have
+ --fuzz enable fuzzing mode. this always enables test builds
+ --pprof build with gperftool support
+ --ct-verif build with valgrind for ct-verif
+ --scan-build run the build with scan-build (scan-build has to be in the path)
+ --scan-build=/out/path sets the output path for scan-build
+ --asan do an asan build
+ --ubsan do an ubsan build
+ --ubsan=bool,shift,... sets specific UB sanitizers
+ --msan do an msan build
+ --sancov do sanitize coverage builds
+ --sancov=func sets coverage to function level for example
+ --disable-tests don't build tests and corresponding cmdline utils
## Building NSS (legacy build system)