User Commands                                         FC-CACHE(1)



NAME
     fc-cache - build font information cache files

SYNOPSIS
     cc [ flag... ] file... -lfontconfig [ library... ]

     fc-cache [ -fsvV? ] [ --force  ]  [  --system-only  ]  [  --
     verbose ] [ --version ] [ --help ] [ dirs ]


DESCRIPTION
     fc-cache scans the font directories on the system and builds
     font information cache files for applications using fontcon-
     fig 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 properties of each font and the asso-
     ciated 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.
     On a subsequent run, fc-cache will augment the cache  infor-
     mation files with the information for the new 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.

     -f --force
          Force  re-generation  of  apparently  up-to-date  cache
          files, overriding the timestamp checking.

     -s --system-only
          Only scan system-wide directories, omitting the  places
          located in the user's home directory.

     -v --verbose
          Display status information while busy.

     -? --help
          Show summary of options.

     -V --version
          Show version of the program and exit.

     dirs A list of directories to scan for fonts.





SunOS 5.10        Last change: 04 November 2007                 1






User Commands                                         FC-CACHE(1)



FILES
     fonts.cache-2
          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-list (1).

     The   fontconfig   user's    guide,    in    HTML    format:
     /usr/share/doc/fontconfig/fontconfig-user.html.

AUTHOR
     This   manual   page   was   written   by   Keith    Packard
      and Josselin Mouette .


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWfontconfig              
    
     Interface Stability          Volatile                    
    
     MT-Level                     See XInitThreads(3X11)      
    


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(5), under the service identifier:

     svc:/application/font/fc-cache

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










SunOS 5.10        Last change: 04 November 2007                 2