iconvconfig
Create iconv module configuration cache
SYNOPSIS
iconvconfig [options] directory...
PARAMETERS
-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.
DESCRIPTION
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.
CAVEATS
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.
EXIT STATUS
The iconvconfig command exits with a status of 0 if successful, and a non-zero value if an error occurs.
SEE ALSO
iconv(1)