Add a PRESUBMIT.py script to check pregenerated files

This adds a PRESUBMIT.py script that calls the existing go script to
check pregenerated files. The goal is to catch errors due to
missing/out-of-date pregenerated files earlier, upon commit or upload.
This works with the presubmit API provided by depot_tools, and will only
help you if you use depot_tools to manage local boringssl changes via
`git cl upload`.

(We already run the pregenerate script on CQ via the boringssl.py
recipe. If we had a dedicated builder to run PRESUBMIT.py files on
boringssl CQ via the presubmit recipe (which we don't yet), this script
would also help catch the errors on dry run even earlier, even for folks
not using depot_tools.)


Output looks something like this:

Running presubmit commit checks on branch my-branch-name ...
** Presubmit ERRORS: 1 **
Found out-of-date generated files. Run `go run ./util/pregenerate` to update them.
  Error in file "gen/crypto/chacha-armv4-linux.S": missing file
  Error in file "gen/crypto/aes128gcmsiv-x86_64-linux.S": file out of date
  Error: some files had errors
  exit status 1

Presubmit checks took 1.7s to calculate.
There were presubmit errors.
Was the presubmit check useful? If not, run "git cl presubmit -v"
to figure out which PRESUBMIT.py was run, then run "git blame"
on the file to figure out who to ask for help.

Change-Id: Iad268831ad7353eb15c796906b3f73c12ab8cf80
Reviewed-on: https://boringssl-review.googlesource.com/c/boringssl/+/82867
Auto-Submit: Lily Chen <chlily@google.com>
Commit-Queue: Lily Chen <chlily@google.com>
Reviewed-by: David Benjamin <davidben@google.com>
Commit-Queue: David Benjamin <davidben@google.com>
1 file changed
tree: ed599e17c3077e534a616ddd01ed40e3fcc5aaa9
  1. .bcr/
  2. .github/
  3. cmake/
  4. crypto/
  5. decrepit/
  6. docs/
  7. fuzz/
  8. gen/
  9. include/
  10. infra/
  11. pki/
  12. rust/
  13. ssl/
  14. third_party/
  15. tool/
  16. util/
  17. .bazelignore
  18. .bazelrc
  19. .bazelversion
  20. .clang-format
  21. .gitignore
  22. API-CONVENTIONS.md
  23. AUTHORS
  24. BREAKING-CHANGES.md
  25. BUILD.bazel
  26. build.json
  27. BUILDING.md
  28. CMakeLists.txt
  29. codereview.settings
  30. CONTRIBUTING.md
  31. FUZZING.md
  32. go.mod
  33. go.sum
  34. INCORPORATING.md
  35. LICENSE
  36. MODULE.bazel
  37. MODULE.bazel.lock
  38. PORTING.md
  39. PRESUBMIT.py
  40. PrivacyInfo.xcprivacy
  41. README.md
  42. SANDBOXING.md
  43. STYLE.md
README.md

BoringSSL

BoringSSL is a fork of OpenSSL that is designed to meet Google's needs.

Although BoringSSL is an open source project, it is not intended for general use, as OpenSSL is. We don't recommend that third parties depend upon it. Doing so is likely to be frustrating because there are no guarantees of API or ABI stability.

Programs ship their own copies of BoringSSL when they use it and we update everything as needed when deciding to make API changes. This allows us to mostly avoid compromises in the name of compatibility. It works for us, but it may not work for you.

BoringSSL arose because Google used OpenSSL for many years in various ways and, over time, built up a large number of patches that were maintained while tracking upstream OpenSSL. As Google's product portfolio became more complex, more copies of OpenSSL sprung up and the effort involved in maintaining all these patches in multiple places was growing steadily.

Currently BoringSSL is the SSL library in Chrome/Chromium, Android (but it's not part of the NDK) and a number of other apps/programs.

Project links:

To file a security issue, use the Chromium process and mention in the report this is for BoringSSL. You can ignore the parts of the process that are specific to Chromium/Chrome.

There are other files in this directory which might be helpful: