NAME    [Toc]    [Back]

       genxlt - Generates a codeset conversion table

SYNOPSIS    [Toc]    [Back]

       genxlt [-f outputfile] [inputfile]

OPTIONS    [Toc]    [Back]

       Specifies  that  the generated version of the codeset conversion
 table be placed in the file specified  by  outputfile.

DESCRIPTION    [Toc]    [Back]

       The  iconv  subsystem  can  use either an algorithmic or a
       table converter  to  convert  data  from  one  codeset  to
       another.  The  genxlt command creates a table converter to
       be used by the iconv subsystem.

       The genxlt command reads a source codeset conversion table
       file  from  inputfile  and  writes the compiled version to
       outputfile. If inputfile is not specified, standard  input
       is  used.  If outputfile is not specified, standard output
       is used. The source codeset conversion table file contains
       directives  that  are  acted upon by the genxlt command to
       produce the compiled version.

       The format of a translation source  file  is  as  follows:
       Lines  whose  initial  nonwhite-space  character  is the #
       (number sign) are treated as comment  lines.   Null  lines
       and  lines  consisting  only of white-space characters are
       treated as comment lines.  Noncomment lines have to be  of
       the following form: source target comment


       If  source is found in the source codeset conversion table
       file multiple times, the last entry is used in the  compilation
 of the translation table.

       The  source  and  target arguments must be in the range of
       0x00 through 0xff, inclusive; this restricts the table  to
       8-bit  codesets.  The  conversion table must define all of
       the 256 possible source values; otherwise, processing  the
       table results in an error.

       The following is an excerpt of a codeset conversion table:

       0x80    0xc7    C cedilla 0x81    0xfc    u diaeresis 0x82
       0xe9     e acute 0x83    0xe2    a circumflex 0x84    0xe4
       a diaeresis 0x85    0x40    a grave

       The name of the file generated by the genxlt command  must
       use the following naming convention in order for the iconv
       subsystem to recognize the file as a valid converter.

       fromcode: "ISO8859-1-GL"  tocode:  "ISO8859-1"  conversion
       table file: "ISO8859-1-GL_ISO8859-1"

       The  conversion table file name is formed by concatenating
       the tocode file name onto the fromcode file name, with  an
       underscore character between the two. The compiled conversion
 table must reside in the  /usr/lib/nls/loc/iconvTable
       directory  or,  if  the LOCPATH variable is defined, in an
       iconvTable directory subordinate to the LOCPATH directory.
       Otherwise, the iconv command does not find the table.

                                  Note

       The  LOCPATH  variable  also  overrides the default search
       path (/usr/lib/nls/loc) that is used to find  locales.  If
       this  variable  is  defined,  it  must therefore specify a
       search path that application and system software  can  use
       to  find both locales and converters. The LOCPATH variable
       is not defined by any standard, so  use  of  the  variable
       should  be  limited to testing locales or converters under
       development.

EXIT STATUS    [Toc]    [Back]

       If successful, the genxlt command exits with a value of  0
       (zero).  If  an unknown flag is detected, or the specified
       input file or output file cannot  be  opened,  the  genxlt
       command  is unsuccessful and exits with a value of 1. If a
       syntax error is detected in the input stream,  the  genxlt
       command will exit immediately with a value of 2, and write
       to standard error the line numbers where the syntax  error
       occurred.

SEE ALSO    [Toc]    [Back]

       Commands:  iconv(1)

       Functions:  iconv(3)



                                                        genxlt(1)