| # Pre-generated files |
| |
| This directory contains a number of pre-generated build artifacts. To simplify |
| downstream builds, they are checked into the repository, rather than dynamically |
| generated as part of the build. |
| |
| When developing on BoringSSL, if any inputs to these files are modified, callers |
| must run the following command to update the generated files: |
| |
| go run ./util/pregenerate |
| |
| To check that files are up-to-date without updating files, run: |
| |
| go run ./util/pregenerate -check |
| |
| This is run on CI to ensure the generated files remain up-to-date. |
| |
| To speed up local iteration, the tool accepts additional arguments to filter the |
| files generated. For example, if editing `aesni-x86_64.pl`, this |
| command will only update files with "aesni-x86_64" as a substring. |
| |
| go run ./util/pregenerate aesni-x86_64 |
| |
| For convenience, all files in this directory, including this README, are managed |
| by the tool. This means the whole directory may be deleted and regenerated from |
| scratch at any time. |