help.txt 3.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. Usage: build.sh [-h] [-c|-cc] [-v] [-j <n>] [--gyp|-g] [--opt|-o]
  2. [-t <x64|ia32|...>|--target=<x64|ia32|...>]
  3. [--clang|--gcc|--msvc] [--scan-build[=dir]] [--disable-tests]
  4. [--pprof] [--asan] [--msan] [--ubsan[=bool,shift,...]
  5. [--fuzz[=tls|oss]] [--sancov[=edge|bb|func|...]]
  6. [--emit-llvm] [--no-zdefs] [--static] [--ct-verif]
  7. [--nspr|--with-nspr=<include>:<lib>|--system-nspr]
  8. [--system-sqlite] [--enable-fips] [--enable-libpkix]
  9. [--mozpkix-only] [-D<gyp-option>]
  10. [--rebuild] [--enable-legacy-db]
  11. This script builds NSS with gyp and ninja.
  12. NSS build tool options:
  13. -h display this help and exit
  14. -c clean before build
  15. -cc clean without building
  16. -v verbose build
  17. -j <n> run at most <n> concurrent jobs
  18. --gyp|-g force a rerun of gyp
  19. --opt|-o do an opt build
  20. --target|-t specify target architecture (e.g., ia32, x64, aarch64)
  21. --clang build with clang and clang++
  22. --gcc build with gcc and g++
  23. --msvc build with MSVC
  24. --scan-build run the build with scan-build
  25. --scan-build=<dir> sets the output path for scan-build
  26. --disable-tests don't build tests and corresponding cmdline utils
  27. --pprof build with gperftool support
  28. --asan enable address sanitizer
  29. --msan enable memory sanitizer
  30. --ubsan enable undefined behavior sanitizer
  31. --ubsan=bool,shift,... sets specific UB sanitizers
  32. --fuzz build fuzzing targets (this always enables static builds)
  33. --fuzz=tls to enable TLS fuzzing mode
  34. --fuzz=oss to build for OSS-Fuzz
  35. --sancov do sanitize coverage builds
  36. --sancov=func sets coverage to function level for example
  37. --emit-llvm emit LLVM bitcode while building
  38. (requires the gold linker, use clang-3.8 for SAW)
  39. --no-zdefs don't set -Wl,-z,defs
  40. --static create static libraries and use static linking
  41. --ct-verif build with valgrind for ct-verif
  42. --nspr force a rebuild of NSPR
  43. --nspr-test-build when building NSPR also build its tests
  44. --nspr-test-run when building NSPR tests also run its tests
  45. --nspr-only exit after building NSPR
  46. --with-nspr use the NSPR build at the given locations
  47. --with-nspr=<include>:<lib> sets include and lib paths
  48. --system-nspr attempt to use system nspr
  49. shorthand for --with-nspr=/usr/include/nspr:
  50. --system-sqlite use system sqlite
  51. --enable-fips enable FIPS checks
  52. --enable-libpkix make libpkix part of the build
  53. --enable-legacy-db enable the legacy db (libnssdbm)
  54. --mozpkix-only build only static mozpkix and mozpkix-test libraries
  55. support for this build option is limited
  56. --disable-keylog disable support for logging key data to a file specified
  57. by the SSLKEYLOGFILE environment variable
  58. -D<gyp-option> pass an option directly to gyp
  59. --rebuild build again using the last set of options provided
  60. (all other arguments are ignored if --rebuild is used)