kbdpipe(1)							    kbdpipe(1)

NAME    [Toc]    [Back]

     kbdpipe - use the kbd module in a pipeline

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     The kbdpipe command allows	the use	of kbd tables as pipeline elements
     between user programs.  [See kbdcomp(1M) 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(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 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    [Toc]    [Back]

     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    [Toc]    [Back]

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





									Page 1






kbdpipe(1)							    kbdpipe(1)

SEE ALSO    [Toc]    [Back]

     kbdload(1M), kbdset(1), kbd(7).

NOTES    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 2222