'\" te
.TH gtk-update-icon-cache 1 "21 Nov 2007" "SunOS 5.11" "User Commands"
.SH "NAME"
gtk-update-icon-cache \- Icon theme caching utility
.SH "SYNOPSIS"
.PP
\fBgtk-update-icon-cache\fR [-\fB-force\fR] [-\fB-help\fR] [-\fB-ignore-theme-index\fR] [-\fB-index-only\fR] [-\fB-source=\fIname\fR\fR] [-\fB-quiet\fR] [-\fB-validate\fR] [\fB\fIiconpath\fR\fR]
.SH "DESCRIPTION"
.PP
\fBgtk-update-icon-cache\fR creates cache files for icon themes that can be used
with
\fBmmap\fR(2)\&.
.PP
It expects to be given the path to an icon theme directory containing an
\fBindex\&.theme\fR file, e\&.g\&.
\fB/usr/share/icons/hicolor\fR, and writes a
\fBicon-theme\&.cache\fR containing cached information about the
icons in the directory tree below the given directory\&.
.PP
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\&.
.SH "OPTIONS"
.PP
The following options are supported:
.sp
.ne 2
.mk
\fB-\fBf\fR, -\fB-force\fR\fR
.in +32n
.rt
Overwrite an existing cache file even if it appears to be up to date\&.
.sp
.sp 1
.in -32n
.sp
.ne 2
.mk
\fB-\fB?\fR, -\fB-help\fR\fR
.in +32n
.rt
Show help options\&.
.sp
.sp 1
.in -32n
.sp
.ne 2
.mk
\fB-\fBt\fR, -\fB-ignore-theme-index\fR\fR
.in +32n
.rt
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\&.
.sp
.sp 1
.in -32n
.sp
.ne 2
.mk
\fB-\fBi\fR, -\fB-index-only\fR\fR
.in +32n
.rt
Do not include image data in the cache
.sp
.sp 1
.in -32n
.sp
.ne 2
.mk
\fB-\fBc\fR, -\fB-source\fR=\fIname\fR\fR
.in +32n
.rt
Output a C header file declaring a constant \fIname\fR
with the contents of the icon cache\&.
.sp
.sp 1
.in -32n
.sp
.ne 2
.mk
\fB-\fBq\fR, -\fB-quiet\fR\fR
.in +32n
.rt
Turn off verbose output\&.
.sp
.sp 1
.in -32n
.sp
.ne 2
.mk
\fB-\fBv\fR, -\fB-validate\fR\fR
.in +32n
.rt
Validate existing icon cache\&.
.sp
.sp 1
.in -32n
.SH "OPERANDS"
.PP
The following operands are supported:
.sp
.ne 2
.mk
\fB\fB\fIiconpath\fR\fR\fR
.in +24n
.rt
The path to an icon theme directory containing an
\fBindex\&.theme\fR file\&.
.sp
.sp 1
.in -24n
.SH "ENVIRONMENT VARIABLES"
.PP
See
\fBenviron\fR(5)
for descriptions of the following environment variables that affect the
execution of \fBgtk-update-icon-cache\fR: NLSPATH\&.
.SH "EXIT STATUS"
.PP
The following exit values are returned:
.sp
.ne 2
.mk
\fB\fB0\fR\fR
.in +9n
.rt
Application exited successfully
.sp
.sp 1
.in -9n
.sp
.ne 2
.mk
\fB\fB>0\fR\fR
.in +9n
.rt
Application exited with failure
.sp
.sp 1
.in -9n
.SH "FILES"
.PP
The following files are used by this application:
.sp
.ne 2
.mk
\fB\fB/usr/bin/gtk-update-icon-cache\fR\fR
.in +32n
.rt
The command-line executable for the application\&.
.sp
.sp 1
.in -32n
.sp
.ne 2
.mk
\fB\fB/usr/share/icons\fR\fR
.in +32n
.rt
System icon directory
.sp
.sp 1
.in -32n
.sp
.ne 2
.mk
\fB\fB/usr/share/gtk-doc/html/gtk\fR\fR
.in +32n
.rt
Location of developer documentation
.sp
.sp 1
.in -32n
.SH "ATTRIBUTES"
.PP
See
\fBattributes\fR(5)
for descriptions of the following attributes:
.sp
.TS
tab() allbox;
cw(2.750000i)| cw(2.750000i)
lw(2.750000i)| lw(2.750000i).
ATTRIBUTE TYPEATTRIBUTE VALUE
Availabilitylibrary/desktop/gtk2
Interface stabilityCommitted
.TE
.sp
.SH "SEE ALSO"
.PP
\fBgdk-pixbuf-csource\fR(1),
\fBgdk-pixbuf-query-loaders\fR(1),
\fBgettext\fR(1),
\fBglib-genmarshal\fR(1),
\fBglib-gettextize\fR(1),
\fBglib-mkenums\fR(1),
\fBgobject-query\fR(1),
\fBgtk-query-immodules-2\&.0\fR(1),
\fBmmap\fR(2)\&.
\fBlibgtk-x11-2\&.0\fR(3),
\fBattributes\fR(5),
\fBenviron\fR(5)
.PP
Latest version of the \fIGNOME Desktop User Guide\fR for your
platform\&.
.SH "NOTES"
.PP
Written by Brian Cameron, Sun Microsystems Inc\&., 2003, 2006, 2007\&.
...\" created by instant / solbook-to-man, Thu 20 Mar 2014, 02:30