LLD: man pages missing?

[O. Hartmann]

I have installed most recent CURRENT as of r327219 with LLD_IS_LD=YES set
via /etc/src.conf.

I try to find some options and tried "man ld", "man lld" and "ld.lld". In the the latter
two cases there can nothing be found on the system and man ld always seems to refer to
the GNU linker - which is, I believe, the linker reached by /usr/bin/ld.bfd. There is
also a linker "ld" in /usr/local/bin/ld from binutils-2.28,1.

Can someone help?

Thnaks,

oh

[Dimitry Andric]

Post by O. Hartmann
I have installed most recent CURRENT as of r327219 with LLD_IS_LD=YES set
via /etc/src.conf.
I try to find some options and tried "man ld", "man lld" and "ld.lld". In the the latter
two cases there can nothing be found on the system and man ld always seems to refer to
the GNU linker - which is, I believe, the linker reached by /usr/bin/ld.bfd. There is
also a linker "ld" in /usr/local/bin/ld from binutils-2.28,1.

There is no manpage yet. Upstream provides a bit of Sphinx-based
documentation (e.g. in .rst format), but there is no specific manpage.

Since lld is now approaching a quite usable state, maybe it is time for
a request to upstream to provide one. ;)

-Dimitry

[Oliver Pinter]

Post by O. Hartmann

Post by O. Hartmann
I have installed most recent CURRENT as of r327219 with LLD_IS_LD=YES set
via /etc/src.conf.
I try to find some options and tried "man ld", "man lld" and "ld.lld".

In the the latter

Post by O. Hartmann
two cases there can nothing be found on the system and man ld always

seems to refer to

Post by O. Hartmann
the GNU linker - which is, I believe, the linker reached by

/usr/bin/ld.bfd. There is

Post by O. Hartmann
also a linker "ld" in /usr/local/bin/ld from binutils-2.28,1.

There is no manpage yet. Upstream provides a bit of Sphinx-based
documentation (e.g. in .rst format), but there is no specific manpage.
Since lld is now approaching a quite usable state, maybe it is time for
a request to upstream to provide one. ;)

The same would be nice for clang too. Its default man page is poor.

Post by O. Hartmann
-Dimitry

[Ed Maste]

Post by Dimitry Andric
Since lld is now approaching a quite usable state, maybe it is time for
a request to upstream to provide [a manpage]. ;)

Yes, it would've been nice if an upstream man page was created early
on and had been kept up to date as features were added. In any case,
lld is otherwise close to being ready to be installed as /usr/bin/ld
on FreeBSD/amd64, and I suspect we might have to just create the man
page (and send it upstream).

Other than the man page I'm aware of some issues with ifunc support
discovered by kib@ while working on kernel ifunc. This doesn't affect
FreeBSD-HEAD yet (as we don't use ifunc today) but will soon be
important. There's also additional work needed for the ports tree,
although right now ~99.5 of the ports collection builds when lld is
/usr/bin/ld. Most ports that were failing with lld have either been
fixed, or worked around via LLD_UNSAFE so that the port continues
using ld.bfd.

[Ed Maste]

Post by O. Hartmann
I have installed most recent CURRENT as of r327219 with LLD_IS_LD=YES set
via /etc/src.conf.
I try to find some options and tried "man ld", "man lld" and "ld.lld". In the the latter
two cases there can nothing be found on the system and man ld always seems to refer to
the GNU linker - which is, I believe, the linker reached by /usr/bin/ld.bfd. There is
also a linker "ld" in /usr/local/bin/ld from binutils-2.28,1.
Can someone help?

krion@ started a man page, and Arshan Khanifar expanded it based on
ld.lld --help output; I've added a brief introduction and have
expanded the descriptions for some of the options.

What we have so far is in review at
https://reviews.freebsd.org/D13813. It's still rather bare-bones, but
I would like to commit it soon so that we have something to start
from, and continue fleshing it out in HEAD. Review and additional
content most welcome.

[Ed Maste]

Post by Ed Maste
What we have so far is in review at
https://reviews.freebsd.org/D13813. It's still rather bare-bones, but
I would like to commit it soon so that we have something to start
from, and continue fleshing it out in HEAD. Review and additional
content most welcome.

I've now committed this initial version as r327770 after incorporating
feedback from ***@. We'll iterate on expanding the documentation for
the individual options, and submit this upstream to lld soon. I'm
still very interested in additional review and content.

[O. Hartmann]

Am Wed, 10 Jan 2018 12:36:28 -0500

Post by Ed Maste

Post by Ed Maste
What we have so far is in review at
https://reviews.freebsd.org/D13813. It's still rather bare-bones, but
I would like to commit it soon so that we have something to start
from, and continue fleshing it out in HEAD. Review and additional
content most welcome.

I've now committed this initial version as r327770 after incorporating
the individual options, and submit this upstream to lld soon. I'm
still very interested in additional review and content.
_______________________________________________
https://lists.freebsd.org/mailman/listinfo/freebsd-current

Thank you very much! Great work.

Kind regards,

Oliver