iconv(1)                                                              iconv(1)


NAME
     iconv - code set conversion utility

SYNOPSIS
     iconv [-ei] -f fromcode -t tocode [file]
     iconv [-ei] -l

DESCRIPTION
     iconv converts the characters or sequences of characters in file from one
     code set to another and writes the results to standard output.  Should no
     conversion exist for a particular character then it is converted to the
     underscore ' ' in the target code set.

     With the arguments fromcode and tocode identifying the input and output
     code sets, respectively iconv will data perform conversion.  If no file
     argument is specified on the command line, iconv reads the standard
     input. -e will echo conversion errors to standard error while -i will not
     report errors. -i is the default.

     Optional iconv converters are available by installing IRIX national
     language support options. iconv -l will list converters that are
     configured for that system. iconv -el will only list those converters
     that are able to be opened. These may be different due to resource or
     incomplete installation problems.

     Unless otherwise specified, conversions between dis-similar code-sets are
     performed by using UNICODE as the intermediate code set.

EXAMPLES
     The following converts the contents of file "file.txt" from code set
     ISO-8859-1 to UTF-8 and stores the results in file file.iv.

     iconv -f ISO8859-1 -t UTF-8 < file.txt > file.iv

     Or if you have the Japanese environment installed you may perform the
     following which converts file "file.sjis" from the PC-DOS Japanese code
     set to the eucJP or Extended Unix Code for Japanese and stores the
     results in "file.eucJP".

     iconv -f sjis -t eucJP < file.sjis > file.eucJP

SEE ALSO

FILES
     /usr/lib/iconv/spec
          lists the conversions supported
     /usr/lib/iconv/tables
          conversion tables
     /usr/lib/locale/locale/LC_MESSAGES/uxmesg
          language-specific message file [See LANG on environ(5).]


DIAGNOSTICS
     iconv returns 0 upon successful completion, 1 otherwise.


                                                                        Page 2