iconv(1)							      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 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 ALSO
       getopt(3C), iconv(3C).

STANDARDS CONFORMANCE
								      iconv(1)

Vote for polarhome