iconv(1)iconv(1)NAMEiconv - 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 con‐
verted "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 char‐
acter. 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 con‐
tains an invalid setting, the command will behave as if all interna‐
tionalization 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 char‐
acters, the classification of characters as printable, and the charac‐
ters 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 con‐
tents of diagnostic messages written to standard error and informative
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 "galley
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 oper‐
ating system
AUTHOR
The command was developed by HP.
SEE ALSOgetopt(3C), iconv(3C).
STANDARDS CONFORMANCEiconv(1)