NAME

       gensio - Tool for doing gensio connections

SYNOPSIS

       gensiotool [-i|--input io1] [-d|--debug] [-a|--accepter] [--signature <sig>] [-e|--escchar
       char] [-p|--printacc] [--server] [-h|--help] io2

DESCRIPTION

       The gensiotool program allows connections to be made using gensios  It creates two gensios
       called io1 and io2.  io1 is by default the local terminal and io2 must be specified.

       By  default,  gensiotool  make  two  normal gensios and establishes connections to each of
       them.  Any data that comes in on one gensio is transmitted on the other.

       For a description of how to specify a gensio, see the gensio documentation.

OPTIONS

       -i|--input io1
              By default io1 is the local terminal ( /dev/tty ) for a tty stdin, or the program's
              stdin/stdout  for  a  non-tty  stdin.  This lets another gensio be specified as the
              device hook to io2.

       -a|--accepter
              By default io2 make an outgoing connection.  This  modifies  io2  to  be  a  gensio
              accepter  and  waits for an incoming connection.  Once the connection comes in, the
              accepter is closed and operations proceeds as normal.

       --signature
              Serial server signature reported to the remote end.  If an  accepter  is  specified
              (currently  only  a  telnet  RFC2217 server) the signature given is used instead of
              "gensiotool".

       -d|--debug
              Generate debugging output.  Specifying more than once increases the output.

       -e|--escchar char
              Specify a character to use for the escape character.  Setting it to -1 disables the
              escape  character.  This can either be a decimal or hexadeximal number or ^x to set
              a control character.  By default it is ^\ if io1 is the default and stdin is a tty,
              or disabled otherwise.  See ESCAPES below for more details on the escape character.
              Only handled on io1.

       -p|--printacc
              If -a is specified, print out all the accept addresses chosen by the program.

       -n|--extra-threads <n>
              Spawn <n> extra threads to handle gensio operations.  Useful  for  scalabiity  with
              --server.

       --server
              When  an  accept happens, don't disable accept, but continue to accept connections,
              and won't close if all the connections go away..  If this is not specified, it shut
              down  the  accepter  when  a  connection  comes  in  and  will  terminate when that
              connection closes.

       -h|--help
              Help output

ESCAPES

       If the escape character is received on io1, the  character  is  not  transferred  and  the
       program waits for another character.  If the other character is also the escape character,
       a single escape character is sent.  If the other character is not recognized  as  a  valid
       escape, it is ignore and not transferred.  Upper and lower case are equivalent.

       Escape characters are:

       q      Quit the program.

       b      Send a break to io2.  Ignored if io2 does not support break.

       d      Dump serial data for io2.  Ignored if io2 is not a serial gensio.

       s      Set  the  serial  port (baud) rate for io2.  Ignored if io2 is not a serial gensio.
              After this, the serial port speed must be typed, terminated by a new line.  Invalid
              speeds are ignore, use escchar-d to know if you set it right.

       n, o, e
              Set  the  parity  on  io2  to  none,  odd, or even.  Ignored if io2 is not a serial
              gensio.

       5, 6, 7, 8
              Set the data size on io2 to the number of bits.  Ignored if io2  is  not  a  serial
              gensio.

       1, 2   Set  the number of stop bits to 1 or 2 on io2 bits.  Ignored if io2 is not a serial
              gensio.

       x, r, f
              Sets flow control to xonxoff, rtscts, or none.

SEE ALSO

       gensio(5)

KNOWN PROBLEMS

       None.

AUTHOR

       Corey Minyard <minyard@acm.org>