1 '\" t -*- coding: UTF-8 -*-
3 .\" Copyright (C) 2014 Marko Myllynen <myllynen@redhat.com>
5 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
6 .\" This is free documentation; you can redistribute it and/or
7 .\" modify it under the terms of the GNU General Public License as
8 .\" published by the Free Software Foundation; either version 2 of
9 .\" the License, or (at your option) any later version.
11 .\" The GNU General Public License's references to "object code"
12 .\" and "executables" are to be interpreted as the output of any
13 .\" document formatting or typesetting system, including
14 .\" intermediate and printed output.
16 .\" This manual is distributed in the hope that it will be useful,
17 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
18 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 .\" GNU General Public License for more details.
21 .\" You should have received a copy of the GNU General Public
22 .\" License along with this manual; if not, see
23 .\" <http://www.gnu.org/licenses/>.
26 .TH ICONVCONFIG 8 2014-06-09 "GNU" "Linux System Administration"
28 iconvconfig \- create iconv module configuration cache
36 function internally uses
38 modules to convert to and from a character set.
39 A configuration file is used to determine the needed modules
41 Loading and parsing such a configuration file would slow down
44 so a caching mechanism is employed.
48 program reads iconv module configuration files and writes
49 a fast-loading gconv module configuration cache file.
50 In addition to the system provided gconv modules, the user can specify
51 custom gconv module directories with the environment variable
53 However, iconv module configuration caching is only used when
54 the environment variable
60 Do not search the system default gconv directory,
61 only the directories provided on the command line.
63 .BI \-o " outputfile" ", \-\-output=" outputfile
66 for output instead of the system default cache location.
68 .BI \-\-prefix= pathname
69 Set the prefix to be prepended to the system pathnames.
71 By default, the prefix is empty.
74 the gconv module configuration would be read from
75 .IR foo/usr/lib/gconv/gconv-modules
76 and the cache would be written to
77 .IR foo/usr/lib/gconv/gconv-modules.cache .
80 Print a usage summary and exit.
83 Print a short usage summary and exit.
86 Print the version number, license, and disclaimer of warranty for
89 Zero on success, non-zero on errors.
93 Usual default gconv module path.
95 .I /usr/lib/gconv/gconv-modules
96 Usual system default gconv module configuration file.
98 .I /usr/lib/gconv/gconv-modules.cache
99 Usual system gconv module configuration cache.