Directory support/extractbb

extractbb-lua ===============

A reimplementation of extractbb, written in Lua.

Variants

There are two variants of extractbb-lua:

• wrapper: A wrapper script around the original xdvipdmfx-based extractbb that is used to fix a security vulernability in xdvipdfmx.

• scratch: A standalone implementation of extractbb, written in Lua from scratch, with no dependencies on xdvipdfmx.

Currently, the script extractbb defaults to the wrapper variant, but you can manually select any specific variant by setting the TEXLIVE_EXTRACTBB environment variable to either wrapper or scratch.

!WARNING
The scratch variant is still in development and may be buggy or
insecure.

Secret Developer Options

If you set TEXLIVE_EXTRACTBB to the full path of an executable, it will run that directly. And if you set TEXLIVE_EXTRACTBB_UNSAFE=unsafe, then it will ignore some of the security checks.

Support

If you have any problems with this tool, please report it (in order of preference):

1. By opening a new issue on GitHub.

1. Via email to the public tex-live@tug.org mailing list.

1. By contacting the author directly at tex@maxchernoff.ca.

Building

Please see the file documentation/BUILDING.md on GitHub.

Licence

extractbb-lua is licensed under the Mozilla Public License, version 2.0 or greater. The documentation is additionally licensed under CC-BY-SA, version 4.0 or greater.

The test files have various licences, please see the file tests/LICENCE.md for more information. (Since these files are not distributed with the package, neither is this licence file.)

v1.0.6 (2024-11-21)