xref: /freebsd/tools/build/options/WITH_BEARSSL (revision bf4f27e85aa62e459fb4cde9ebd51e32bdac7910)
1a92958dfSSimon J. GerratyBuild the BearSSL library.
2a92958dfSSimon J. Gerraty.Pp
3a92958dfSSimon J. GerratyBearSSL is a tiny SSL library suitable for embedded environments.
4a92958dfSSimon J. GerratyFor details see
5e515b9b4SWolfram Schneider.Lk https://www.BearSSL.org/
6a92958dfSSimon J. Gerraty.Pp
7a92958dfSSimon J. GerratyThis library is currently only used to perform
8a92958dfSSimon J. Gerratysignature verification and related operations
9a92958dfSSimon J. Gerratyfor Verified Exec and
10a92958dfSSimon J. Gerraty.Xr loader 8 .
117ee781e2SWarner Losh.Pp
12*bf4f27e8SWarner LoshDue to size constraints in the BIOS environment on x86, one may need to set
137ee781e2SWarner Losh.Va LOADERSIZE
147ee781e2SWarner Loshlarger than the
157ee781e2SWarner Loshdefault 500000, although often loader is under the 500k limit even with
167ee781e2SWarner Loshthis option.
177ee781e2SWarner LoshSetting
187ee781e2SWarner Losh.Va LOADERSIZE
197ee781e2SWarner Loshlarger than 500000 may cause
207ee781e2SWarner Losh.Xr pxeboot 8
217ee781e2SWarner Loshto be too large to work.
227ee781e2SWarner LoshCareful testing of the loader in the target environment when built with a larger
237ee781e2SWarner Loshlimit to establish safe limits is critical because different BIOS environments
247ee781e2SWarner Loshreserve differing amounts of the low 640k space, making a precise limit for
257ee781e2SWarner Losheverybody impossible.
267ee781e2SWarner Losh.Pp
277ee781e2SWarner LoshSee also
287ee781e2SWarner Losh.Va WITH_LOADER_PXEBOOT
297ee781e2SWarner Loshfor other considerations.
30