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)