{
    "mode": "man",
    "parameter": "FC-CACHE",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/man/FC-CACHE/json",
    "generated": "2026-10-22T13:06:19Z",
    "synopsis": "fc-cache  [ -EfrsvVh ]  [ --error-on-no-fonts ]  [ --force ]  [ --really-force ]  [  [ -y dir\n]  [ --sysroot dir ]  ]  [ --system-only ]  [ --verbose ]  [  --version  ]   [  --help  ]   [\ndir... ]",
    "sections": {
        "NAME": {
            "content": "fc-cache - build font information cache files\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "fc-cache  [ -EfrsvVh ]  [ --error-on-no-fonts ]  [ --force ]  [ --really-force ]  [  [ -y dir\n]  [ --sysroot dir ]  ]  [ --system-only ]  [ --verbose ]  [  --version  ]   [  --help  ]   [\ndir... ]\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "fc-cache scans the font directories on the system and builds font information cache files for\napplications using fontconfig for their font handling.\n\nIf  directory  arguments are not given, fc-cache uses each directory in the current font con‐\nfiguration. Each directory is scanned for font files readable by FreeType. A cache is created\nwhich contains properties of each font and the associated filename.  This cache  is  used  to\nspeed up application startup when using the fontconfig library.\n\nNote  that  fc-cache must be executed once per architecture to generate font information cus‐\ntomized for that architecture.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "This program follows the usual GNU command line syntax, with long options starting  with  two\ndashes (`-'). A summary of options is included below.\n",
            "subsections": [
                {
                    "name": "-E",
                    "content": "given.\n",
                    "flag": "-E"
                },
                {
                    "name": "-f",
                    "content": "checking.\n",
                    "flag": "-f"
                },
                {
                    "name": "-r",
                    "content": "",
                    "flag": "-r"
                },
                {
                    "name": "-s",
                    "content": "rectory.\n",
                    "flag": "-s"
                },
                {
                    "name": "-v",
                    "content": "",
                    "flag": "-v"
                },
                {
                    "name": "-y",
                    "content": "",
                    "flag": "-y"
                },
                {
                    "name": "-h",
                    "content": "",
                    "flag": "-h"
                },
                {
                    "name": "-V",
                    "content": "dir    Directory to scan for fonts.\n",
                    "flag": "-V"
                }
            ]
        },
        "RETURN CODES": {
            "content": "fc-cache returns zero if the caches successfully generated. otherwise non-zero.\n",
            "subsections": []
        },
        "FILES": {
            "content": "%cachedir%/*-%arch%.cache-%version%\nThese files are generated by fc-cache and contain maps from file names to font proper‐\nties.  They are read by the fontconfig library at application startup to locate appro‐\npriate fonts.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "fc-cat(1) fc-list(1) fc-match(1) fc-pattern(1) fc-query(1) fc-scan(1)\n\nThe fontconfig user's guide, in HTML format: /usr/share/doc/fontconfig/fontconfig-user.html.\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "This manual page was written  by  Keith  Packard  <keithp@keithp.com>  and  Josselin  Mouette\n<joss@debian.org>.\n\nAug 13, 2008                                 FC-CACHE(1)",
            "subsections": []
        }
    },
    "summary": "fc-cache - build font information cache files",
    "flags": [
        {
            "flag": "-E",
            "long": null,
            "arg": null,
            "description": "given."
        },
        {
            "flag": "-f",
            "long": null,
            "arg": null,
            "description": "checking."
        },
        {
            "flag": "-r",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-s",
            "long": null,
            "arg": null,
            "description": "rectory."
        },
        {
            "flag": "-v",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-y",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-h",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-V",
            "long": null,
            "arg": null,
            "description": "dir Directory to scan for fonts."
        }
    ],
    "examples": [],
    "see_also": [
        {
            "name": "fc-cat",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-cat/1/json"
        },
        {
            "name": "fc-list",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-list/1/json"
        },
        {
            "name": "fc-match",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-match/1/json"
        },
        {
            "name": "fc-pattern",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-pattern/1/json"
        },
        {
            "name": "fc-query",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-query/1/json"
        },
        {
            "name": "fc-scan",
            "section": "1",
            "url": "https://www.chedong.com/phpMan.php/man/fc-scan/1/json"
        }
    ],
    "tldr": {
        "source": "official",
        "description": "Scan font directories to build font cache files.",
        "examples": [
            {
                "description": "Generate font cache files",
                "command": "fc-cache"
            },
            {
                "description": "Generate font cache files verbosely",
                "command": "fc-cache {{-v|--verbose}}"
            },
            {
                "description": "Force a rebuild of all font cache files, without checking if cache is up-to-date",
                "command": "fc-cache {{-f|--force}}"
            },
            {
                "description": "Erase font cache files, then generate new font cache files",
                "command": "fc-cache {{-r|--really-force}}"
            },
            {
                "description": "Scan a specific directory",
                "command": "fc-cache {{path/to/directory}}"
            },
            {
                "description": "Scan system-wide directories, skipping the user's home directory",
                "command": "fc-cache {{-s|--system-only}}"
            },
            {
                "description": "Display version",
                "command": "fc-cache {{-V|--version}}"
            }
        ]
    }
}