iconv ( 1 ) USER COMMANDSiconv ( 1 )


NAME

iconv - codeset conversion

SYNOPSIS

iconv [ options ] [ pid ... ]

DESCRIPTION

iconv converts the encoding of characters in the file operands from one codeset to another and writes the results to the standard output. If file is - or omitted then the standard input is read.

Character encodings in either codeset may include single-byte values (for example, for the ISO 8859-1:1987 standard characters) or multi-byte values (for example, for certain characters in the ISO 6937:1983 standard). Invalid characters in the input stream (either those that are not valid members of the input codeset or those that have no corresponding value in the output codeset) are output as the underscore character (_) in the output codeset.

The native codeset is determined by the LANG, LC_ALL and LC_CTYPE environment variables. The supported codesets are matched by these left-anchored case-insensitive ksh(1) patterns:
a|ascii|?(iso)?(-)646|?(iso)?(-)8859|latin
8 bit ascii
e|ebcdic?(-)?([1e]
X/Open ebcdic
o|ebcdic?(-)[3o]|?(cp|ibm)1047|open?(-)edition
mvs OpenEdition ebcdic
h|ebcdic?(-)h|?(cp|ibm)?(00)37|[oa]s?(/-)400
ibm OS/400 AS/400 ebcdic
s|ebcdic?(-)s|siemens|posix-bc
siemens posix-bc ebcdic
i|ebcdic?(-)[2i]|ibm
X/Open ibm ebcdic (not idempotent)
m|ebcdic?(-)m|mvs
mvs ebcdic
u|ebcdic?(-)(u|mf)|microfocus
microfocus cobol ebcdic
n|native|local
native code set
un|unicode|utf
multibyte 8-bit unicode
um|ume|utf?(-)7
multibyte 7-bit unicode
big|euc)*
euc family
dos?(-)?(855
dos code page
ucs?(-)?(2)?(be)|utf-16?(be
unicode runes
ucs?(-)?(2)le|utf-16le
little endian unicode runes

Conversion between certain codesets may not be supported. Also, since the standard(s) provide no support for listing the known codesets, the above list may be incomplete.

OPTIONS

-e, --errors
Do not ignore conversion errors.
-f, --from=codeset
The input codeset is set to codeset. The default value is native.
-i, --ignore
Ignore conversion errors. This is the default.
-t, --to=codeset
The output codeset is set to codeset. The default value is native.

SEE ALSO

dd(1), iconv(3), setlocale(3)

IMPLEMENTATION

version
iconv (AT&T Research) 2000-05-09
author
Glenn Fowler <gsf@research.att.com>
copyright
Copyright © 1989-2008 AT&T Intellectual Property
license
http://www.opensource.org/licenses/cpl1.0.txt