This is an archive of the discontinued LLVM Phabricator instance.

Differential D30321

Mention FreeBSD ports status and wordsmithing.
ClosedPublic

Authored by ruiu on Feb 23 2017, 7:23 PM.

Details

Reviewers
silvas
Commits
rGbb361fcba1ab: Mention FreeBSD ports status and wordsmithing.
rLLD296157: Mention FreeBSD ports status and wordsmithing.
rL296157: Mention FreeBSD ports status and wordsmithing.
Summary

Mention FreeBSD ports status and wordsmithing.

Diff Detail

Repository
rL LLVM

Event Timeline

ruiu created this revision.Feb 23 2017, 7:23 PM
Harbormaster completed remote builds in B4235: Diff 89604.Feb 23 2017, 7:23 PM
Herald added a subscriber: emaste. · View Herald TranscriptFeb 23 2017, 7:23 PM
silvas accepted this revision.Feb 23 2017, 9:27 PM

LGTM

This revision is now accepted and ready to land.Feb 23 2017, 9:27 PM
Closed by commit rL296157: Mention FreeBSD ports status and wordsmithing. (authored by ruiu). · Explain WhyFeb 24 2017, 11:06 AM
This revision was automatically updated to reflect the committed changes.

Revision Contents

PathSize
lld/
trunk/
docs/
20 lines

Diff 89699

lld/trunk/docs/index.rst

Show All 11 Lines
the Windows debug info (PDB) support. The Mach-O port is built based the Windows debug info (PDB) support. The Mach-O port is built based
on a different architecture than the ELF or COFF ports. For the on a different architecture than the ELF or COFF ports. For the
details about Mach-O, please read :doc:`AtomLLD`. details about Mach-O, please read :doc:`AtomLLD`.
Features Features
-------- --------
- LLD is a drop-in replacement for the GNU linkers. That accepts the - LLD is a drop-in replacement for the GNU linkers. That accepts the
same command line arguments and linker scripts as GNU. Although our same command line arguments and linker scripts as GNU.
linker is relatively new and still in active development, that is
already able to link the entire FreeBSD/amd64 base system including We are currently working closely with the FreeBSD project to make
the kernel. We are currently working closely with the FreeBSD LLD default system linker in future versions of the operating
project to make LLD default system linker in future versions of the system, so we are serious about addressing compatibility issues. As
operating system, so we are serious about addressing compatibility of February 2017, LLD is able to link the entire FreeBSD/amd64 base
issues. system including the kernel. With a few work-in-progress patches it
can link approximately 95% of the ports collection on AMD64. For the
details, see `FreeBSD quarterly status report
<https://www.freebsd.org/news/status/report-2016-10-2016-12.html#Using-LLVM%27s-LLD-Linker-as-FreeBSD%27s-System-Linker>`.
- LLD is very fast. When you link a large program on a multicore - LLD is very fast. When you link a large program on a multicore
machine, you can expect that LLD runs more than twice as fast as GNU machine, you can expect that LLD runs more than twice as fast as GNU
gold linker. Your milage may vary, though. gold linker. Your milage may vary, though.
- It supports various CPUs/ABIs including x86-64, x86, x32, AArch64, - It supports various CPUs/ABIs including x86-64, x86, x32, AArch64,
ARM, MIPS 32/64 big/little-endian, PowerPC, PowerPC 64 and AMDGPU. ARM, MIPS 32/64 big/little-endian, PowerPC, PowerPC 64 and AMDGPU.
Among these, x86-64 is the most well-supported target and have Among these, x86-64 is the most well-supported target and have
▲ Show 20 Lines • Show All 87 Lines • ▼ Show 20 Lines
- October 2015: Succeeded to self-host the ELF port. We have noticed - October 2015: Succeeded to self-host the ELF port. We have noticed
that the linker was faster than the GNU linkers, but we weren't sure that the linker was faster than the GNU linkers, but we weren't sure
at the time if we would be able to keep the gap as we would add more at the time if we would be able to keep the gap as we would add more
features to the linker. features to the linker.
- July 2016: Started working on improving the linker script support. - July 2016: Started working on improving the linker script support.
- December 2016: Succeeded to build the entire FreeBSD base system - December 2016: Succeeded to build the entire FreeBSD base system
including the kernel. We had widen the gap against the GNU linkers. including the kernel. We had widen the performance gap against the
GNU linkers.
Internals Internals
--------- ---------
For the internals of the linker, please read :doc:`NewLLD`. It is a bit For the internals of the linker, please read :doc:`NewLLD`. It is a bit
outdated but the fundamental concepts remain valid. We'll update the outdated but the fundamental concepts remain valid. We'll update the
document soon. document soon.
.. toctree:: .. toctree::
:maxdepth: 1 :maxdepth: 1
NewLLD NewLLD
AtomLLD AtomLLD
windows_support windows_support
ReleaseNotes ReleaseNotes