Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   9211 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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
       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 proper‐
       ties 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
       options	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)

Vote for polarhome