summaryrefslogtreecommitdiff
path: root/help.txt
diff options
context:
space:
mode:
authorMartin Thomson <martin.thomson@gmail.com>2018-09-23 12:44:07 -0700
committerMartin Thomson <martin.thomson@gmail.com>2018-09-23 12:44:07 -0700
commita9267dcdf728c490e2ecee02562d3ad6c95730dd (patch)
tree54ec231c0f96db35a2d2e782900249417947d1dd /help.txt
parent5b8651fbb626e8e4fb80a86ae78de0136cf74548 (diff)
downloadnss-hg-a9267dcdf728c490e2ecee02562d3ad6c95730dd.tar.gz
Backed out changeset 8bea05067a0b
Diffstat (limited to 'help.txt')
-rw-r--r--help.txt56
1 files changed, 28 insertions, 28 deletions
diff --git a/help.txt b/help.txt
index 6d504d121..b4ffc0382 100644
--- a/help.txt
+++ b/help.txt
@@ -1,14 +1,15 @@
-Usage: build.sh [-h] [-c|-cc] [-v] [-j <n>] [--gyp|-g] [--opt|-o]
- [-t <x64|x86|...>|--target=<x64|x86|...>]
- [--clang|--gcc|--msvc] [--scan-build[=dir]] [--disable-tests]
- [--pprof] [--asan] [--msan] [--ubsan[=bool,shift,...]
- [--fuzz[=tls|oss]] [--sancov[=edge|bb|func|...]]
- [--emit-llvm] [--no-zdefs] [--test] [--ct-verif]
- [--nspr|--with-nspr=<include>:<lib>|--system-nspr]
- [--system-sqlite] [--enable-fips] [--enable-libpkix]
+Usage: build.sh [-hcv] [-cc] [-j <n>] [--nspr] [--gyp|-g] [--opt|-o] [-m32]
+ [--test] [--pprof] [--scan-build[=output]] [--ct-verif]
+ [--asan] [--ubsan] [--msan] [--sancov[=edge|bb|func|...]]
+ [--disable-tests] [--fuzz[=tls|oss]] [--system-sqlite]
+ [--no-zdefs] [--with-nspr] [--system-nspr] [--enable-libpkix]
+ [--enable-fips]
This script builds NSS with gyp and ninja.
+This build system is still under development. It does not yet support all
+the features or platforms that NSS supports.
+
NSS build tool options:
-h display this help and exit
@@ -16,35 +17,34 @@ NSS build tool options:
-cc clean without building
-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
- --target|-t specify target architecture (e.g., x86, x64, aarch64)
+ -m32 do a 32-bit build on a 64-bit system
--clang build with clang and clang++
--gcc build with gcc and g++
- --msvc build with MSVC
- --scan-build run the build with scan-build
- --scan-build=<dir> sets the output path for scan-build
- --disable-tests don't build tests and corresponding cmdline utils
- --pprof build with gperftool support
- --asan enable address sanitizer
- --msan enable memory sanitizer
- --ubsan enable undefined behavior sanitizer
- --ubsan=bool,shift,... sets specific UB sanitizers
+ --test ignore map files and export everything we have
--fuzz build fuzzing targets (this always enables test builds)
--fuzz=tls to enable TLS fuzzing mode
--fuzz=oss to build for OSS-Fuzz
+ --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
--emit-llvm emit LLVM bitcode while building
(requires the gold linker, use clang-3.8 for SAW)
- --no-zdefs don't set -Wl,-z,defs
- --test ignore map files and export everything we have
- --ct-verif build with valgrind for ct-verif
- --nspr force a rebuild of NSPR
- --with-nspr use the NSPR build at the given locations
- --with-nspr=<include>:<lib> sets include and lib paths
- --system-nspr attempt to use system nspr
- shorthand for --with-nspr=/usr/include/nspr:
+ --disable-tests don't build tests and corresponding cmdline utils
--system-sqlite use system sqlite
- --enable-fips enable FIPS checks
- --enable-libpkix make libpkix part of the build
+ --no-zdefs don't set -Wl,-z,defs
+ --with-nspr don't build NSPR but use the one at the given location, e.g.
+ --with-nspr=/path/to/nspr/include:/path/to/nspr/lib
+ --system-nspr use system nspr. This requires an installation of NSPR and
+ might not work on all systems.
+ --enable-libpkix make libpkix part of the build.
+ --enable-fips don't disable FIPS checks.