genxlt(1)genxlt(1)NAMEgenxlt - generate iconv translation tables
SYNOPSIS
[output_filename] [input_filename]
DESCRIPTION
generates a compiled, non-readable binary version of the iconv table
that is suitable for use by iconv(1) and iconv(3C). If input_filename
or output_filename is not supplied, standard input and/or standard out‐
put will be used.
Since the output of is a binary, non-readable file, if the option is
not used, the redirection symbol maybe used to redirect the standard
output to a file.
Options
recognizes the following options:
If this option is not selected, the data will be sent to stan‐
dard
output, from where it could be redirected to a
file.
creates tables that are in a prescribed format and which can be inter‐
preted by the default conversion routines of iconv(3C). The input file
has two columns, giving the filecode mapping between the two code sets.
The entries are in hexadecimal.
The input file must be formatted as two columns of hexadecimal digits.
Characters in the first column are translated into the characters in
the second column. Lines preceded with in the first 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 defines the filecode mapping, a Galley
character (see iconv(3C)) may also be defined for that particular con‐
version. This is done by adding the line to the beginning of the input
file. The is any multi-byte character (see A What string (see
what(1)), may also be defined in the input file using the entry 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 defined, it should appear before the Galley defini‐
tion.
EXTERNAL INFLUENCES
Environment Variables
provides a default value for the internationalization variables that
are unset or null. If is unset or null, the default value of "C" (see
lang(5)) is used. If any of the internationalization variables con‐
tains an invalid setting, will behave as if all internationalization
variables are set to "C" (see environ(5)).
If is set to a non-empty string value, it overrides the values of all
the other internationalization variables.
determines the locale that should be used to affect the format and con‐
tents of diagnostic messages written to standard error and informative
messages written to standard output.
determines the location of message catalogues for the processing of
International Code Set Support
Single and multi-byte character code sets are supported.
RETURN VALUE
The exit values are:
Successful completion.
Error condition occurred.
EXAMPLES
This example compiles the iconv_input and puts the output binary in The
following iconv statement uses the roma8=iso81 table to convert the
data_file from code set to code set
This is an example of the input_file:
WARNINGS
Because will write over the existing table, it is wise to save the
existing table into another file before using
Warnings are not given for incorrect data in the input_file.
You must have super-user privileges to install files in
FILES
All tables must be installed in this directory.
SEE ALSOdmpxlt(1), iconv(1), iconv(3C).
STANDARDS COMPLIANCE
tables
genxlt(1)