xref: /aosp_15_r20/external/boringssl/src/util/bot/UPDATING (revision 8fb009dc861624b67b6cdb62ea21f0f22d0c584b)
1This directory consumes tools from other repositories for use on the
2bots. For a similarly-configured local checkout for testing, run:
3
4   mkdir boringssl-gclient
5   cd boringssl-gclient
6   gclient config --unmanaged --deps-file=util/bot/DEPS https://boringssl.googlesource.com/boringssl/
7   gclient sync
8
9To update to newer revisions, follow these instructions:
10
11DEPS: Update the variables as described in the comments.
12
13update_clang.py: Set CLANG_REVISION and CLANG_SUB_REVISION to the values used in
14    Chromium, found at
15    https://chromium.googlesource.com/chromium/src/+/main/tools/clang/scripts/update.py
16
17vs_toolchain.py: Update _GetDesiredVsToolchainHashes from Chromium, found at
18    https://chromium.googlesource.com/chromium/src/+/main/build/vs_toolchain.py
19    This may require taking other updates to that file. (Don't remove MSVC
20    versions if BoringSSL still needs to support them.)
21
22The .sha1 files correspond to files downloaded from Google Cloud Storage. To
23update, place the updated files in their intended location and run:
24
25    upload_to_google_storage.py -b chromium-tools FILE
26
27nasm-win32.exe: Update to the appropriate release of NASM, found at
28    https://www.nasm.us/. Use the same version as Chromium, found at
29    https://chromium.googlesource.com/chromium/deps/nasm/+/refs/heads/main/README.chromium
30    Extract nasm.exe from the download named nasm-VERSION-win64.zip.
31
32    The current revision is nasm-2.13.03-win64.zip.
33
34Finally, update sde-linux64.tar.xz and sde-win32.tar.xz by downloading the
35latet release from Intel at
36https://software.intel.com/en-us/articles/intel-software-development-emulator,
37but upload it with the following command. (Note the bucket is different.)
38
39    upload_to_google_storage.py -b chrome-boringssl-sde sde-linux64.tar.xz sde-win32.tar.xz
40
41The current revision is sde-external-9.38.0-2024-04-18-*.tar.xz.
42
43When adding new files, remember to update .gitignore.
44