iconvconfig(8)

1ICONVCONFIG(8)            Linux System Administration           ICONVCONFIG(8)
2
3
4

NAME

6       iconvconfig - create iconv module configuration cache
7

SYNOPSIS

9       iconvconfig [options] [directory]...
10

DESCRIPTION

12       The  iconv(3)  function internally uses gconv modules to convert to and
13       from a character set.  A configuration file is used  to  determine  the
14       needed modules for a conversion.  Loading and parsing such a configura‐
15       tion file would slow down programs that  use  iconv(3),  so  a  caching
16       mechanism is employed.
17
18       The  iconvconfig  program  reads  iconv  module configuration files and
19       writes a fast-loading gconv module configuration cache file.
20
21       In addition to the system provided gconv modules, the user can  specify
22       custom   gconv   module   directories  with  the  environment  variable
23       GCONV_PATH.  However, iconv module configuration caching is  used  only
24       when the environment variable GCONV_PATH is not set.
25

OPTIONS

27       --nostdlib
28              Do  not  search the system default gconv directory, only the di‐
29              rectories provided on the command line.
30
31       -o outputfile, --output=outputfile
32              Use outputfile for output instead of the  system  default  cache
33              location.
34
35       --prefix=pathname
36              Set  the  prefix  to  be prepended to the system pathnames.  See
37              FILES, below.  By default, the prefix  is  empty.   Setting  the
38              prefix to foo, the gconv module configuration would be read from
39              foo/usr/lib/gconv/gconv-modules and the cache would  be  written
40              to foo/usr/lib/gconv/gconv-modules.cache.
41
42       -?, --help
43              Print a usage summary and exit.
44
45       --usage
46              Print a short usage summary and exit.
47
48       -V, --version
49              Print  the  version  number, license, and disclaimer of warranty
50              for iconv.
51

EXIT STATUS

53       Zero on success, nonzero on errors.
54

FILES

56       /usr/lib/gconv
57              Usual default gconv module path.
58
59       /usr/lib/gconv/gconv-modules
60              Usual system default gconv module configuration file.
61
62       /usr/lib/gconv/gconv-modules.cache
63              Usual system gconv module configuration cache.
64
65       Depending on the architecture, the above files may instead  be  located
66       at directories with the path prefix /usr/lib64.
67

COLOPHON

72       This  page  is  part of release 5.13 of the Linux man-pages project.  A
73       description of the project, information about reporting bugs,  and  the
74       latest     version     of     this    page,    can    be    found    at
75       https://www.kernel.org/doc/man-pages/.
76
77
78
79GNU                               2021-08-27                    ICONVCONFIG(8)