SPRAWS1(1)							    SPRAWS1(1)



NAME
       sprawS1 - serial port ttyS1 communication

SYNOPSIS
       sprawS1 [-d device] [-i infilename] [-l lockfile] [-o outfilename] [-v]

DESCRIPTION
       SprawS1	is for asynchronous raw serial port communication. The default
       port is /dev/ttyS1 at 9600 baud. The default  semaphore	lock  file  is
       /var/lock/LCK..ttyS1,  which  has  an  fcntl(2)	advisory lock applied,
       also. The serial port is controlled through termios(3), and is restored
       to  original values on exit. The serial port child read process is cre-
       ated by fork(2) from the  parent  write	process,  and  both  processes
       respond	to  SIGINT  = ^C and SIGTERM signals. Asynchronous serial port
       control is implemented with select(2). The input file, (usually stdin,)
       uses canonical input for flow control.

       The  program is intended to provide a simple, and reliable, serial port
       communication between a computer and a simple device.

OPTIONS
       -d device
	      Device name, (/dev/ttyS1).

       -i infilename
	      Input filename, (stdin).

       -l lockfile
	      Lock file name, (/var/lock/LCK..ttyS1).

       -o outfilename
	      Output filename, (stdout).

       -v     Print the program's version information

WARNINGS
       The termios(3) and fopen(2) settings tested only on Linux 2.4,  and  on
       US  Robotics 56K, V.92, and, 33.6 Sportster. No others were tested. The
       semaphore locking mechanism uses fcntl(2), and may  not	be  compatible
       with other serial programs.

SEE ALSO
       spcid(1),   spgettermios(1)  spsettermios(1),  spttyS0(1),  spttyS1(1),
       sprawS0(1), sprawS1(1), phone.sh(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 for personal,
       non-commercial use.  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-2006, John Conover, All Rights Reserved.

       Comments and/or bug reports should be addressed to:

	   john@email.johncon.com (John Conover)

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



				 June 18, 2006			    SPRAWS1(1)