gtk-update-icon-cache(1) User Commands gtk-update-icon-cache(1)NAMEgtk-update-icon-cache - Icon theme caching utility
SYNOPSISgtk-update-icon-cache [--force] [--help] [--ignore-theme-index]
[--index-only] [--source=name] [--quiet] [--validate] [iconpath]
DESCRIPTIONgtk-update-icon-cache creates cache files for icon themes that can be
used with mmap(2).
It expects to be given the path to an icon theme directory containing
an index.theme file, e.g. /usr/share/icons/hicolor, and writes a icon-
theme.cache containing cached information about the icons in the direc‐
tory tree below the given directory.
GTK+ can use the cache files created by gtk-update-icon-cache to avoid
a lot of system call and disk seek overhead when the application
starts. Since the format of the cache files allows them to be mmap()ed
shared between multiple applications, the overall memory consumption is
reduced as well.
OPTIONS
The following options are supported:
-f, --force Overwrite an existing cache file even
if it appears to be up to date.
-?, --help Show help options.
-t, --ignore-theme-index Do not check for the existence of
'index.theme' in the icon theme direc‐
tory. Without this option, gtk-update-
icon-cache refuses to create an icon
cache in a directory which does not
appear to be the toplevel directory of
an icon theme.
-i, --index-only Do not include image data in the cache
-c, --source=name Output a C header file declaring a con‐
stant name with the contents of the
icon cache.
-q, --quiet Turn off verbose output.
-v, --validate Validate existing icon cache.
OPERANDS
The following operands are supported:
iconpath The path to an icon theme directory containing
an index.theme file.
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables
that affect the execution of gtk-update-icon-cache: NLSPATH.
EXIT STATUS
The following exit values are returned:
0 Application exited successfully
>0 Application exited with failure
FILES
The following files are used by this application:
/usr/bin/gtk-update-icon-cache The command-line executable for the
application.
/usr/share/icons System icon directory
/usr/share/gtk-doc/html/gtk Location of developer documentation
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │library/desktop/gtk2 │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Committed │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOgdk-pixbuf-csource(1), gdk-pixbuf-query-loaders(1), gettext(1), glib-
genmarshal(1), glib-gettextize(1), glib-mkenums(1), gobject-query(1),
gtk-query-immodules-2.0(1), mmap(2). libgtk-x11-2.0(3), attributes(5),
environ(5)
Latest version of the GNOME Desktop User Guide for your platform.
NOTES
Written by Brian Cameron, Sun Microsystems Inc., 2003, 2006, 2007.
SunOS 5.11 21 Nov 2007 gtk-update-icon-cache(1)
