File Formats                                              csconv.conf(4)



NAME

     encoding.norm - CSConv encoding normalization file


SYNOPSIS

     /usr/lib/im/csconv/encoding.norm
     /etc/lib/im/csconv/encoding.norm


DESCRIPTION


     The encoding.norm file contains the CSConv (Code Set Converter -
     encoding conversion) encoding normalization information used by
     csconv library routines.  This information describes how encoding
     name pair will be mapped to the other encoding name pair.

     Mapping definitions are evaluated in the order in which they appear
     in the configuration file.  If the evaluation succeeds, no further
     mapping definitions will be evaluated.

     Each entry is composed of a single line of the form:

       OS  source-locale  source-encoding1  source-encoding2
       destination-locale  destination-encoding1  destination-encoding2

     Fields are separated by ether SPACE or TAB characters.  A `#'
     (number sign) indicates the beginning of a comment; characters up
     to the end of the line are not evaluated.


     OS
         The name of OS for which the entry is evaluated.

     source-locale
         The name of locale for which the entry is evaluated.

     source-encoding1
         The name of encoding name for which the entry is evaluated.

     source-encoding2
         The name of encoding name for which the entry is evaluated.

     destination-locale
         source-locale will be mapped to the name.

     destination-encoding1
         source-encoding1 will be mapped to the name.

     destination-encoding2
         source-encoding1 will be mapped to the name.

         The destination-encoding2 can be composed of two encoding names
         separated by `%' (percent) character, such as enc1%enc2.
         csconv shared object iconv_relay will perform two step encoding
         conversion in the encoding.  Firstly, it converts from
         destination-encoding1 to enc1 encoding.  Secondly, it converts
         from enc1 encoding to enc2 encoding.

         The destination-encoding2 can be composed of three encoding
         names separated by `|' (vertical bar) and `%' (percent)
         character, such as enc1|enc2%enc3.  csconv shared object
         iconv_relay will perform two step encoding conversion in the
         encoding.  Firstly, it converts from destination-encoding1 to
         enc1 encoding.  Secondly, it converts from enc2 encoding to
         enc3 encoding.  enc1 is the same encoding as enc2, but the name
         is different.


     The default configuration file is /usr/lib/im/csconv/encoding.norm.
     and /usr/lib/im/csconv/csconv.so includes a copy of this default
     configuration.  /etc/lib/im/csconv/encoding.norm is examined first,
     then the default configuration file is examined.
 

SEE ALSO

     csconv(3)
