Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
iconv(1)			 User Commands			      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.	If no conversion exists	for a particular character, it is con-
       verted 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 omit-
	     ted, the standard input is	used.

EXAMPLES
       Example 1: Converting and storing files

       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 VARIABLES
       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

       /usr/lib/iconv/geniconvtbl/binarytables/*.bt
	     conversion	binary tables

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       geniconvtbl(1), iconv(3C), geniconvtbl(4),  attributes(5),  environ(5),
       iconv(5), iconv_unicode(5)

NOTES
       The  iconv  utility  can	 use conversion	modules	(/usr/lib/iconv/*.so),
       conversion tables (/usr/lib/iconv/*.t),	or  conversion	binary	tables
       (/usr/lib/iconv/geniconvtbl/binarytables/*.bt)  to do the code set con-
       version.	The iconv utility uses iconv_open(3C) to see if	 a  particular
       code   set   conversion	 is   available	 in  the  iconv(3C)  function.
       iconv_open(3C) first tries to find out if there is a conversion	binary
       table and then if there is a conversion module. If neither is available
       in your system, iconv_open(3C) will return a failure  code.  Then,  fi-
       nally, iconv will search	for a conversion table.

       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

       example%	man -s 5 iconv_ja

       would  display the manual page describing the code set conversions that
       are supported for the Japanese locale.

       Notice that the iconv_locale.5 manual page may not exist	in  your  sys-
       tem,  depending	on which locale	you chose to install during the	system
       installation.

SunOS 5.9			  29 Oct 1999			      iconv(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | ENVIRONMENT VARIABLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=iconv&sektion=1&manpath=SunOS+5.9>

home | help