1GTK4-UPDATE-ICON-CACHE()                              GTK4-UPDATE-ICON-CACHE()
2
3
4

NAME

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

SYNOPSIS

9       gtk4-update-icon-cache [OPTIONS...] <PATH>
10
11

DESCRIPTION

13       gtk4-update-icon-cache   creates  mmap(2)-able  cache  files  for  icon
14       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(2)  system
25       call, the overall memory consumption is reduced as well.
26

OPTIONS

28       -f, --force
29          Overwrite   an  existing  cache  file  even  if  it  appears  to  be
30          up-to-date.
31
32       -t, --ignore-theme-index
33          Don't check for the existence of index.theme in the icon  theme  di‐
34          rectory.   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       -i, --index-only
39          Don't include image data in the cache.
40
41       --include-image-data
42          Include image data in the cache.
43
44       -c, --source <NAME>
45          Output  a  C header file declaring a constant NAME with the contents
46          of the icon cache.
47
48       -q, --quiet
49          Turn off verbose output.
50
51       -v, --validate
52          Validate existing icon cache.
53
54
55
56
57                                                      GTK4-UPDATE-ICON-CACHE()