kbdpipe(1)                       UNIX System V                       kbdpipe(1)


NAME
      kbdpipe - use the kbd module in a pipeline

SYNOPSIS
      kbdpipe -t table [-f tablefile] [-F] [-o outfile] [infile(s)]

DESCRIPTION
      The kbdpipe command allows the use of kbd tables as pipeline elements
      between user programs.  [See kbdcomp(1) and kbd(7) for descriptions of
      the module and its capabilities.]  kbdpipe is mostly useful in code set
      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(1)] 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 is
      prepended to the argument, and an attempt is made to load the table from
      the resulting pathname (that is, it becomes an argument to the loader,
      kbdload).  Assuming 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 overwritten:
            kbdpipe -F -t Dvorak -o iapxai.vj file1 file2

      The following example loads the Dvorak table from a different file, then
      converts standard input to standard output.  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

FILES
      /usr/lib/kbd - directory containing system standard table files.

SEE ALSO
      kbdload(1), kbdset(1), kbd(7).



10/89                                                                    Page 1

kbdpipe(1)                       UNIX System V                       kbdpipe(1)


NOTES
      Because kbdpipe uses kbdload(1) to load tables, it cannot resolve link
      references.  Therefore, if a composite table is to be used, the relevant
      portions must either be already loaded and public, or be contained in the
      file indicated (via the -f option) on the command line; in this case, the
      composite elements must be loaded earlier than the link entry.

      Users may use kbd tables in programs at user level by opening a pipe,
      pushing the module, and setting via related commands; hence, there is no
      real need to use the kbdpipe command.  kbdpipe may not be supported in
      future releases.











































Page 2                                                                    10/89