--update, -u

Update the database; indexes new fonts.

--force, -f

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

--local, -L

Include font files in $PWD. This option will cause large parts of the database to be rebuilt. Thus it is quite inefficient. Additionally, if local font files are found, the database is prevented from being saved to disk, so the local fonts need to be parsed with every invocation of luaotfload-tool.

--no-reload, -n

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

--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.

--formats=EXTENSIONS

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

--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).

--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:

--show-blacklist, -b

Show blacklisted files (not directories).

--dry-run, -D

Don’t load fonts when updating the database; scan directories only. (For debugging file system related issues.)

--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.

--max-fonts=N

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

--bisect=DIRECTIVE

Bisection of the font database. This mode is intended as assistance in debugging the Luatex engine, especially when tracking memleaks or buggy fonts.

DIRECTIVE can be one of the following:

A bisection session is initiated by issuing the start directive. This sets the pivot to the middle of the list of available font files. Now run luaotfload-tool with the --update flag set as well as --bisect=run: only the fonts up to the pivot will be considered. If that task exhibited the issue you are tracking, then tell Luaotfload using --bisect=bad. The next step of --bisect=run will continue bisection with the part of the files below the pivot. Likewise, issue --bisect=good in order to continue with the fonts above the pivot, assuming the tested part of the list did not trigger the bug.

Once the culprit font is tracked down, good or bad will have no effect anymore. run will always end up processing the single font file that was left. Use --bisect=stop to clear the bisection state.

--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 numbers of components as well as some basic information 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.

--conf=FILE

Read the configuration from FILE. See luaotfload.conf(%) for documentation concerning the format and available options.

--dumpconf

Print the currently active configuration; the output can be saved to a file and used for bootstrapping a custom configuration files.

--aliases

Dump the font name database as a kpathsea aliases file. This option is experimental and might go away.