MAN Solaris - gtk-update-icon-cache (1)

advertisement


NAME

gtk-update-icon-cache - Icon theme caching utility

CONTENTS

SYNOPSIS

gtk-update-icon-cache [--force] [--ignore-theme-index] [--index-only] [--source=name] [--quiet] [--validate] [iconpath]

advertisements

advertisements


DESCRIPTION

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.

OPTIONS

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.

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 TYPEATTRIBUTE VALUE
AvailabilitySUNWgnome-base-libs
Interface stabilityCommitted

SEE ALSO

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.

NOTES

Written by Brian Cameron, Sun Microsystems Inc., 2006.

Jump to page    or go to Top of page |  Section 1 |  Main Solaris Index.


SunOS 5.11 gtk-update-icon-cache (1) 2 Oct 2003
Generated by Open Solaris Forum from /usr/share/man/man1/gtk-update-icon-cache.1 using man macros with tbl support.