LUATEX(1)                   General Commands Manual                  LUATEX(1)

<?><?><?> (NAME)
       luatex, dviluatex, luahbtex, luajithbtex, luajittex, texlua, texluac,
       texluajit, texluajitc - <?><?><?><?><?> TeX
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> Lua <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       luatex [--lua=luafile]  [options] [&format]  [ file [ more-input ] | [
       \more-input ]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?><?> LuaTeX <?><?> <?><?><?> file[.tex]
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> file.pdf
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <<.tex>> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?>. <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> tex(1) <?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> LuaTeX <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> pdfTeX
       <?><?> lua(1) <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> Unicode <?>
       OpenType/TrueType<?> <?><?><?><?><?><?><?><?><?><?> e-TeX <?> Omega<?>
       <?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> MetaPost <?><?><?><?> <?><?> <?><?><?>
       <?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> pdf <?><?> dvi <?><?><?><?><?> <?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> LuaTeX<?>
       <?><?> https://www.luatex.org <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> LuaTeX <?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> texdoc <?><?><?><?><?><?>
       <?><?><?><?><?><?> (texdoc luatex).

       <?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?> <?><?>
       LuaTeX <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       Unicode <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> (encoding) <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?>. <?><?><?><?><?>: <?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> Unicode <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?>.

       <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> texlua
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> Lua <?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?>
       <?><?><?> texluac <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       Lua <?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> luatex <?><?><?><?><?> pdf
       <?><?><?><?><?> <?><?><?><?><?><?> <?> dviluatex <?><?><?><?><?> dvi
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>. <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> dvi <?><?> pdf <?><?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?> <?><?><?><?> pdf<?> <?><?><?><?><?> LuaTeX
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> pdf<?> jpg<?> jbig2 <?>
       png <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> PostScript <?><?> Encapsulated
       PostScript (eps) <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       pdftex(1) <?><?> <?><?><?><?><?><?>. <?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> PostScript <?><?><?><?><?>
       MetaPost <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> supp-pdf.tex <?> supp-pdf.mkii
       <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> luatex
       <?><?> Lua 5.3 <?><?> <?><?><?><?> PUC-Rio <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> jit <?><?><?><?><?> luajittex <?><?><?><?><?>
       LuaJIT <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> (just-in-time)
       <?><?><?><?><?> <?><?> <?><?><?><?> Mike Pall <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?>.

       <?><?><?><?> luahbtex <?><?><?><?> <?><?><?><?><?> HarfBuzz
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (glyph
       shaping) <?><?><?>. <?><?> <?><?><?> <?><?><?> HarfBuzz
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> TeX <?><?><?><?> <?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> LuaTeX <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> (primitives) <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> TeX3 <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       \directlua <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       LuaTeX <?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> luatex.ini <?><?><?><?><?><?>
       <?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> TeX <?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> tex(1) <?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> LuaTeX
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> --lua
       <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> --lua <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> pdfTeX <?><?><?><?> <?> Aleph <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> LuaTeX <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> Web2C
       <?><?><?><?><?>. <?><?><?><?><?><?><?><?> <?><?><?><?> --lua
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> Lua
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> Kpathsea <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?>/<?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> (hook) <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (callbacks) <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?>.

       --lua=luafile
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> Lua.
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> LuaTeX <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> (luatex-core.lua) <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> luafile
              <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?>. <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> Lua
              <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> (crash).
              <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> (format
              dumping) <?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?> ConTeXt <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>.

       <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>:

       --luaonly
              <?><?><?><?><?> LuaTeX <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> Lua. <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> arg[0] <?><?> Lua <?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> Lua. <?><?><?><?><?> LuaTeX
              <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> Lua <?><?><?><?>
              <?><?><?><?><?> <?><?>.

       --luaconly
              <?><?><?><?><?> LuaTeX <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> Lua. <?><?>
              <?><?><?> <?><?><?><?><?> LuaTeX <?><?><?><?><?><?> <?><?><?><?>
              <?><?> luac <?><?> <?><?><?><?><?> <?><?><?><?><?> Lua <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> -l <?><?><?> <?> <?><?><?><?><?>
              --luaconly <?><?> <?><?><?><?><?><?><?><?> <?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       --safer
              <?><?><?><?><?> <?><?><?><?><?> Lua <?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       --luadebug
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> debug <?><?> Lua
              <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> shell-escape
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       --[no-]socket
              <?><?><?><?><?> socket <?><?> Lua <?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> TeX
              <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> shell escape <?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?> (ENVIRONMENT)
       tex(1) <?> pdftex(1) <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?><?> (BUGS)
       tex(1) <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       aleph(1), etex(1), lua(1), mpost(1), pdftex(1), tex(1).

       <?><?><?><?> <?><?><?><?> LuaTeX: https://luatex.org
       <?><?><?><?> <?><?><?><?> <?><?> CTAN: https://ctan.org/pkg/luatex
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> LuaTeX:
       https://mirror.ctan.org/systems/doc/luatex/luatex.pdf
       <?><?><?><?><?><?><?> Web2c: https://tug.org/web2c
       <?><?><?><?><?><?><?> Kpathsea: https://tug.org/kpathsea

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       LuaTeX <?><?> TUGboat <?><?><?><?><?> <?><?><?> <?><?><?>:
       https://tug.org/TUGboat/Contents

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?><?><?> TeX <?><?><?><?> Donald E. Knuth <?><?><?><?><?>
       <?><?>.  <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> LuaTeX
       <?><?><?><?><?><?><?> <?><?> Taco Hoekwater<?> Hartmut Henkel<?> Hans
       Hagen <?> Luigi Scarso<?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       Martin Schroder<?> Karel Skoupy <?> Han The Thanh.

       <?><?><?><?><?><?><?><?><?> <?><?><?>: dev-luatex@ntg.nl
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> LuaTeX:
       https://lists.tug.org/luatex
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> TeX:
       https://lists.tug.org/texhax

Web2C 2026                     14 February 2026                      LUATEX(1)