iconv(1)
NAME
iconv − code set conversion utility
SYNOPSIS
iconv −f fromcode −t tocode [ file... ]
DESCRIPTION
The iconv utility 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.
The list of supported conversions and the locations of the associated conversion tables are provided in the iconv(5) manual page.
OPTIONS
The following options are supported:
−f fromcode Identifies the input code set.
−t tocode Identifies the output code set.
OPERANDS
The following operands are supported:
file A path name of the input file to be translated. If file is omitted, the standard input is used.
EXAMPLES
The following example converts the contents of file mail1 from code set 8859 to 646fr and stores the results in file mail.local.
example% iconv −f 8859 −t 646fr mail1 > mail.local
ENVIRONMENT
See environ(5) for descriptions of the following environment variables that affect the execution of iconv: LC_CTYPE, LC_MESSAGES, and NLSPATH.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 An error has occurred.
FILES
/usr/lib/iconv/∗.so conversion modules
/usr/lib/iconv/∗.t conversion tables
/usr/lib/iconv/iconv_data
list of conversions supported by conversion tables
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWcsu |
SEE ALSO
iconv(3), attributes(5), environ(5), iconv(5), iconv_unicode(5)
NOTES
The iconv utility can use conversion modules (/usr/lib/iconv/∗.so) or conversion tables (/usr/lib/iconv/∗.t). If a conversion module and a conversion table both exist for a particular code set conversion, iconv uses the conversion module.
Refer to the /usr/share/man/man5/iconv_locale.5 manual page in the Asian localized releases for information on which code set conversions are supported. For example, the command
% man −s 5 iconv_ja
would display the manual page describing the code set conversions that are supported for the Japanese locale.
Note that the iconv_locale.5 manual page may not exist in every localized release. Also, the iconv_locale.5 manual page does not exist in the U. S. (non-localized) release.
SunOS 5.6 — Last change: 18 Apr 1997