alias - alias table file of codeset names
The allowed alias definitions are one of the following:
"%s %s\n", <codeset name alias>, <canonical codeset name> "*%s %s %s\n", <normalized codeset name alias>, <codeset name alias>, <canonical codeset name> "%s %s, %d\n", <codeset name alias>, <canonical codeset name>, <variant level> "*%s %s %s, %d\n", <normalized codeset name alias>, <codeset name alias>, <canonical codeset name>, <variant level>
which means that the codeset name alias maps to the canonical codeset name. The variant level which is a positive integer indicates which variant of the canonical codeset should be used in the code conversion. For the descriptions and supported variant levels, refer to iconv_unicode (7) and other section 5 iconv man pages.
During the mapping process, the string specified for the codeset name alias is normalized by extracting only alphanumeric and '+' (i.e., 0x2b) characters as significant characters and then applying to lower case conversions to the extracted characters for a better success ratio of possible mappings.
When a normalized codeset name alias is supplied, it is used without any further normalization yielding better performance in the mapping process.
Any ill-formed lines are simply ignored.
A line beginning with '#' is treated as a comment.
The following shows four different alias definitions possible:
# Various definitions are possible: ISO-8859-1 ISO8859-1 *iso88592 ISO-8859-2 ISO8859-2 ISO-8859-15 ISO8859-1,1 *koi8u KOI8U KOI8-R,1
The first one simply maps ISO-8859-1 and any possible variations of it, e.g., iso-8859-1, iso8859-1, ISO8859:1, and so on, to ISO8859-1. The second one does similar thing for ISO8859-2 but since a normalized alias name is supplied, the mapping will be done quicker. The third one will map any variations of ISO-8859-15 into ISO8859-1 with variant level value of 1. The fourth one does similar thing for KOI8-U but since a normalized alias name is supplied, the mapping will be done quicker.
See attributes (7) for descriptions of the following attributes:
iconv(1), cconv (3C) , cconv_close (3C) , cconv_open (3C) , cconvctl (3C) , iconv(3C), iconv_close(3C), iconv_open(3C), iconvctl(3C), attributes (7) , iconv_extra (7) , iconv_ja (7) , iconv_ko (7) , iconv_unicode (7) , iconv_zh (7) , iconv_zh_HK (7) , iconv_zh_TW (7)
For the supported canonical and alias names in the current system, refer to "iconv -l" output.