File Formats                                              csconv.conf(4)



NAME

     csconv.conf - CSConv configuration file


SYNOPSIS

     /etc/lib/im/csconv/csconv.conf
     /usr/lib/im/csconv/csconv.conf


DESCRIPTION

     The csconv.conf file contains the CSConv (Code Set Converter -
     encoding conversion) configuration information used by csconv
     routines.  This information describes which csconv shared object
     provides required encoding conversion function.

     Shared objects are evaluated in the order in which they appear in
     the configuration file.  If the evaluation succeeds, no further
     shared object will be evaluated.

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

       OS  locale  encoding(from)  encoding(to)  object  entry

     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.

     locale
         The name of locale for which the entry is evaluated.  The name
         may be normalized thru encoding.norm prior to calling open
         entry in the object.

     encoding(from)
         The name of encoding name for which the entry is evaluated.
         The name may be normalized thru encoding.norm prior to calling
         open entry in the object.

     encoding(to)
         The name of encoding name for which the entry is evaluated.
         The name may be normalized thru encoding.norm prior to calling
         open entry in the object.

     object
         The name of object file (shared library) in which the encoding
         converter is available.  

         If the name is a single hyphen, built-in encoding converter
         objects are consulted before searching external shared library.
         If the encoding converter is not built-in, the name of object
         file is assumed to be the same as the entry name.

         The shared library is searched in /etc/lib/im/csconv/csconv
         directory, then in /usr/lib/im/csconv directory.  Shared
         library extension `.so' is always appended.

     entry
         The name of encoding converter.  Entry names of the encoding
         converter will be prefixed with this name.  If the name of the
         encoding converter is FOO, interface names will be FOO_open(),
         FOO_close(), and FOO_conv().


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

FILES

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


SEE ALSO

     csconv(3), encoding.norm(4)
