mozilla
Your Search Results

    Updating NSPR or NSS in mozilla-central

    The NSPR and NSS sources in mozilla-central are maintained by the NSPR and NSS teams and always taken from exports of CVS tags. Do not check in individual changes. If you check in an individual change by mistake, your change will be lost when the NSPR and NSS teams push a new static CVS tag to mozilla-central.

    If NSPR or NSS must be upgraded to a new static tag, follow this procedure:

    1. Before starting, make sure your local repository is updated to mozilla-central tip and that there are no local changes:
      $ hg status -mard
    2. Pull the new sources
      $ python client.py update_nspr NSPR_TAG_NAME

      or

      $ python client.py update_nss NSS_TAG_NAME
    3. If you update a branch older than Mozilla 17 (without the change from bug 782784), you must manually add a dummy change (add or remove a blank line) to force a rebuild of NSPR:
      mozilla/nsprpub/config/prdepend.h

      or NSS:

      mozilla/security/nss/coreconf/coreconf.dep
    4. Check directory mozilla/nsprpub/patches/ for patches that need to be applied to NSPR, and directory mozilla/security/patches/ for patches that need to be applied to NSS. Apply the patches. If merging is required, update the patch file. If a patch is no longer needed, remove the patch from the directory and update the README file.
    5. Check for new or removed files
      $ hg addremove -n

      Review the output to make sure it looks correct

    6. Update the minimum required system NSS version in configure.in. This is for builds with --with-system-nss. For example, in the following, "3.16.1" would be replaced with the new NSS version.

      MOZ_ARG_WITH_BOOL(system-nss,
      [  --with-system-nss       Use system installed NSS],
          _USE_SYSTEM_NSS=1 )
      
      if test -n "$_USE_SYSTEM_NSS"; then
          AM_PATH_NSS(3.16.1, [MOZ_NATIVE_NSS=1], [AC_MSG_ERROR([you don't have NSS installed or your version is too old])])
      fi
      
    7. Commit the update:
      $ hg commit -A
      

      In order to eliminate any problems related to how NSS and NSPR are built differently in Firefox than they are standalone, you should push your commit to Try first. If your update fails linking because of missing NSS or NSPR symbols, add the missing symbols to config/external/nss/nspr-dummy.def or config/external/nss/nss.def, whichever is relevant.

    8. Push the update:
      $ hg push

    Document Tags and Contributors

    Contributors to this page: Sheppy, Skierpage, BenjaminSmedberg, kaie, RyanVM, glandium, Wtchang, keeler
    Last updated by: keeler,