On Fri, Sep 08, 2023 at 03:22:32PM -0600, Anthony J. Bentley wrote:
> Lucas Raab writes:
> > +writes a wrapper script to ${WRKDIR}/bin/ld in
>
> Use:
>
> .Pa ${WRKDIR}/bin/ld
>
> I see it's wrong elsewhere in the manpage, but let's not introduce another.
>
> > +.Cm patch
> > +to request that the linker adds an
> > +.Dv PT_OPENBSD_NOBTCFI
> > +ELF section. Use when a port requires no enforcement of indirect branch
>
> The second sentence needs to begin on its own line. This affects
> inter-sentence spacing in the rendered manpage.
Ah, I understand now. I think I was initially confusing that with new
paragraphs starting out on their own line.
>
> ELF section.
> Use when a port ...
>
> > Use when a port requires no enforcement of indirect branch targets.
>
> Reading it again, I think this could be misinterpreted. Better would be
> to word it like USE_NOEXECONLY:
>
> "Use when a port does not work with the default strict enforcement of
> indirect branch targets."
New version attached
diff /usr/src
commit - 2933f00289463a6d1923d1b9cc5e5c1c5c697ece
path + /usr/src
blob - 00ec6c3f81fcf03e2222a69eabe8de1741a6e562
file + share/man/man5/bsd.port.mk.5
--- share/man/man5/bsd.port.mk.5
+++ share/man/man5/bsd.port.mk.5
@@ -3613,6 +3613,22 @@ and not intended to be a user setting.
See
.Ev WRKOBJDIR_MFS
for configuration.
+.It Ev USE_NOBTCFI
+If set to
+.Sq Yes ,
+writes a wrapper script to
+.Pa ${WRKDIR}/bin/ld
+in
+.Cm patch
+to request that the linker adds an
+.Dv PT_OPENBSD_NOBTCFI
+ELF section.
+Use when a port does not work with the default strict enforcement of
+indirect branch targets.
+.Pp
+Applies to all architectures; set
+.Ev USE_NOBTCFI-${MACHINE_ARCH}
+to apply to only a specific architecture.
.It Ev USE_NOEXECONLY
If set to
.Sq Yes ,
