NSS/BoGo Tests: Difference between revisions

From MozillaWiki
< NSS
Jump to navigation Jump to search
No edit summary
(Guidance for updating BoGo versions)
 
(4 intermediate revisions by one other user not shown)
Line 2: Line 2:


=== Running BoGo Tests ===
=== Running BoGo Tests ===
Assuming a copy (in $SOURCE_DIR) and build (in $BINDIR) of NSS are present.
Assuming a copy (in $SOURCE_DIR) and build (in $DISTDIR) of NSS are present.
First get a copy of boringssl and checkout a specific version.
First get a copy of boringssl and checkout a specific version (check [https://searchfox.org/nss/source/tests/bogo/bogo.sh#28 source] for currently used revision).
     git clone https://boringssl.googlesource.com/boringssl
     git clone https://boringssl.googlesource.com/boringssl
     cd boringssl
     cd boringssl
     git checkout e34bcc91c07c0bf65ecc53a814d51f5246007150
     git checkout ec55dc15d3a39e5f1a58bfd79148729f38f6acb4


Then you can run the BoGo tests.
Then you can run the BoGo tests.
     cd boringssl/ssl/test/runner
    export (DY)LD_LIBRARY_PATH=$DISTDIR/lib
     GOPATH="$PWD" go test -shim-path "$BINDIR"/nss_bogo_shim -loose-errors \
     cd ssl/test/runner
     -allow-unimplemented -shim-config "$SOURCE_DIR/external_tests/nss_bogo_shim/config.json"
     GOPATH="$PWD" go test -shim-path "$DISTDIR"/bin/nss_bogo_shim -loose-errors \
     -allow-unimplemented -shim-config "$SOURCE_DIR/gtests/nss_bogo_shim/config.json"
 
=== Updating BoGo Versions ===
Care is needed when upgrading the version of BoGo in use in [https://searchfox.org/nss/source/tests/bogo/bogo.sh#28 tests/bogo/bogo.sh]. Often new tests are added to BoGo that do not pass on NSS.
 
Before publicly posting any changes to our BoGo version or the "DisabledTests" list for nss_bogo_shim, each test failure needs to be individually triaged. If there are any suspicious failures, those must be addressed before we post about the upgrade. If there are questionable circumstances, it is better to ask on nss-dev than not.
 
 
[[Category:NSS]]

Latest revision as of 15:50, 14 June 2018

BoGo is the TLS test suite for boringssl that can be easily ported to other TLS libraries (BoGo Porting).

Running BoGo Tests

Assuming a copy (in $SOURCE_DIR) and build (in $DISTDIR) of NSS are present. First get a copy of boringssl and checkout a specific version (check source for currently used revision).

   git clone https://boringssl.googlesource.com/boringssl
   cd boringssl
   git checkout ec55dc15d3a39e5f1a58bfd79148729f38f6acb4

Then you can run the BoGo tests.

   export (DY)LD_LIBRARY_PATH=$DISTDIR/lib
   cd ssl/test/runner
   GOPATH="$PWD" go test -shim-path "$DISTDIR"/bin/nss_bogo_shim -loose-errors \
   -allow-unimplemented -shim-config "$SOURCE_DIR/gtests/nss_bogo_shim/config.json"

Updating BoGo Versions

Care is needed when upgrading the version of BoGo in use in tests/bogo/bogo.sh. Often new tests are added to BoGo that do not pass on NSS.

Before publicly posting any changes to our BoGo version or the "DisabledTests" list for nss_bogo_shim, each test failure needs to be individually triaged. If there are any suspicious failures, those must be addressed before we post about the upgrade. If there are questionable circumstances, it is better to ask on nss-dev than not.