diff --git a/build.sh b/build.sh index 70c066b03c..df0774a8cc 100755 --- a/build.sh +++ b/build.sh @@ -17,6 +17,7 @@ show_help() Usage: ${0##*/} [-hcv] [-j ] [--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. diff --git a/readme.md b/readme.md index 5c7d89f376..0073bb6985 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 ] [--nspr] [--gyp|-g] [--opt|-o] [-m32] + Usage: build.sh [-hcv] [-j ] [--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 run at most 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 run at most 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)