libiconv/man/iconv.1

   1 .\" Copyright (c) Bruno Haible <bruno@clisp.org>
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" References consulted:
   9 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
  10 .\"   POSIX 2001 draft6
  11 .\"
  12 .TH ICONV 1  "January 13, 2002" "GNU" "Linux Programmer's Manual"
  13 .SH NAME
  14 iconv \- character set conversion
  15 .SH SYNOPSIS
  16 .nf
  17 iconv [\fB-c\fP] [\fB-s\fP] [\fB-f\fP \fIencoding\fP] [\fB-t\fP \fIencoding\fP] [\fIinputfile\fP ...]
  18 iconv \fB-l\fP
  19 .fi
  20 .SH DESCRIPTION
  21 The \fBiconv\fP program converts text from one encoding to another encoding.
  22 More precisely, it converts \fBfrom\fP the encoding given for the \fB-f\fP
  23 option \fBto\fP the encoding given for the \fB-t\fP option. Either of these
  24 encodings defaults to the encoding of the current locale. All the
  25 \fIinputfile\fPs are read and converted in turn; if no \fIinputfile\fP is
  26 given, the standard input is used. The converted text is printed to standard
  27 output.
  28 .PP
  29 When option \fB-c\fP is given, characters that cannot be converted are
  30 silently discarded, instead of leading to a conversion error.
  31 .PP
  32 When option \fB-s\fP is given, error messages about invalid or unconvertible
  33 characters are omitted, but the actual converted text is unaffected.
  34 .PP
  35 The encodings permitted are system dependent. For the libiconv implementation,
  36 they are listed in the iconv_open(3) manual page.
  37 .PP
  38 The \fBiconv -l\fP command lists the names of the supported encodings, in a
  39 system dependent format. For the libiconv implementation, the names are
  40 printed in upper case, separated by whitespace, and alias names of an encoding
  41 are listed on the same line as the encoding itself.
  42 .SH "SEE ALSO"
  43 .BR iconv_open "(3), " locale (7)