index.rst (2938B)
1 .. _mozilla_projects_nss_reference_troubleshoot: 2 3 troubleshoot 4 ============ 5 6 .. _troubleshooting_nss_and_jss_builds: 7 8 `Troubleshooting NSS and JSS Builds <#troubleshooting_nss_and_jss_builds>`__ 9 ---------------------------------------------------------------------------- 10 11 .. container:: 12 13 Newsgroup: `mozilla.dev.tech.crypto <nntp://news.mozilla.org/mozilla.dev.tech.crypto>`__ 14 15 This page summarizes information on troubleshooting the NSS and JSS build and test systems, 16 including known problems and configuration suggestions. 17 18 If you have suggestions for this page, please post them to 19 `mozilla.dev.tech.crypto <nntp://news.mozilla.org/mozilla.dev.tech.crypto>`__. 20 21 .. _building_nss: 22 23 `Building NSS <#building_nss>`__ 24 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 25 26 .. container:: 27 28 - Having /usr/ucb/bin in the path before /usr/ccs/bin breaks the build on 64-bit Solaris. 29 30 - The Solaris compiler needs to be workshop-5.0 or greater. 31 32 - The 64-bit builds don't support gcc. 33 34 - If the build fails early on the gmakein coreconf try updating your cvs tree with -P: 35 cd mozilla 36 cvs update -P 37 38 - Building a 32-bit version on a 64-bit may fail with: 39 40 .. code:: 41 42 /usr/include/features.h:324:26: fatal error: bits/predefs.h: No such file or directory 43 44 In this case remember to set USE_64=1 45 46 .. _testing_nss: 47 48 `Testing NSS <#testing_nss>`__ 49 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 50 51 .. container:: 52 53 The SSL stress test opens 2,048 TCP connections in quick succession. Kernel data structures may 54 remain allocated for these connections for up to two minutes. Some systems may not be configured 55 to allow this many simultaneous connections by default; if the stress tests fail, try increasing 56 the number of simultaneous sockets supported. 57 58 .. _building_jss: 59 60 `Building JSS <#building_jss>`__ 61 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 62 63 .. container:: 64 65 - **Windows Only:** The shell invoked by gmake, ``shmsdos.exe``, is likely to crash when 66 invoking some Java tools on Windows. The current workaround is to use some other shell in 67 place of ``shmsdos``, such as ``sh.exe``, which should be distributed with the `Cygnus 68 toolkit <http://sourceware.cygnus.com/cygwin/download.html>`__ you installed to build NSS. The 69 change is unfortunately rather drastic: to trick gmake, you rename the shell program. 70 71 cd c:/Programs/cygnus/bin *(or wherever your GNU tools are installed)* 72 cp shmsdos.exe shmsdos.bak *(backup shmsdos)* 73 cp sh.exe shmsdos.exe *(substitute alternative shell)* 74 75 Making this change will probably break other builds you are making on the same machine. You 76 may need to switch the shell back and forthdepending on which product you are building. We 77 will try to provide a moreconvenient solution in the future. If you have the MKS toolkit 78 installed, the <tt>sh.exe</tt> that comes with this toolkit can be used as well.