gtk-update-icon-cache - Icon theme caching utility
gtk-update-icon-cache [--force] [--ignore-theme-index] [--index-only] [--source=name] [--quiet] [--validate] [iconpath]
gtk-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 directory 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.
The following options are supported:
-f, --force Overwrite an existing cache file even if it appears to be up to date.
-t, --ignore-theme-index Do not check for the existence of ’index.theme’ in the icon theme directory. ithout 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 constant name with the contents of the icon cache.
-q, --quiet Turn off verbose output.
-v, --validate Validate existing icon cache.
The following operands are supported:
iconpath The path to an icon theme directory containing an index.theme file.
See environ(5) for descriptions of the following environment variables that affect the execution of gtk-update-icon-cache: NLSPATH.
The following exit values are returned:
0 Application exited successfully
>0 Application exited with failure
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
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE ATTRIBUTE VALUE Availability SUNWgnome-base-libs Interface stability Committed
gdk-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). libglib-2.0(3)
Latest version of the GNOME Desktop User Guide for your platform.
Written by Brian Cameron, Sun Microsystems Inc., 2006.
| SunOS 5.11 | gtk-update-icon-cache (1) | 2 Oct 2003 |