Home | History | Annotate | Download | only in bot
      1 This directory consumes tools from other repositories for use on the
      2 bots. 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 
      9 To update to newer revisions, follow these instructions:
     10 
     11 DEPS: 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 
     15 go/bootstrap.py: Set TOOLSET_VERSION to the latest release of Go, found at
     16     https://golang.org/dl/.
     17 
     18 update_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 
     22 vs_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 
     27 The .sha1 files correspond to files downloaded from Google Cloud Storage. To
     28 update, place the updated files in their intended location and run:
     29 
     30     upload_to_google_storage.py -b chromium-tools FILE
     31 
     32 cmake-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 
     40 cmake-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 
     45 cmake-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 
     51 nasm-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 
     61 perl-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 
     67 yasm-win32.exe: Update to the appropriate release of Yasm. Use the same version
     68     as Chromium, found at
     69     https://chromium.googlesource.com/chromium/src/+/master/third_party/yasm/README.chromium
     70     Use the release at http://yasm.tortall.net/Download.html labeled
     71     "Win32 .exe". The download will be named yasm-VERSION-win32.exe.
     72 
     73     The current revision is yasm-1.3.0-win32.exe.
     74 
     75 Finally, update sde-linux64.tar.bz2 and sde-win32.tar.bz2 by downloading the
     76 latet release from Intel at
     77 https://software.intel.com/en-us/articles/intel-software-development-emulator,
     78 but upload it with the following command. (Note the bucket is different.)
     79 
     80     upload_to_google_storage.py -b chrome-boringssl-sde sde-linux64.tar.bz2 sde-win32.tar.bz2
     81 
     82 The current revision is sde-external-8.16.0-2018-01-30-*.tar.bz2.
     83 
     84 When adding new files, remember to update .gitignore.
     85