1GTK4-UPDATE-ICON-(1)             User Commands            GTK4-UPDATE-ICON-(1)
2
3
4

NAME

6       gtk4-update-icon-cache - Icon theme caching utility
7

SYNOPSIS

9       gtk4-update-icon-cache [--force] [--ignore-theme-index] [--index-only |
10                              --include-image-data] [--source NAME] [--quiet]
11                              [--validate] PATH
12

DESCRIPTION

14       gtk4-update-icon-cache creates mmapable cache files for icon themes.
15
16       It expects to be given the PATH to an icon theme directory containing
17       an index.theme, e.g.  /usr/share/icons/hicolor, and writes a
18       icon-theme.cache containing cached information about the icons in the
19       directory tree below the given directory.
20
21       GTK can use the cache files created by gtk4-update-icon-cache to avoid
22       a lot of system call and disk seek overhead when the application
23       starts. Since the format of the cache files allows them to be shared
24       across multiple processes, for instance using the POSIX mmap() system
25       call, the overall memory consumption is reduced as well.
26

OPTIONS

28       --force, -f
29           Overwrite an existing cache file even if it appears to be
30           up-to-date.
31
32       --ignore-theme-index, -t
33           Don't check for the existence of index.theme in the icon theme
34           directory. Without this option, gtk4-update-icon-cache refuses to
35           create an icon cache in a directory which does not appear to be the
36           toplevel directory of an icon theme.
37
38       --index-only, -i
39           Don't include image data in the cache.
40
41       --include-image-data
42           Include image data in the cache.
43
44       --source, -c
45           Output a C header file declaring a constant NAME with the contents
46           of the icon cache.
47
48       --quiet, -q
49           Turn off verbose output.
50
51       --validate, -v
52           Validate existing icon cache.
53
54
55
56GTK                                                       GTK4-UPDATE-ICON-(1)
Impressum