# man > FC-CACHE(1)

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