# FC-CACHE - build font information cache files - man - [phpMan]

> **TLDR:** Scan font directories to build font cache files.
>
- Generate font cache files:
  `fc-cache`
- Generate font cache files verbosely:
  `fc-cache {{-v|--verbose}}`
- Force a rebuild of all font cache files, without checking if cache is up-to-date:
  `fc-cache {{-f|--force}}`
- Erase font cache files, then generate new font cache files:
  `fc-cache {{-r|--really-force}}`
- Scan a specific directory:
  `fc-cache {{path/to/directory}}`
- Scan system-wide directories, skipping the user's home directory:
  `fc-cache {{-s|--system-only}}`
- Display version:
  `fc-cache {{-V|--version}}`

*Source: tldr-pages*

---

[_FC-CACHE_(1)](https://www.chedong.com/phpMan.php/man/FC-CACHE/1/markdown)                                                                              [_FC-CACHE_(1)](https://www.chedong.com/phpMan.php/man/FC-CACHE/1/markdown)

## 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 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 con‐
       figuration. 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 cus‐
       tomized for that architecture.

## OPTIONS
       This program follows the usual GNU command line syntax, with long options starting  with  two
       dashes (`-'). A summary of options is included below.

### -E     
              given.

### -f     
              checking.

### -r     

### -s     
              rectory.

### -v     

### -y     

### -h     

### -V     

       _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 proper‐
              ties.  They are read by the fontconfig library at application startup to locate appro‐
              priate fonts.

## SEE ALSO
       [**fc-cat**(1)](https://www.chedong.com/phpMan.php/man/fc-cat/1/markdown) [**fc-list**(1)](https://www.chedong.com/phpMan.php/man/fc-list/1/markdown) [**fc-match**(1)](https://www.chedong.com/phpMan.php/man/fc-match/1/markdown) [**fc-pattern**(1)](https://www.chedong.com/phpMan.php/man/fc-pattern/1/markdown) [**fc-query**(1)](https://www.chedong.com/phpMan.php/man/fc-query/1/markdown) [**fc-scan**(1)](https://www.chedong.com/phpMan.php/man/fc-scan/1/markdown)

       The fontconfig user's guide, in HTML format: _/usr/share/doc/fontconfig/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)](https://www.chedong.com/phpMan.php/man/FC-CACHE/1/markdown)