1gensiotool(1) General Commands Manual gensiotool(1)
2
6 gensio - Tool for doing gensio connections
7
10 gensiotool [options] io2
11
14 The gensiotool program allows connections to be made using gensios It
15 creates two gensios called io1 and io2. io1 is by default the local
16 terminal and io2 must be specified.
17 By default, gensiotool make two normal gensios and establishes connec‐
19 tions to each of them. Any data that comes in on one gensio is trans‐
20 mitted on the other.
21 For a description of how to specify a gensio, see the gensio documenta‐
23 tion.
24
27 -i|--input io1
28 By default io1 is the local terminal ( /dev/tty ) for a tty
29 stdin, or the program's stdin/stdout for a non-tty stdin. This
30 lets another gensio be specified as the device to hook to io2.
31 -a|--accepter
33 By default io2 makes an outgoing connection. This modifies io2
34 to be a gensio accepter and waits for an incoming connection.
35 Once the connection comes in, the accepter is closed and opera‐
36 tions proceeds as normal.
37 --signature
39 Serial server signature reported to the remote end. If an ac‐
40 cepter is specified (currently only a telnet RFC2217 server) the
41 signature given is used instead of "gensiotool".
42 -d|--debug
44 Generate debugging output. Specifying more than once increases
45 the output.
46 -e|--escchar char
48 Specify a character to use for the escape character. Setting it
49 to -1 disables the escape character. This can either be a deci‐
50 mal or hexadeximal number or ^x to set a control character. By
51 default it is ^\ if io1 is the default and stdin is a tty, or
52 disabled otherwise. See ESCAPES below for more details on the
53 escape character. Only handled on io1.
54 -p|--printacc
56 If -a is specified, print out all the accept addresses chosen by
57 the program.
58 -n|--extra-threads <n>
60 Spawn <n> extra threads to handle gensio operations. Useful for
61 scalabiity with --server.
62 --server
64 When an accept happens, don't disable accept, but continue to
65 accept connections, and won't close if all the connections go
66 away.. If this is not specified, it shut down the accepter when
67 a connection comes in and will terminate when that connection
68 closes.
69 --version
71 Print the version number and exit.
72 -h|--help
74 Help output
75
78 If the escape character is received on io1, the character is not trans‐
79 ferred and the program waits for another character. If the other char‐
80 acter is also the escape character, a single escape character is sent.
81 If the other character is not recognized as a valid escape, it is ig‐
82 nore and not transferred. Upper and lower case are equivalent.
83 Escape characters are:
85 q Quit the program.
87 b Send a break to io2. Ignored if io2 does not support break.
89 d Dump serial data for io2. Ignored if io2 is not a serial gen‐
91 sio.
92 s Set the serial port (baud) rate for io2. Ignored if io2 is not
94 a serial gensio. After this, the serial port speed must be
95 typed, terminated by a new line. Invalid speeds are ignore, use
96 escchar-d to know if you set it right.
97 n, o, e
99 Set the parity on io2 to none, odd, or even. Ignored if io2 is
100 not a serial gensio.
101 5, 6, 7, 8
103 Set the data size on io2 to the number of bits. Ignored if io2
104 is not a serial gensio.
105 1, 2 Set the number of stop bits to 1 or 2 on io2 bits. Ignored if
107 io2 is not a serial gensio.
108 x, r, f
110 Sets flow control to xonxoff, rtscts, or none.
111
114 gensio(5)
115
118 None.
119
122 Corey Minyard <minyard@acm.org>
123Tool for doing gensio connections 01/02/19 gensiotool(1)