1d659a4689
This reverts commit
|
||
|---|---|---|
| .. | ||
| keys | ||
| .gitignore | ||
| README.md | ||
| check.py | ||
| config.json | ||
| fetch-and-build | ||
| regen-certs | ||
| runme | ||
README.md
BoGo
BoGo is the TLS test suite for boringssl, which we run against rustls as well.
System requirements
You will need golang installed
Running tests
$ cd bogo # from rustls repo root
$ ./runme
Running a single test
$ cd bogo # from rustls repo root
$ ./runme -test "Foo;Bar" # where Foo and Bar are test names like EarlyData-Server-BadFinished-TLS13
Diagnosing failures
When updating the BoGo suite it's expected that new failures will emerge. There are often two major categories to diagnose:
Unexpected error outputs
Often the upstream will change expected error outputs (e.g. changing from
:DECODE_ERROR: to :NO_CERTS:). The bogo_shim handle_err
function is responsible for mapping errors in combination with the ErrorMap
and TestErrorMap data in config.json. These will typically
need updating for new error outputs or changes in error outputs.
Unhandled options
When the upstream test suite adds new options that aren't handled by Rustls the
bogo_shim's main fn can be updated to signal NYI
(not-yet-implemented) for the unhandled options. See the // Not implemented things switch near the end of the function definition.
Use your best judgement to decide whether there should be a Rustls issue filed to consider implementing the option in question.