Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 10, 2021
 
 

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(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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+---------------------------+
       |ATTRIBUTE TYPE |     ATTRIBUTE VALUE       |
       +---------------+---------------------------+
       |Availability   | system/library/fontconfig |
       +---------------+---------------------------+
       |Stability      | Volatile                  |
       +---------------+---------------------------+
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>.

NOTES
       fc-cache is run automatically at system boot to ensure font caches  are
       up  to  date via the fc-cache service.  The fc-cache service is managed
       by the Service Management Facility, smf(7), under the  service  identi-
       fier:

       svc:/application/font/fc-cache

       Administrative actions on this service, such as enabling, disabling, or
       requesting restart, can be performed using  svcadm(8).   The  service's
       status can be queried using the svcs(1) command.


       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source  was  downloaded  from   https://fontconfig.org/release/fontcon-
       fig-2.12.1.tar.bz2

       Further information about this software can be found on the open source
       community website at https://fontconfig.org/.



                                 Aug 13, 2008                      FC-CACHE(1)