'\" te .\" Copyright (c) 1997, Sun Microsystems, Inc. All Rights Reserved. .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] .TH ICONV_UNICODE 5 "Apr 18, 1997" .SH NAME iconv_unicode \- code set conversion tables for Unicode .SH DESCRIPTION .sp .LP The following code set conversions are supported: .sp .in +2 .nf CODE SET CONVERSIONS SUPPORTED ------------------------------ FROM Code Set TO Code Set Code FROM Target Code TO Filename Filename Element Element ISO 8859-1 (Latin 1) 8859-1 UTF-8 UTF-8 ISO 8859-2 (Latin 2) 8859-2 UTF-8 UTF-8 ISO 8859-3 (Latin 3) 8859-3 UTF-8 UTF-8 ISO 8859-4 (Latin 4) 8859-4 UTF-8 UTF-8 ISO 8859-5 (Cyrillic) 8859-5 UTF-8 UTF-8 ISO 8859-6 (Arabic) 8859-6 UTF-8 UTF-8 ISO 8859-7 (Greek) 8859-7 UTF-8 UTF-8 ISO 8859-8 (Hebrew) 8859-8 UTF-8 UTF-8 ISO 8859-9 (Latin 5) 8859-9 UTF-8 UTF-8 ISO 8859-10 (Latin 6) 8859-10 UTF-8 UTF-8 Japanese EUC eucJP UTF-8 UTF-8 Chinese/PRC EUC (GB 2312-1980) gb2312 UTF-8 UTF-8 ISO-2022 iso2022 UTF-8 UTF-8 Korean EUC ko_KR-euc Korean UTF-8 ko_KR-UTF-8 ISO-2022-KR ko_KR-iso2022-7 Korean UTF-8 ko_KR_UTF-8 Korean Johap (KS C 5601-1987) ko_KR-johap Korean UTF-8 ko_KR-UTF-8 Korean Johap (KS C 5601-1992) ko_KR-johap92 Korean UTF-8 ko_KR-UTF-8 Korean UTF-8 ko_KR-UTF-8 Korean EUC ko_KR-euc Korean UTF-8 ko_KR-UTF-8 Korean Johap ko_KR-johap (KS C 5601-1987) Korean UTF-8 ko_KR-UTF-8 Korean Johap ko_KR-johap92 (KS C 5601-1992) KOI8-R (Cyrillic) KOI8-R UCS-2 UCS-2 KOI8-R (Cyrillic) KOI8-R UTF-8 UTF-8 PC Kanji (SJIS) PCK UTF-8 UTF-8 PC Kanji (SJIS) SJIS UTF-8 UTF-8 UCS-2 UCS-2 KOI8-R (Cyrillic) KOI8-R UCS-2 UCS-2 UCS-4 UCS-4 .fi .in -2 .sp .sp .in +2 .nf CODE SET CONVERSIONS SUPPORTED ------------------------------ FROM Code Set TO Code Set Code FROM Target Code TO Filename Filename Element Element UCS-2 UCS-2 UTF-7 UTF-7 UCS-2 UCS-2 UTF-8 UTF-8 UCS-4 UCS-4 UCS-2 UCS-2 UCS-4 UCS-4 UTF-16 UTF-16 UCS-4 UCS-4 UTF-7 UTF-7 UCS-4 UCS-4 UTF-8 UTF-8 UTF-16 UTF-16 UCS-4 UCS-4 UTF-16 UTF-16 UTF-8 UTF-8 UTF-7 UTF-7 UCS-2 UCS-2 UTF-7 UTF-7 UCS-4 UCS-4 UTF-7 UTF-7 UTF-8 UTF-8 UTF-8 UTF-8 ISO 8859-1 (Latin 1) 8859-1 UTF-8 UTF-8 ISO 8859-2 (Latin 2) 8859-2 UTF-8 UTF-8 ISO 8859-3 (Latin 3) 8859-3 UTF-8 UTF-8 ISO 8859-4 (Latin 4) 8859-4 UTF-8 UTF-8 ISO 8859-5 (Cyrillic) 8859-5 UTF-8 UTF-8 ISO 8859-6 (Arabic) 8859-6 UTF-8 UTF-8 ISO 8859-7 (Greek) 8859-7 UTF-8 UTF-8 ISO 8859-8 (Hebrew) 8859-8 UTF-8 UTF-8 ISO 8859-9 (Latin 5) 8859-9 UTF-8 UTF-8 ISO 8859-10 (Latin 6) 8859-10 UTF-8 UTF-8 Japanese EUC eucJP UTF-8 UTF-8 Chinese/PRC EUC gb2312 (GB 2312-1980) UTF-8 UTF-8 ISO-2022 iso2022 UTF-8 UTF-8 KOI8-R (Cyrillic) KOI8-R UTF-8 UTF-8 PC Kanji (SJIS) PCK UTF-8 UTF-8 PC Kanji (SJIS) SJIS UTF-8 UTF-8 UCS-2 UCS-2 UTF-8 UTF-8 UCS-4 UCS-4 UTF-8 UTF-8 UTF-16 UTF-16 UTF-8 UTF-8 UTF-7 UTF-7 UTF-8 UTF-8 Chinese/PRC EUC zh_CN.euc (GB 2312-1980) .fi .in -2 .sp .sp .in +2 .nf CODE SET CONVERSIONS SUPPORTED ------------------------------ FROM Code Set TO Code Set Code FROM Target Code TO Filename Filename Element Element UTF-8 UTF-8 ISO 2022-CN zh_CN.iso2022-7 UTF-8 UTF-8 Chinese/Taiwan Big5 zh_TW-big5 UTF-8 UTF-8 Chinese/Taiwan EUC zh_TW-euc (CNS 11643-1992) UTF-8 UTF-8 ISO 2022-TW zh_TW-iso2022-7 Chinese/PRC EUC zh_CN.euc UTF-8 UTF-8 (GB 2312-1980) ISO 2022-CN zh_CN.iso2022-7 UTF-8 UTF-8 Chinese/Taiwan Big5 zh_TW-big5 UTF-8 UTF-8 Chinese/Taiwan EUC zh_TW-euc UTF-8 UTF-8 (CNS 11643-1992) ISO 2022-TW zh_TW-iso2022-7 UTF-8 UTF-8 .fi .in -2 .sp .SH EXAMPLES .LP \fBExample 1 \fRThe library module filename .sp .LP In the conversion library, \fB/usr/lib/iconv\fR (see \fBiconv\fR(3C)), the library module filename is composed of two symbolic elements separated by the percent sign (\fB%\fR). The first symbol specifies the code set that is being converted; the second symbol specifies the \fItarget code\fR, that is, the code set to which the first one is being converted. .sp .LP In the conversion table above, the first symbol is termed the "FROM Filename Element". The second symbol, representing the target code set, is the "TO Filename Element". .sp .LP For example, the library module filename to convert from the \fIKorean\fR \fIEUC\fR code set to the \fIKorean\fR \fIUTF-8\fR code set is .sp .LP \fBko_KR-euc%ko_KR-UTF-8\fR .SH FILES .sp .ne 2 .na \fB\fB/usr/lib/iconv/*.so\fR\fR .ad .RS 23n conversion modules .RE .SH SEE ALSO .sp .LP \fBiconv\fR(1), \fBiconv\fR(3C), \fBiconv\fR(5) .sp .LP Chernov, A., \fIRegistration of a Cyrillic Character Set\fR, RFC 1489, RELCOM Development Team, July 1993. .sp .LP Chon, K., H. Je Park, and U. Choi, \fIKorean Character Encoding for Internet Messages\fR, RFC 1557, Solvit Chosun Media, December 1993. .sp .LP Goldsmith, D., and M. Davis, \fIUTF-7 - A Mail-Safe Transformation Format of Unicode\fR, RFC 1642, Taligent, Inc., July 1994. .sp .LP Lee, F., \fIHZ - A Data Format for Exchanging Files of\fR \fIArbitrarily Mixed Chinese and ASCII characters\fR, RFC 1843, Stanford University, August 1995. .sp .LP Murai, J., M. Crispin, and E. van der Poel, \fIJapanese Character Encoding for Internet Messages\fR, RFC 1468, Keio University, Panda Programming, June 1993. .sp .LP Nussbacher, H., and Y. Bourvine, \fIHebrew Character Encoding for Internet Messages\fR, RFC 1555, Israeli Inter-University, Hebrew University, December 1993. .sp .LP Ohta, M., \fICharacter Sets ISO-10646 and ISO-10646-J-1\fR, RFC 1815, Tokyo Institute of Technology, July 1995. .sp .LP Ohta, M., and K. Handa, \fIISO-2022-JP-2: Multilingual Extension of ISO-2022-JP\fR, RFC 1554, Tokyo Institute of Technology, December 1993. .sp .LP Reynolds, J., and J. Postel, \fIASSIGNED NUMBERS\fR, RFC 1700, University of Southern California/Information Sciences Institute, October 1994. .sp .LP Simonson, K., \fICharacter Mnemonics & Character Sets\fR, RFC 1345, Rationel Almen Planlaegning, June 1992. .sp .LP Spinellis, D., \fIGreek Character Encoding for Electronic Mail Messages\fR, RFC 1947, SENA S.A., May 1996. .sp .LP The Unicode Consortium, \fIThe Unicode Standard\fR, Version 2.0, Addison Wesley Developers Press, July 1996. .sp .LP Wei, Y., Y. Zhang, J. Li, J. Ding, and Y. Jiang, \fIASCII Printable Characters-Based Chinese Character Encoding\fR \fIfor Internet Messages\fR, RFC 1842, AsiaInfo Services Inc., Harvard University, Rice University, University of Maryland, August 1995. .sp .LP Yergeau, F., \fIUTF-8, a transformation format of Unicode and ISO 10646\fR, RFC 2044, Alis Technologies, October 1996. .sp .LP Zhu, H., D. Hu, Z. Wang, T. Kao, W. Chang, and M. Crispin, \fIChinese Character Encoding for Internet Messages\fR, RFC 1922, Tsinghua University, China Information Technology Standardization Technical Committee (CITS), Institute for Information Industry (III), University of Washington, March 1996. .SH NOTES .sp .LP ISO 8859 character sets using Latin alphabetic characters are distinguished as follows: .sp .ne 2 .na \fB\fBISO\fR \fB8859-1\fR \fB(Latin\fR \fB1)\fR\fR .ad .RS 25n For most West European languages, including: .sp .sp .TS l l l l l l . Albanian Finnish Italian Catalan French Norwegian Danish German Portuguese Dutch Galician Spanish English Irish Swedish Faeroese Icelandic .TE .RE .sp .ne 2 .na \fB\fBISO\fR \fB8859-2\fR \fB(Latin\fR \fB2)\fR\fR .ad .RS 25n For most Latin-written Slavic and Central European languages: .sp .sp .TS l l l l l l . Czech Polish Slovak German Rumanian Slovene Hungarian Croatian .TE .RE .sp .ne 2 .na \fB\fBISO\fR \fB8859-3\fR \fB(Latin\fR \fB3)\fR\fR .ad .RS 25n Popularly used for Esperanto, Galician, Maltese, and Turkish. .RE .sp .ne 2 .na \fB\fBISO\fR \fB8859-4\fR \fB(Latin\fR \fB4)\fR\fR .ad .RS 25n Introduces letters for Estonian, Latvian, and Lithuanian. It is an incomplete predecessor of ISO 8859-10 (Latin 6). .RE .sp .ne 2 .na \fB\fBISO\fR \fB8859-9\fR \fB(Latin\fR \fB5)\fR\fR .ad .RS 25n Replaces the rarely needed Icelandic letters in ISO 8859-1 (Latin 1) with the Turkish ones. .RE .sp .ne 2 .na \fB\fBISO\fR \fB8859-10\fR \fB(Latin\fR \fB6)\fR\fR .ad .RS 25n Adds the last Inuit (Greenlandic) and Sami (Lappish) letters that were not included in ISO 8859-4 (Latin 4) to complete coverage of the Nordic area. .RE