UCSPI-DAEMON(1) 					       UCSPI-DAEMON(1)



NAME
       ucspi-daemon - ucspi tcpserver/tcpclient daemon

SYNOPSIS
       ucspi-daemon [-c w|r|wr|rw ...] [-i infile] [-o outfile]
       [-r] [-s r|w|rw|wr ...] [-v] [argument(s)]

DESCRIPTION
       Ucspi-daemon is for providing interoperability and transaction process-
       ing for the tcpserver and tcpclient programs at	http://cr.yp.to/ucspi-
       tcp.html.  Only	text transactions are permitted, (the program uses the
       EOT = ^D = end of transmission/transaction character for EOF and trans-
       action  concurrency  control  across  the link, which is not compatible
       with binary data.)

       For example:

	   tcpserver -v 0 23456 ucspi-daemon -s rw -i file1 -o file2
	   tcpclient -v 0 23456 ucspi-daemon -c wr -i file3 -o file4

       would establish a connection on localhost,  port  23456,  and  transfer
       file3 to file2, then transfer file1 to file4, as directed by the -c wr,
       (write to the network, then read,) and -s rw, (read from  the  network,
       then  write.)  The  files  can be named pipes for accessing program i/o
       across a network.

       The sequence of r's and w's can be any length, but the server -s  argu-
       ment  must be a "mirror" of the client, i.e., r->w, and vice verse; the
       r's and w's should alternate for flow/transaction control.

       The output file is advisory write locked for the duration of the trans-
       action for concurrency control.

       If  arguments  are  supplied on the command line, the arguments will be
       EOS = '0 terminated, and sent to the link, instead of the input file.

       The -r option does not strip the EOT = ^D = end of  transmission/trans-
       action character from the data sent to the output file, (the default is
       to strip it,) for use by programs interoperating over the link.

OPTIONS
       -c w|r|wr|rw ...
	      Ucspi/tcpclient daemon  read/write  transaction  sequence,  (w);
	      mutually exclusive with -s

       -i infilename
	      Input filename, (stdin).

       -o outfile
	      Output filename, (stdout).

       -r     Do  not  remove  EOT = ^D = end of transmission/transaction from
	      outfile.

       -s r|w|rw|wr ...
	      Ucspi/tcpserver daemon  read/write  transaction  sequence,  (r);
	      mutually exclusive with -c, (default).

       -v     Print the program's version information


       argument(s)
	      concatenate arguments, instead of reading infile.

WARNINGS
       ucspi-daemon(1).

DIAGNOSTICS
       Error  messages	for  incompatible  arguments,  inaccessible files, and
       opening and closing files.

AUTHORS
       ----------------------------------------------------------------------

       A license is hereby granted to reproduce this software source code and
       to create executable versions from this source code.  The copyright
       notice included with the software must be maintained in all copies
       produced.

       THIS PROGRAM IS PROVIDED "AS IS". THE AUTHOR PROVIDES NO WARRANTIES
       WHATSOEVER, EXPRESSED OR IMPLIED, INCLUDING WARRANTIES OF
       MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURPOSE.  THE
       AUTHOR DOES NOT WARRANT THAT USE OF THIS PROGRAM DOES NOT INFRINGE THE
       INTELLECTUAL PROPERTY RIGHTS OF ANY THIRD PARTY IN ANY COUNTRY.

       Copyright (c) 1994-2007, John Conover, All Rights Reserved.

       Comments and/or bug reports should be addressed to:

	   john@email.johncon.com (John Conover)

	   http://www.johncon.com/

       ----------------------------------------------------------------------



			       January 10, 2007 	       UCSPI-DAEMON(1)