luaotfload-tool

--update, -u

Update the database; indexes new fonts.

--force, -f

Force rebuilding of the database; re-indexes all fonts.

--no-reload, -n

Suppress auto-updates to the database (e.g. when --find is passed an unknown name).

--no-strip

Do not strip redundant information after building the database. Warning: this will inflate the index to about two to three times the normal size.

--no-compress, -c

Do not filter the plain text version of the font index through gzip. Useful for debugging if your editor is built without zlib.

--prefer-texmf, -p

Organize the file name database in a way so that it prefer fonts in the TEXMF tree over system fonts if they are installed in both.

--max-fonts=N

Process at most N font files, including fonts already indexed in the count.

--formats=EXTENSIONS

Extensions of the font files to index. Where EXTENSIONS is a comma-separated list of supported file extensions (otf, ttf, ttc, dfont, pfa, and pfb). If the list is prefixed with a + sign, the given list is added to the currently active one; - subtracts. Default: otf,ttf,ttc,dfont. Examples:

--dry-run, -D

Don’t load fonts, scan directories only. (For debugging file system related issues.)

--find=NAME

Resolve a font name; this looks up <name> in the database and prints the file name it is mapped to. --find also understands request syntax, i.e. --find=file:foo.otf checks whether foo.otf is indexed.

--fuzzy, -F

Show approximate matches to the file name if the lookup was unsuccessful (requires --find).

--info, -i

Display basic information to a resolved font file (requires --find).

--inspect, -I

Display detailed information by loading the font and analyzing the font table; very slow! For the meaning of the returned fields see the LuaTeX documentation. (requires --find).

--warnings, -w

Print the warnings generated by the fontloader library (assumes -I). Automatically enabled if the verbosity level exceeds 2.

--show-blacklist, -b

Show blacklisted files (not directories).

--list=CRITERION

Show entries, where CRITERION is one of the following:

For example, in order to output file names and corresponding versions, sorted by the font format:

./luaotfload-tool.lua --list="format" --fields="file->base,version"

This prints:

otf latinmodern-math.otf  Version 1.958
otf lmromancaps10-oblique.otf 2.004
otf lmmono8-regular.otf 2.004
otf lmmonoproplt10-bold.otf 2.004
otf lmsans10-oblique.otf  2.004
otf lmromanslant8-regular.otf 2.004
otf lmroman12-italic.otf  2.004
otf lmsansdemicond10-oblique.otf  2.004
...

--fields=FIELDS

Comma-separated list of fields that should be printed. Information in an unstripped database (see the option --no-strip above) is nested: Subfields of a record can be addressed using the -> separator, e. g. file->location, style->units_per_em, or names->sanitized->english->subfamily. The default is plainname,version*. (Only meaningful with --list.)

--flush-lookups

Clear font name lookup cache (experimental).

--cache=DIRECTIVE

Cache control, where DIRECTIVE is one of the following:

--verbose=N, -v

Set verbosity level to n or the number of repetitions of -v.

--quiet

No verbose output (log level set to zero).

--log=CHANNEL

Redirect log output (for database troubleshooting), where CHANNEL can be

--version, -V

Show version info of components and exit.

--help, -h

Show help message and exit.

--diagnose=CHECK

Run the diagnostic procedure CHECK. Available procedures are:

Procedures can be chained by concatenating with commas, e.g. --diagnose=files,permissions. Specify thorough to run all checks.