| # 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. |