User Commands                            gtk-update-icon-cache(1)



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

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

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 con-
     taining  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.



     -?, --help                      Show help options.



     -t, --ignore-theme-index        Do   not   check   for   the
                                     existence  of  'index.theme'
                                     in the icon theme directory.
                                     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



SunOS 5.11          Last change: 21 Nov 2007                    1






User Commands                            gtk-update-icon-cache(1)



     -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






SunOS 5.11          Last change: 21 Nov 2007                    2






User Commands                            gtk-update-icon-cache(1)



     /usr/share/gtk-doc/html/gtk     Location of developer  docu-
                                     mentation



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWgnome-base-libs         
    
     Interface stability          Committed                   
    


SEE ALSO
     gdk-pixbuf-csource(1),   gdk-pixbuf-query-loaders(1),   get-
     text(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          Last change: 21 Nov 2007                    3