g

genxlt(1)

genxlt(1)

NAME

genxlt - generate iconv translation tables

SYNOPSIS

genxlt [ -foutput_®lename ] [ input_®lename ]

DESCRIPTION

genxlt generates a compiled, non-readable binary version of the iconv table that is suitable for use by iconv(1) and iconv(3C). If input_®lename or output_®lename is not supplied, standard input and/or standard output will be used.

Since the output of genxlt is a binary, non-readable ®le, if the -foption is not used, the redirection symbol > maybe used to redirect the standard output to a ®le.

Options

genxlt recognizes the following options:

-foutput_filename

If this option is not selected, the data will be sent to standard output, from where it could be redirected to a ®le.

genxlt creates tables that are in a prescribed format and which can be interpreted by the default conversion routines of iconv(3C). The input ®le has two columns, giving the ®lecode mapping between the two code sets. The entries are in hexadecimal.

The input ®le must be formatted as two columns of hexadecimal digits. Characters in the ®rst column are translated into the characters in the second column. Lines preceded with # in the ®rst column are ignored as comments on all lines except in the case of the following keywords: #Galley: and #What:

In addition to the data, which de®nes the ®lecode mapping, a Galley character (see iconv(3C)) may also be de®ned for that particular conversion. This is done by adding the line #Galley: 0xnnnn, to the beginning of the input ®le. The nnnn is any multi-byte character (see EXAMPLES). A What string (see what(1)), may also be de®ned in the input ®le using the entry #What: <any_string>. This string may contain information like version number, type of conversion, etc., which are not used in any way for the conversions. Note that if the What string is de®ned, it should appear before the Galley de®nition.

EXTERNAL INFLUENCES

Environment Variables

LANG provides a default value for the internationalization variables that are unset or null. If LANG is unset or null, the default value of "C" (see lang(5)) is used. If any of the internationalization variables contains an invalid setting, genxlt will behave as if all internationalization variables are set to "C" (see environ(5)).

If LC_ALL is set to a non-empty string value, it overrides the values of all the other internationalization variables.

LC_MESSAGES determines the locale that should be used to affect the format and contents of diagnostic messages written to standard error and informative messages written to standard output.

NLSPATH determines the location of message catalogues for the processing of LC_MESSAGES .

International Code Set Support

Single and multi-byte character code sets are supported.

RETURN VALUE

The exit values are:

0Successful completion. >0 Error condition occurred.

EXAMPLES

This example compiles the iconv_input and puts the output binary in /usr/lib/nls/iconv/tables/roma8=iso81. The following iconv statement uses the roma8=iso81 table to convert the data_®le from code set roman8 to code set iso8859-1.

%genxlt iconv_input > /usr/lib/nls/iconv/tables/roma8=iso81

%iconv -f roma8 -t iso81 data_file

Section 1−316

− 1 −

HP-UX Release 11i: December 2000