iconv(1) General Commands Manual iconv(1)
NAME
iconv - codeset conversion
SYNOPSIS
frommap tomap [file]...
fromcode tocode] [file]...
tocode fromcode] [file]...
DESCRIPTION
The command converts the encoding of characters in the input files from one codeset to another, and writes the results to standard output.
If no input files are given, reads from standard input. If appears as an input file name, the command reads standard input at that point.
can be used to delimit the end of options (see getopt(3C)).
Options
The command recognizes the following options:
Omit any characters that are invalid in the codeset of the input file
from the output. This is the default.
Identify the codeset corresponding to option argument
fromcode as the codeset that the input will be converted "from". The fromcode option argument must not contain a
slash character. If this option is omitted, the codeset of the current locale will be used.
The frommap option argument must contain a slash character. It is interpreted as the pathname of a charmap file which is
parsed to determine the codeset name defined in the charmap file.
Write all the supported
fromcode and tocode values to standard output as defined in the iconv configuration files, or See iconv(3C) for
details.
Suppress any error messages written to standard error concerning invalid
characters. The presence or absence of does not affect the exit status of
Identify the codeset corresponding to option argument
tocode as the codeset that the input will be converted "to". The tocode option argument must not contain a slash
character. If this option is omitted, the codeset of the current locale will be used.
The tomap option argument must contain a slash character. It is interpreted as the pathname of a charmap file which is
parsed to determine the codeset name defined in the charmap file.
The fromcode and tocode names can be any of the base and alias names listed in the iconv configuration files, or See iconv(3C) for details
and the configuration files for a list of supported codeset names.
EXTERNAL INFLUENCES
Environment Variables
provides a default value for the internationalization variables that are unset or null. If is unset or null, the default value of "C" (see
lang(5)) is used. If any of the internationalization variables contains an invalid setting, the command will behave as if all internation-
alization variables are set to "C". See environ(5).
Setting to a non-empty string value overrides the values of all the other internationalization variables.
determines the interpretation of text as single and/or multi-byte characters, the classification of characters as printable, and the char-
acters matched by character class expressions in regular expressions. During translation of the file, this variable is superseded by the
use of the fromcode option argument.
determines the locale that should be used to affect the format and contents of diagnostic messages written to standard error and informa-
tive messages written to standard output.
determines the location of message catalogs for the processing of
International Code Set Support
Single and multi-byte character codesets are supported.
RETURN VALUE
returns the following values:
Successful completion.
An error occurred.
EXAMPLES
Convert the contents of file from codeset Roman8 to ISO 8859/1 and store the results in file
WARNINGS
If an input character does not have a valid equivalent in the codeset selected by the option (the "to" codeset), it is mapped to the "gal-
ley character", if it has been defined for that conversion (see genxlt(1) and iconv(3C)).
If an input character does not belong to the codeset selected by the option (the "from" codeset), the command terminates.
FILES
User customizable configuration file
System configuration file, containing codenames supported by the operating system
AUTHOR
The command was developed by HP.
SEE ALSO
getopt(3C), iconv(3C).
STANDARDS CONFORMANCE
iconv(1)