external/nss/README

   1 Contains the security libraries which are also part of [[moz]]. However nss is meant to be more current.
   2
   3 == Relation between nss, moz, moz_prebuilt ==
   4
   5 nss contains the security libraries which are also part of moz. However nss is
   6 meant to be more current, that is it to be updated more often. This should be
   7 easier than doing this with moz.
   8
   9 If nss is built depends on an environment variable (SYSTEM_NSS=NO) which
  10 is per default set to YES. In this case nss is build before moz. The nss
  11 libraries/lib files/headers built in moz are then not delivered. Otherwise they
  12 would overwrite those from nss. That is, the nss libraries build in moz are
  13 removed from mozruntime.zip (build in moz/solver/bin), they are removed from the
  14 lib directory (for example moz/unxlngi6.pro/lib), and the nss and nspr headers
  15 are also removed (inc/nss and inc/nspr).  The nss libraries from the nss module
  16 are then added to mozruntime.zip.
  17
  18 This also applies for moz_prebuilt. Therefore moz and moz_prebuilt must be build
  19 again after changes have been made to the libraries in the nss module.
  20
  21 Also when moz was updated to use a newer version of mozilla, then one must make
  22 sure that new files which also belong to nss are not delivered and are removed
  23 from mozruntime.zip.
  24
  25
  26 == Fips 140 and signed libraries ==
  27
  28 Fips 140 mode is not supported. That is, the *.chk files containing the
  29 checksums for the cryptographic module are not delivered into solver and will
  30 not be part of the OOo installation sets.
  31
  32 Signing has been turned off because
  33 - we change the rpath (install names)  after signing which breaks the signatures
  34 (Mac)
  35 - sqlite conflicts with the system sqlite when signing which breaks the build
  36
  37
  38 == libfreebl3 ==
  39
  40 Porting to other platforms may require to deliver other variants of
  41 libfreebl*. The library name varies according to the platform. Changes need to
  42 be made to
  43 ooo/moz/extractfiles.mk
  44 ooo/moz/zipped/makefile.mk
  45 sun/moz_prebuilt/zipped/makefile.mk
  46
  47 See also
  48 [http://www.mozilla.org/projects/security/pki/nss/tech-notes/tn6.html]
  49
  50
  51 == Windows builds of nss ==
  52
  53 To build mozilla on windows you'll need the mozilla build tools
  54
  55 Build requirements containing the link to the build tools:
  56 [https://developer.mozilla.org/en/Windows_Build_Prerequisites#ss2.2]
  57
  58 The direct link:
  59 [http://ftp.mozilla.org/pub/mozilla.org/mozilla/libraries/win32/MozillaBuildSetup-1.3.exe]
  60
  61
  62 == libsqlite3 ==
  63
  64 The system sqlite in Mac OS X versions older than 10.6 is incompatible
  65 with the softokn3 in nss which requires a later version of sqlite.
  66 With SDK 10.6 (and more current SDK) we use
  67 NSS_USE_SYSTEM_SQLITE=1
  68 to build using the system sqlite.
  69
  70 The problem described here was found on Mac with OS 10.6
  71 We cannot deliver sqlite in the lib directory of the solver. This directory is
  72 used by tools of the build environment. Using the sqlite from NSS breaks the
  73 tools if they use system libraries which are linked with the system
  74 sqlite. Therefore we deliver it into lib/sqlite on unix systems.
  75
  76 See also issue:
  77 [https://bz.apache.org/ooo/show_bug.cgi?id=106132]
  78
  79 == system NSS on Linux ==
  80
  81 Note that different Linux distributions use different SONAMEs for the
  82 NSS libraries, so it is not possible to use --with-system-nss and build
  83 a portable generic LO installation set, despite NSS upstream apparently
  84 maintaining ABI compatibility.
  85
  86 Debian Squeeze:
  87 0x000000000000000e (SONAME)             Library soname: [libnss3.so.1d]
  88 Fedora 20:
  89 0x000000000000000e (SONAME)             Library soname: [libnss3.so]
  90
  91 For the record, the LSB specified SONAME is libnss3.so
  92 http://refspecs.linuxfoundation.org/LSB_4.1.0/LSB-Core-generic/LSB-Core-generic/libnss3.html
  93