Name: binutils
URL: http://www.gnu.org/software/binutils/
Version: 2.26
License: GPL v2
License File: NOT_SHIPPED
Security Critical: no

Description:
This directory contains i386 and amd64 binaries of the binutils tools
(including gold linker).

They were built from binutils-2.26 using the "build-all.sh" script on a
Ubuntu Trusty.

The script creates chroots for 32bit and 64bit Ubuntu Precise and then builds
binutils inside the roots. It also builds tcmalloc and links binutils with it
to improve the speed of LTO.

Version 2.26 was released on Mon, 25 Jan 2016

Local patches:
 * long-plt.patch for http://crbug.com/554017 from upstream change
   https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;a=commit;h=ce3e49806d505721e0875e704de0b6fcba7660ed
   (Landed upstream Thu, 17 Dec 2015 - should be in 2.27)
 * icf-rel.patch for https://sourceware.org/bugzilla/show_bug.cgi?id=19047
   from upstream change
   https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;a=commit;h=d114b830426300f80302ca03ff4322942f63c615
   (Landed upstream on 2.26 branch Thu, 5 May 2016,
   and on trunk Fri, 5 Feb 2016 - will be in 2.27)

 * (build-all.sh|build-one.sh|upload.sh) scripts for building the binutils
   binaries and uploading them to Google storage.

Upgrading:

To upgrade binutils, use the following steps:

 * Update build-all.sh with the new binutil version.
 * Remove any patches which have been merged upstream from build-all.sh
 * Update this README.chromium file
 * Run build-all.sh
 * Run upload.sh. Note: you will need write access to
   gs://chromium-binutils bucket on Google Cloud Storage. To get the
   access, subscribe to the internal chrome-team mailing list.
 * Wait for goma to have new binutils deployed (see http://go/ma).
    Please notify {ukai,yyanagisawa,shinyak}@chromium.org and await
    confirmation.
 * Commit the change

See https://codereview.chromium.org/1368233002/ for an example upgrade.