FC-CACHE(1) FC-CACHE(1)
NAME
fc-cache - build font information cache files
SYNOPSIS
fc-cache [ -EfrsvVh ] [ --error-on-no-fonts ] [ --force ] [ --really-
force ] [ [ -y dir ] [ --sysroot dir ] ] [ --system-only ] [
--verbose ] [ --version ] [ --help ] [ dir... ]
DESCRIPTION
fc-cache scans the font directories on the system and builds font infor-
mation cache files for applications using fontconfig for their font han-
dling.
If directory arguments are not given, fc-cache uses each directory in
the current font configuration. Each directory is scanned for font files
readable by FreeType. A cache is created which contains properties of
each font and the associated filename. This cache is used to speed up
application startup when using the fontconfig library.
Note that fc-cache must be executed once per architecture to generate
font information customized for that architecture.
OPTIONS
This program follows the usual GNU command line syntax, with long op-
tions starting with two dashes (`-'). A summary of options is included
below.
-E Raise an error if there are no fonts in dir or directories in the
configuration if not given.
-f Force re-generation of apparently up-to-date cache files, over-
riding the timestamp checking.
-r Erase all existing cache files and rescan.
-s Only scan system-wide directories, omitting the places located in
the user's home directory.
-v Display status information while busy.
-y Prepend dir to all paths for scanning.
-h Show summary of options.
-V Show version of the program and exit.
dir Directory to scan for fonts.
RETURN CODES
fc-cache returns zero if the caches successfully generated. otherwise
non-zero.
FILES
%cachedir%/*-%arch%.cache-%version%
These files are generated by fc-cache and contain maps from file
names to font properties. They are read by the fontconfig library
at application startup to locate appropriate fonts.
SEE ALSO
fc-cat(1) fc-list(1) fc-match(1) fc-pattern(1) fc-query(1) fc-scan(1)
The fontconfig user's guide, in HTML format: /usr/share/doc/fontcon-
fig/fontconfig-user.html.
AUTHOR
This manual page was written by Keith Packard <keithp@keithp.com> and
Josselin Mouette <joss@debian.org>.
Aug 13, 2008 FC-CACHE(1)
Generated by dwww version 1.16 on Tue Dec 16 04:57:06 CET 2025.