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="#SEE ALSO">SEE ALSO</a><br> 14 15<hr> 16<!-- Creator : groff version 1.17 --> 17<!-- CreationDate: Fri May 24 14:48:03 2002 --> 18<a name="NAME"></a> 19<h2>NAME</h2> 20<table width="100%" border=0 rules="none" frame="void" 21 cols="2" cellspacing="0" cellpadding="0"> 22<tr valign="top" align="left"> 23<td width="10%"></td><td width="90%"> 24iconv - character set conversion</td></table> 25<a name="SYNOPSIS"></a> 26<h2>SYNOPSIS</h2> 27 28<table width="100%" border=0 rules="none" frame="void" 29 cols="2" cellspacing="0" cellpadding="0"> 30<tr valign="top" align="left"> 31<td width="10%"></td><td width="90%"> 32<pre>iconv [<b>-c</b>] [<b>-s</b>] [<b>-f</b> <i>encoding</i>] [<b>-t</b> <i>encoding</i>] [<i>inputfile</i> ...] 33iconv <b>-l 34</b></pre></td></table> 35<a name="DESCRIPTION"></a> 36<h2>DESCRIPTION</h2> 37 38<table width="100%" border=0 rules="none" frame="void" 39 cols="2" cellspacing="0" cellpadding="0"> 40<tr valign="top" align="left"> 41<td width="10%"></td><td width="90%"> 42The <b>iconv</b> program converts text from one encoding to 43another encoding. More precisely, it converts <b>from</b> 44the encoding given for the <b>-f</b> option <b>to</b> the 45encoding given for the <b>-t</b> option. Either of these 46encodings defaults to the encoding of the current locale. 47All the <i>inputfile</i>s are read and converted in turn; if 48no <i>inputfile</i> is given, the standard input is used. 49The converted text is printed to standard 50output.</td></table> 51 52<table width="100%" border=0 rules="none" frame="void" 53 cols="2" cellspacing="0" cellpadding="0"> 54<tr valign="top" align="left"> 55<td width="10%"></td><td width="90%"> 56When option <b>-c</b> is given, characters that cannot be 57converted are silently discarded, instead of leading to a 58conversion error.</td></table> 59 60<table width="100%" border=0 rules="none" frame="void" 61 cols="2" cellspacing="0" cellpadding="0"> 62<tr valign="top" align="left"> 63<td width="10%"></td><td width="90%"> 64When option <b>-s</b> is given, error messages about invalid 65or unconvertible characters are omitted, but the actual 66converted text is unaffected.</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%"> 72The encodings permitted are system dependent. For the 73libiconv implementation, they are listed in the 74iconv_open(3) manual page.</td></table> 75 76<table width="100%" border=0 rules="none" frame="void" 77 cols="2" cellspacing="0" cellpadding="0"> 78<tr valign="top" align="left"> 79<td width="10%"></td><td width="90%"> 80The <b>iconv -l</b> command lists the names of the supported 81encodings, in a system dependent format. For the libiconv 82implementation, the names are printed in upper case, 83separated by whitespace, and alias names of an encoding are 84listed on the same line as the encoding itself.</td></table> 85<a name="SEE ALSO"></a> 86<h2>SEE ALSO</h2> 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="10%"></td><td width="90%"> 92<b>iconv_open</b>(3), <b>locale</b>(7)</td></table> 93<hr> 94</body> 95</html> 96