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: Set all revisions to those used in Chromium, found at
12   https://chromium.googlesource.com/chromium/src/+/master/DEPS (Search for the
13   corresponding repository name.)
14
15go/bootstrap.py: Set TOOLSET_VERSION to the latest release of Go, found at
16    https://golang.org/dl/.
17
18update_clang.py: Set CLANG_REVISION and CLANG_SUB_REVISION to the values used in
19    Chromium, found at
20    https://chromium.googlesource.com/chromium/src/+/master/tools/clang/scripts/update.py
21
22vs_toolchain.py: Update _GetDesiredVsToolchainHashes from Chromium, found at
23    https://chromium.googlesource.com/chromium/src/+/master/build/vs_toolchain.py
24    This may require taking other updates to that file. (Don't remove MSVC
25    versions if BoringSSL still needs to support them.)
26
27The .sha1 files correspond to files downloaded from Google Cloud Storage. To
28update, place the updated files in their intended location and run:
29
30    upload_to_google_storage.py -b chromium-tools FILE
31
32cmake-linux64.tar.gz: Download the latest CMake source tarball, found at
33    https://cmake.org/download/. Build it with:
34
35        ./bootstrap --prefix=$PWD/cmake-linux64 && make && make install
36        tar -czf cmake-linux64.tar.gz cmake-linux64/
37
38    The current revision was built against cmake-3.10.0.tar.gz.
39
40cmake-mac.tar.gz: Follow the same instructions as above on a Mac, but replace
41    cmake-linux64 with cmake-mac.
42
43    The current revision was built against cmake-3.10.0.tar.gz.
44
45cmake-win32.zip: Update to the latest prebuilt release of CMake, found at
46    https://cmake.org/download/. Use the file labeled "Windows win64-x64
47    ZIP". The download will be named cmake-VERSION-win64-x64.zip.
48
49    The current revision is cmake-3.11.4-win64-x64.zip
50
51nasm-win32.exe: Update to the appropriate release of NASM, found at
52    https://www.nasm.us/. Use the same version as Chromium, found at
53    https://chromium.googlesource.com/chromium/src/+/master/third_party/nasm/README.chromium
54    Extract nasm.exe from the download named nasm-VERSION-win64.zip.
55
56    The current revision is nasm-2.13.03-win64.zip.
57
58    TODO(davidben): The Chromium link currently does not work. It will get
59    filled in in the future. See https://crbug.com/766721.
60
61perl-win32.zip: Update to the latest 64-bit prebuilt "Portable" edition of
62    Strawberry Perl, found at http://strawberryperl.com/releases.html. The
63    download will be named strawberry-perl-VERSION-64bit-portable.zip.
64
65    The current revision is strawberry-perl-5.26.2.1-64bit-portable.zip.
66
67Finally, update sde-linux64.tar.bz2 and sde-win32.tar.bz2 by downloading the
68latet release from Intel at
69https://software.intel.com/en-us/articles/intel-software-development-emulator,
70but upload it with the following command. (Note the bucket is different.)
71
72    upload_to_google_storage.py -b chrome-boringssl-sde sde-linux64.tar.bz2 sde-win32.tar.bz2
73
74The current revision is sde-external-8.50.0-2020-03-26-*.tar.bz2.
75
76When adding new files, remember to update .gitignore.
77