ICONVCONFIG(8)            (2020-08-13)             ICONVCONFIG(8)

     NAME
          iconvconfig - create iconv module configuration cache

     SYNOPSIS
          iconvconfig [options] [directory]...

     DESCRIPTION
          The iconv(3) function internally uses gconv modules to con-
          vert to and from a character set.  A configuration file is
          used to determine the needed modules for a conversion.
          Loading and parsing such a configuration 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 envi-
          ronment variable GCONV_PATH.  However, iconv module configu-
          ration 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 directories 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 configura-
               tion 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.

     Page 1                         GNU              (printed 5/23/22)

     ICONVCONFIG(8)            (2020-08-13)             ICONVCONFIG(8)

     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.10 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/.

     Page 2                         GNU              (printed 5/23/22)