Index for Section 1

Alphabetical listing for G

Bottom of page

genxlt(1)
NAME
  genxlt - Generates a codeset conversion table

SYNOPSIS
  genxlt [-f outputfile] [inputfile]

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

DESCRIPTION
  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
  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
  Commands:  iconv(1)

  Functions:  iconv(3)

Index for Section 1

Alphabetical listing for G

Top of page