# pragma ident "@(#)readme_flowctl	1.2      01/07/30 SMI"
# Copyright (c) 2001 by Sun Microsystems, Inc.  All rights reserved.
#
#
# Balchandra Vaidya   16/10/2000
#

TEST NAME : flowctl 

DESCRIPTION: This program set the terminal parameter with the requested baud rate
             and flow control using standard ioctl(), and then transfer and recieve the 
             data for the duration of $RUNTIME seconds.

COMMAND LINE:
	     Iflowctl ( -n | -h | -s ) -d <devicename> [ -b <baudrate> ] [ -m <max> ]
	     Oflowctl ( -n | -h | -s ) -d <devicename> [ -b <baudrate> ] [ -m <max> ]

REQUIRED RUN TIME: ~8 hours

INFORMATION:
	     The Oflowctl and Iflowctl set the parameter with the requested baud rate 
	     and flow control using standard ioctl(). Oflowctl transmit the data until
	     $RUNTIME expires or if any error occur during transmission. Iflowctl
	     recieve the data until $RUNTIME expires or if any error occur during
	     reception.
	     
	     The following options are supported.

	     -n		 No flow control

	     -h  	 Hardware flow control (RTSCTS)

	     -s  	 Software flow control

	     -d 	 Device for communication. The device name should follow the 
			 full path. Usually All dialout devices path starts as
			 /dev/cua/...

	     -b		 Baud rate. This must be the one specified in termio(7I) man page.
	     
	     -m 	 Maximum number of charector should be transmitted.

	     

EXAMPLE    :
	      If, reciever device is /dev/cua/a
		  transmitter device is /dev/cua/b
		  Reciever baud rate is 38400
		  Transmitter baud rate is 38400
		  Flow control is software

	      then,
		on reciever side,
		Iflowctl -s -d /dev/cua/a -b 38400

		on transmitter side,
		Oflowctl -s -d /dev/cua/b -b 38400


		Note: The reciever or transmitter can be on same machine or different
		      machine, but must physically connected.

ISSUES     :
	    
