glscnv(1M) glscnv(1M)
NAME
glscnv - code set mapping test program
SYNOPSIS
glscnv [-i] [-o] [-v] [-f filename] [-t tracefile ]
DESCRIPTION
glscnv is a filter that emulates the action of the GLS STREAMS module
in user mode. It takes characters from the standard input,
optionally performs input processing on each character, and passes
them to be optionally output processed. The processed characters are
then written to the standard output. The program takes the same
format of binary mapping file as the GLS STREAMS module, i.e., the
output file from codesio. It performs the same validation, and
produces the same error code numbers.
-i Enable input processing. This is also enabled if output
processing is not enabled.
-o Enable output processing.
-v Enable escape processing. All output characters are converted
into a printable representation.
-f filename
Use the specified filename as the binary mapping file. If this
option is not given, the program finds the binary input mapping
file from the default location in /usr/lib/codeset/ $LANG /
$TERM.
-t tracefile
Output tracing is enabled and the output sent to the tracefile
specified.
Tracing information consists of the following:
The options used to invoke the program.
The name of the binary mapping file being used.
The binary mapping file header.
A dump of the output section of the binary mapping file.
A dump of the input section of the binary mapping file.
If input processing is enabled, each sequence of characters will
generate one line describing the state change and each type of
element used to resolve the sequence.
8/91 Page 1
glscnv(1M) glscnv(1M)
If output processing is enabled, each output character generates a
line describing the processing that has determined mapped output
string.
The program ensures that any gls STREAMS mapping has been disabled.
SEE ALSO
codesio (1).
WARNINGS
Mapping of output characters that may be used in terminal control
sequences, e.g., cursor movement, will have unexpected effects on
screen displays.
Page 2 8/91