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