# iconvconfig(8) - man - phpMan

[ICONVCONFIG(8)](https://www.chedong.com/phpMan.php/man/ICONVCONFIG/8/markdown)                       Linux System Administration                      [ICONVCONFIG(8)](https://www.chedong.com/phpMan.php/man/ICONVCONFIG/8/markdown)



## NAME
       iconvconfig - create iconv module configuration cache

## SYNOPSIS
       **iconvconfig** [_options_] [_directory_]...

## DESCRIPTION
       The  [**iconv**(3)](https://www.chedong.com/phpMan.php/man/iconv/3/markdown)  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  configuration file would slow down programs that use [**iconv**(3)](https://www.chedong.com/phpMan.php/man/iconv/3/markdown), 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 directories provided on the
              command line.

### -o --output=
              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  de‐
              fault, 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)](https://www.chedong.com/phpMan.php/man/iconv/1/markdown), [**iconv**(3)](https://www.chedong.com/phpMan.php/man/iconv/3/markdown)

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



GNU                                          2020-08-13                               [ICONVCONFIG(8)](https://www.chedong.com/phpMan.php/man/ICONVCONFIG/8/markdown)