1<html> 2<head> 3<meta name="generator" content="groff -Thtml, see www.gnu.org"> 4<meta name="Content-Style" content="text/css"> 5<title>ICONV</title> 6</head> 7<body> 8 9<h1 align=center>ICONV</h1> 10<a href="#NAME">NAME</a><br> 11<a href="#SYNOPSIS">SYNOPSIS</a><br> 12<a href="#DESCRIPTION">DESCRIPTION</a><br> 13<a href="#EXAMPLES">EXAMPLES</a><br> 14<a href="#SEE ALSO">SEE ALSO</a><br> 15 16<hr> 17<!-- Creator : groff version 1.17.2 --> 18<!-- CreationDate: Mon Jan 23 14:20:53 2006 --> 19<a name="NAME"></a> 20<h2>NAME</h2> 21<table width="100%" border=0 rules="none" frame="void" 22 cols="2" cellspacing="0" cellpadding="0"> 23<tr valign="top" align="left"> 24<td width="10%"></td><td width="90%"> 25iconv - character set conversion</td></table> 26<a name="SYNOPSIS"></a> 27<h2>SYNOPSIS</h2> 28 29<table width="100%" border=0 rules="none" frame="void" 30 cols="2" cellspacing="0" cellpadding="0"> 31<tr valign="top" align="left"> 32<td width="10%"></td><td width="90%"> 33<pre>iconv [<i>OPTION</i>...] [<b>-f</b> <i>encoding</i>] [<b>-t</b> <i>encoding</i>] [<i>inputfile</i> ...] 34iconv <b>-l 35</b></pre></td></table> 36<a name="DESCRIPTION"></a> 37<h2>DESCRIPTION</h2> 38 39<table width="100%" border=0 rules="none" frame="void" 40 cols="2" cellspacing="0" cellpadding="0"> 41<tr valign="top" align="left"> 42<td width="10%"></td><td width="90%"> 43The <b>iconv</b> program converts text from one encoding to 44another encoding. More precisely, it converts <b>from</b> 45the encoding given for the <b>-f</b> option <b>to</b> the 46encoding given for the <b>-t</b> option. Either of these 47encodings defaults to the encoding of the current locale. 48All the <i>inputfile</i>s are read and converted in turn; if 49no <i>inputfile</i> is given, the standard input is used. 50The converted text is printed to standard 51output.</td></table> 52 53<table width="100%" border=0 rules="none" frame="void" 54 cols="2" cellspacing="0" cellpadding="0"> 55<tr valign="top" align="left"> 56<td width="10%"></td><td width="90%"> 57The encodings permitted are system dependent. For the 58libiconv implementation, they are listed in the 59iconv_open(3) manual page.</td></table> 60 61<table width="100%" border=0 rules="none" frame="void" 62 cols="2" cellspacing="0" cellpadding="0"> 63<tr valign="top" align="left"> 64<td width="10%"></td><td width="90%"> 65Options controlling the input and output 66format:</td></table> 67 68<table width="100%" border=0 rules="none" frame="void" 69 cols="2" cellspacing="0" cellpadding="0"> 70<tr valign="top" align="left"> 71<td width="10%"></td><td width="90%"> 72<b>-f</b> <i>encoding</i>, 73<b>--from-code=</b><i>encoding</i></td></table> 74 75<table width="100%" border=0 rules="none" frame="void" 76 cols="2" cellspacing="0" cellpadding="0"> 77<tr valign="top" align="left"> 78<td width="21%"></td><td width="79%"> 79Specifies the encoding of the input.</td></table> 80 81<table width="100%" border=0 rules="none" frame="void" 82 cols="2" cellspacing="0" cellpadding="0"> 83<tr valign="top" align="left"> 84<td width="10%"></td><td width="90%"> 85<b>-t</b> <i>encoding</i>, 86<b>--to-code=</b><i>encoding</i></td></table> 87 88<table width="100%" border=0 rules="none" frame="void" 89 cols="2" cellspacing="0" cellpadding="0"> 90<tr valign="top" align="left"> 91<td width="21%"></td><td width="79%"> 92Specifies the encoding of the output.</td></table> 93 94<table width="100%" border=0 rules="none" frame="void" 95 cols="2" cellspacing="0" cellpadding="0"> 96<tr valign="top" align="left"> 97<td width="10%"></td><td width="90%"> 98Options controlling conversion problems:</td></table> 99 100<table width="100%" border=0 rules="none" frame="void" 101 cols="2" cellspacing="0" cellpadding="0"> 102<tr valign="top" align="left"> 103<td width="10%"></td><td width="90%"> 104<b>-c</b></td></table> 105 106<table width="100%" border=0 rules="none" frame="void" 107 cols="2" cellspacing="0" cellpadding="0"> 108<tr valign="top" align="left"> 109<td width="21%"></td><td width="79%"> 110When this option is given, characters that cannot be 111converted are silently discarded, instead of leading to a 112conversion error.</td></table> 113 114<table width="100%" border=0 rules="none" frame="void" 115 cols="2" cellspacing="0" cellpadding="0"> 116<tr valign="top" align="left"> 117<td width="10%"></td><td width="90%"> 118<b>--unicode-subst=</b><i>formatstring</i></td></table> 119 120<table width="100%" border=0 rules="none" frame="void" 121 cols="2" cellspacing="0" cellpadding="0"> 122<tr valign="top" align="left"> 123<td width="21%"></td><td width="79%"> 124When this option is given, Unicode characters that cannot be 125represented in the target encoding are replaced with a 126placeholder string that is constructed from the given 127<i>formatstring</i>, applied to the Unicode code point. The 128<i>formatstring</i> must be a format string in the same 129format as for the <i>printf</i> command or the 130<i>printf()</i> function, taking either no argument or 131exactly one unsigned integer argument.</td></table> 132 133<table width="100%" border=0 rules="none" frame="void" 134 cols="2" cellspacing="0" cellpadding="0"> 135<tr valign="top" align="left"> 136<td width="10%"></td><td width="90%"> 137<b>--byte-subst=</b><i>formatstring</i></td></table> 138 139<table width="100%" border=0 rules="none" frame="void" 140 cols="2" cellspacing="0" cellpadding="0"> 141<tr valign="top" align="left"> 142<td width="21%"></td><td width="79%"> 143When this option is given, bytes in the input that are not 144valid in the source encoding are replaced with a placeholder 145string that is constructed from the given 146<i>formatstring</i>, applied to the byte's value. The 147<i>formatstring</i> must be a format string in the same 148format as for the <i>printf</i> command or the 149<i>printf()</i> function, taking either no argument or 150exactly one unsigned integer argument.</td></table> 151 152<table width="100%" border=0 rules="none" frame="void" 153 cols="2" cellspacing="0" cellpadding="0"> 154<tr valign="top" align="left"> 155<td width="10%"></td><td width="90%"> 156<b>--widechar-subst=</b><i>formatstring</i></td></table> 157 158<table width="100%" border=0 rules="none" frame="void" 159 cols="2" cellspacing="0" cellpadding="0"> 160<tr valign="top" align="left"> 161<td width="21%"></td><td width="79%"> 162When this option is given, wide characters in the input that 163are not valid in the source encoding are replaced with a 164placeholder string that is constructed from the given 165<i>formatstring</i>, applied to the byte's value. The 166<i>formatstring</i> must be a format string in the same 167format as for the <i>printf</i> command or the 168<i>printf()</i> function, taking either no argument or 169exactly one unsigned integer argument.</td></table> 170 171<table width="100%" border=0 rules="none" frame="void" 172 cols="2" cellspacing="0" cellpadding="0"> 173<tr valign="top" align="left"> 174<td width="10%"></td><td width="90%"> 175Options controlling error output:</td></table> 176 177<table width="100%" border=0 rules="none" frame="void" 178 cols="2" cellspacing="0" cellpadding="0"> 179<tr valign="top" align="left"> 180<td width="10%"></td><td width="90%"> 181<b>-s</b>, <b>--silent</b></td></table> 182 183<table width="100%" border=0 rules="none" frame="void" 184 cols="2" cellspacing="0" cellpadding="0"> 185<tr valign="top" align="left"> 186<td width="21%"></td><td width="79%"> 187When this option is given, error messages about invalid or 188unconvertible characters are omitted, but the actual 189converted text is unaffected.</td></table> 190 191<table width="100%" border=0 rules="none" frame="void" 192 cols="2" cellspacing="0" cellpadding="0"> 193<tr valign="top" align="left"> 194<td width="10%"></td><td width="90%"> 195The <b>iconv -l</b> or <b>iconv --list</b> command lists the 196names of the supported encodings, in a system dependent 197format. For the libiconv implementation, the names are 198printed in upper case, separated by whitespace, and alias 199names of an encoding are listed on the same line as the 200encoding itself.</td></table> 201<a name="EXAMPLES"></a> 202<h2>EXAMPLES</h2> 203 204<table width="100%" border=0 rules="none" frame="void" 205 cols="2" cellspacing="0" cellpadding="0"> 206<tr valign="top" align="left"> 207<td width="10%"></td><td width="90%"> 208<b>iconv -f ISO-8859-1 -t UTF-8</b></td></table> 209 210<table width="100%" border=0 rules="none" frame="void" 211 cols="2" cellspacing="0" cellpadding="0"> 212<tr valign="top" align="left"> 213<td width="21%"></td><td width="79%"> 214converts input from the old West-European encoding 215ISO-8859-1 to Unicode.</td></table> 216 217<table width="100%" border=0 rules="none" frame="void" 218 cols="2" cellspacing="0" cellpadding="0"> 219<tr valign="top" align="left"> 220<td width="10%"></td><td width="90%"> 221<pre><b>iconv -f KOI8-R --byte-subst="<0x%x>" 222 --unicode-subst="<U+%04X>" 223</b></pre></td></table> 224 225<table width="100%" border=0 rules="none" frame="void" 226 cols="2" cellspacing="0" cellpadding="0"> 227<tr valign="top" align="left"> 228<td width="21%"></td><td width="79%"> 229converts input from the old Russian encoding KOI8-R to the 230locale encoding, substituting an angle bracket notation with 231hexadecimal numbers for invalid bytes and for valid but 232unconvertible characters.</td></table> 233 234<table width="100%" border=0 rules="none" frame="void" 235 cols="2" cellspacing="0" cellpadding="0"> 236<tr valign="top" align="left"> 237<td width="10%"></td><td width="90%"> 238<b>iconv --list</b></td></table> 239 240<table width="100%" border=0 rules="none" frame="void" 241 cols="2" cellspacing="0" cellpadding="0"> 242<tr valign="top" align="left"> 243<td width="21%"></td><td width="79%"> 244lists the supported encodings.</td></table> 245<a name="SEE ALSO"></a> 246<h2>SEE ALSO</h2> 247 248<table width="100%" border=0 rules="none" frame="void" 249 cols="2" cellspacing="0" cellpadding="0"> 250<tr valign="top" align="left"> 251<td width="10%"></td><td width="90%"> 252<b>iconv_open</b>(3), <b>locale</b>(7)</td></table> 253<hr> 254</body> 255</html> 256