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