iconvconfig

ICONVCONFIG(8)            Linux System Administration           ICONVCONFIG(8)

NAME
       iconvconfig - create iconv module configuration cache

SYNOPSIS
       iconvconfig [options] [directory]...

DESCRIPTION
       The  iconv(3)  function internally uses gconv modules to convert to and
       from a character set.  A configuration file is used  to  determine  the
       needed modules for a conversion.  Loading and parsing such a configura-
       tion file would slow down programs that  use  iconv(3),  so  a  caching
       mechanism is employed.

       The  iconvconfig  program  reads  iconv  module configuration files and
       writes a fast-loading gconv module configuration cache file.

       In addition to the system provided gconv modules, the user can  specify
       custom   gconv   module   directories  with  the  environment  variable
       GCONV_PATH.  However, iconv module configuration caching is  used  only
       when the environment variable GCONV_PATH is not set.

OPTIONS
       --nostdlib
              Do  not  search the system default gconv directory, only the di-
              rectories provided on the command line.

       -o outputfile, --output=outputfile
              Use outputfile for output instead of the  system  default  cache
              location.

       --prefix=pathname
              Set  the  prefix  to  be prepended to the system pathnames.  See
              FILES, below.  By default, the prefix  is  empty.   Setting  the
              prefix to foo, the gconv module configuration would be read from
              foo/usr/lib/gconv/gconv-modules and the cache would  be  written
              to foo/usr/lib/gconv/gconv-modules.cache.

       -?, --help
              Print a usage summary and exit.

       --usage
              Print a short usage summary and exit.

       -V, --version
              Print  the  version  number, license, and disclaimer of warranty
              for iconv.

EXIT STATUS
       Zero on success, nonzero on errors.

FILES
       /usr/lib/gconv
              Usual default gconv module path.

       /usr/lib/gconv/gconv-modules
              Usual system default gconv module configuration file.

       /usr/lib/gconv/gconv-modules.cache
              Usual system gconv module configuration cache.

SEE ALSO
       iconv(1), iconv(3)

COLOPHON
       This page is part of release 5.05 of the Linux  man-pages  project.   A
       description  of  the project, information about reporting bugs, and the
       latest    version    of    this    page,    can     be     found     at
       https://www.kernel.org/doc/man-pages/.

GNU                               2018-02-02                    ICONVCONFIG(8)