KBDPIPE(1) RISC/os Reference Manual KBDPIPE(1)
NAME
kbdpipe - use the kbd module in a pipeline
SYNOPSIS
kbdpipe -t table [-f tablefile] [-F] [-o outfile] [infiles]
DESCRIPTION
kbdpipe allows the use of kbd(7) tables as pipeline elements
between user programs. (General descriptions of the module
and its capabilities appear in kbdcomp(1M) and kbd(7).)
kbdpipe is mostly useful in codeset conversion applications.
If an output file is given, then all infiles are piped to
the given output file. With no arguments other than -t,
standard input is converted and sent to standard output.
The required "option" argument -t identifies the table to be
used for conversion. If the table has already been loaded as
a shared table (see kbdload(1M)) it is attached.
If, however, the table has not been loaded, an attempt is
made to load it. If the given table name is not an absolute
pathname then the name of the system mapping library
(/usr/lib/kbd) is pre-pended to the argument, and an attempt
is made to load the table from the resulting pathname (i.e.,
it becomes an argument to the loader, kbdload(1M)). Assum-
ing the table can be loaded, it is attached.
The argument to -f defines the filename from which the table
will be loaded, overriding the default action described
above. The file is loaded (in its entirety), and the named
table attached. This option should be used if the default
action would fail.
The output file specified by -o must not already exist (a
safety feature.) The option -F may be used to override the
check for existence of the output file; in this case, any
existing outfile will be truncated before being written.
EXAMPLES
The following example converts two input files into relative
nonsense by mapping ASCII into Dvorak keyboard equivalents
using the Dvorak table. The table is assumed to reside in
the file /usr/lib/kbd/Dvorak. The existing output file is
forcefully overwritten:
kbdpipe -F -t Dvorak -o iapxai.vj file1 flle2
The following example loads the Dvorak table from a dif-
ferent file, then converts stdin to stdout. The Dvorak
table (assumed to be non-resident) is explicitly loaded from
an absolute path beginning at the user's home directory:
kbdpipe -t Dvorak -f $HOME/tables/Dvorak.tab
Printed 11/19/92 Page 1
KBDPIPE(1) RISC/os Reference Manual KBDPIPE(1)
FILES
/usr/lib/kbd directory containing system stan-
dard table files.
SEE ALSO.
kbdload(1), kbdset(1).
kbd(7) in the RISC/os System Administrator's Reference
Manual.
Page 2 Printed 11/19/92