Updated: 16 April 2007
Index Return to Main Contents
NAMEfc-cache - build font information cache files
fc-cache [ -fsvV? ] [ --force ] [ --system-only ] [ --verbose ] [ --version ] [ --help ] [ dirs ]
fc-cache scans the font directories on the system and builds font information cache files for applications using fontconfig for their font handling.
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. On a subsequent run, fc-cache will augment the cache information files with the information for the new architecture.
This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.
- -f --force
- Force re-generation of apparently up-to-date cache files, overriding the timestamp checking.
- -s --system-only
- Only scan system-wide directories, omitting the places located in the user's home directory.
- -v --verbose
- Display status information while busy.
- -? --help
- Show summary of options.
- -V --version
- Show version of the program and exit.
- A list of directories to scan for fonts.
- 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.