This is an archive of the discontinued LLVM Phabricator instance.

[ThinLTO] Update doc to include lld
ClosedPublic

Authored by davide on Oct 12 2016, 4:23 PM.

Download Raw Diff

Details

Reviewers

tejohnson
mehdi_amini

Commits

rG02c3e8cb7d51: [ThinLTO] Update doc to include lld (now supported).
rC284137: [ThinLTO] Update doc to include lld (now supported).
rL284137: [ThinLTO] Update doc to include lld (now supported).

Diff Detail

Repository: rL LLVM

Event Timeline

davide updated this revision to Diff 74455.Oct 12 2016, 4:23 PM

davide retitled this revision from to [ThinLTO] Update doc to include lld.

davide updated this object.

davide added reviewers: tejohnson, mehdi_amini.

davide added a subscriber: cfe-commits.

LGTM, thanks!

This revision is now accepted and ready to land.Oct 12 2016, 4:30 PM

You have to add which platforms are supported.

This revision now requires changes to proceed.Oct 12 2016, 4:41 PM

I mentioned that's ELF only. Are you OK with that or you want me to put more detailed info?

Closed by commit rL284137: [ThinLTO] Update doc to include lld (now supported). (authored by davide). · Explain WhyOct 13 2016, 10:51 AM

This revision was automatically updated to reflect the committed changes.

Revision Contents

Path

Size

cfe/

trunk/

docs/

ThinLTO.rst

6 lines

Diff 74545

cfe/trunk/docs/ThinLTO.rst

	Show First 20 Lines • Show All 56 Lines • ▼ Show 20 Lines
	ThinLTO is currently supported for the following linkers:			ThinLTO is currently supported for the following linkers:

	- gold (via the gold-plugin):			- gold (via the gold-plugin):
	Similar to monolithic LTO, this requires using			Similar to monolithic LTO, this requires using
	a `gold linker configured with plugins enabled			a `gold linker configured with plugins enabled
	<http://llvm.org/docs/GoldPlugin.html>`_.			<http://llvm.org/docs/GoldPlugin.html>`_.
	- ld64:			- ld64:
	Starting with `Xcode 8 <https://developer.apple.com/xcode/>`_.			Starting with `Xcode 8 <https://developer.apple.com/xcode/>`_.
				- lld:
	Additionally, support is being added to the lld linker.			Starting with r284050 (ELF only).

	Usage			Usage
	=====			=====

	Basic			Basic
	-----			-----

	To utilize ThinLTO, simply add the -flto=thin option to compile and link. E.g.			To utilize ThinLTO, simply add the -flto=thin option to compile and link. E.g.
	Show All 29 Lines
	virtual cores. For some applications and machine configurations this			virtual cores. For some applications and machine configurations this
	may be too aggressive, in which case the amount of parallelism can			may be too aggressive, in which case the amount of parallelism can
	be reduced to ``N`` via:			be reduced to ``N`` via:

	- gold:			- gold:
	``-Wl,-plugin-opt,jobs=N``			``-Wl,-plugin-opt,jobs=N``
	- ld64:			- ld64:
	``-Wl,-mllvm,-threads=N``			``-Wl,-mllvm,-threads=N``
				- lld:
				``-Wl,--thinlto-jobs=N``

	Incremental			Incremental
	-----------			-----------
	.. _incremental:			.. _incremental:

	ThinLTO supports fast incremental builds through the use of a cache,			ThinLTO supports fast incremental builds through the use of a cache,
	which currently must be enabled through a linker option.			which currently must be enabled through a linker option.

	Show All 38 Lines