iconvconfig

iconvconfig [options] directory...

-l
    List all available character sets and aliases.

-o output_file
    Specify the output file name for the cache. Defaults to /usr/lib/gconv/gconv-modules.cache.

-c
    Create a shared object instead of a cache file.
Requires corresponding support in the iconv library

--verbose
    Enable verbose output.

--version
    Display version information and exit.

--help
    Display help message and exit.

The iconvconfig command creates a conversion configuration cache for iconv(1) from a set of conversion description files. This cache dramatically speeds up subsequent calls to iconv. When iconv is called, it first searches for a pre-built configuration cache file (usually /usr/lib/gconv/gconv-modules.cache). If it finds one, it uses this cache to load the necessary conversion modules. If not, or if the cache is out-of-date, iconv dynamically loads the conversion description files which can be a slow process. iconvconfig scans conversion description files (.alias and .so files), specified via directory paths as command line arguments, to build the cache. The primary goal of iconvconfig is to improve the performance of iconv, especially when dealing with a large number of character encodings. Note that if character encoding definitions are added or changed, iconvconfig must be rerun to rebuild the cache file.

Incorrectly configured or outdated cache files can lead to iconv failing to convert character encodings correctly. Always re-run iconvconfig after modifying any conversion definition files.

The iconvconfig command exits with a status of 0 if successful, and a non-zero value if an error occurs.

iconv(1)