1FC-CACHE(1)                                                        FC-CACHE(1)
2
3
4

NAME

6       fc-cache - build font information cache files
7

SYNOPSIS

9       fc-cache  [  -EfrsvVh  ]   [  --error-on-no-fonts  ]   [  --force  ]  [
10       --really-force ]  [  [ -y dir ]  [ --sysroot dir ]  ]  [  --system-only
11       ]  [ --verbose ]  [ --version ]  [ --help ]  [ dir... ]
12

DESCRIPTION

14       fc-cache  scans  the  font  directories  on  the system and builds font
15       information cache files for applications  using  fontconfig  for  their
16       font handling.
17
18       If  directory  arguments are not given, fc-cache uses each directory in
19       the current font configuration. Each  directory  is  scanned  for  font
20       files  readable  by FreeType. A cache is created which contains proper‐
21       ties of each font and the associated filename.  This cache is  used  to
22       speed up application startup when using the fontconfig library.
23
24       Note  that  fc-cache must be executed once per architecture to generate
25       font information customized for that architecture.
26

OPTIONS

28       This program follows the usual  GNU  command  line  syntax,  with  long
29       options  starting  with  two  dashes  (`-').  A  summary  of options is
30       included below.
31
32       -E     Raise an error if there are no fonts in dir  or  directories  in
33              the configuration if not given.
34
35       -f     Force  re-generation of apparently up-to-date cache files, over‐
36              riding the timestamp checking.
37
38       -r     Erase all existing cache files and rescan.
39
40       -s     Only scan system-wide directories, omitting the  places  located
41              in the user's home directory.
42
43       -v     Display status information while busy.
44
45       -y     Prepend dir to all paths for scanning.
46
47       -h     Show summary of options.
48
49       -V     Show version of the program and exit.
50
51       dir    Directory to scan for fonts.
52

RETURN CODES

54       fc-cache  returns  zero if the caches successfully generated. otherwise
55       non-zero.
56

FILES

58       %cachedir%/*-%arch%.cache-%version%
59              These files are generated by fc-cache and contain maps from file
60              names  to  font  properties.  They  are  read  by the fontconfig
61              library at application startup to locate appropriate fonts.
62

SEE ALSO

64       fc-cat(1) fc-list(1) fc-match(1) fc-pattern(1) fc-query(1) fc-scan(1)
65
66       The fontconfig user's guide, in  HTML  format:  /usr/share/doc/fontcon‐
67       fig/fontconfig-user.html.
68

AUTHOR

70       This  manual  page was written by Keith Packard <keithp@keithp.com> and
71       Josselin Mouette <joss@debian.org>.
72
73
74
75                                 Aug 13, 2008                      FC-CACHE(1)