# man > iconvconfig(8)

[_iconvconfig_(8)](https://www.chedong.com/phpMan.php/man/iconvconfig/8/markdown)                         System Manager's Manual                        [_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.

       **--output=_**outputfile_
### -o _
              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.

### --version
### -V     

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

       Depending on the architecture, the above files may instead be located at directories with the
       path prefix _/usr/lib64_.

## 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)

Linux man-pages 6.7                          2023-10-31                               [_iconvconfig_(8)](https://www.chedong.com/phpMan.php/man/iconvconfig/8/markdown)