-
Notifications
You must be signed in to change notification settings - Fork 16
/
README
162 lines (110 loc) · 5.53 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
NAME
IO::Tty - Low-level allocate a pseudo-Tty, import constants.
VERSION
1.20
SYNOPSIS
use IO::Tty qw(TIOCNOTTY);
...
# use only to import constants, see IO::Pty to create ptys.
DESCRIPTION
"IO::Tty" is used internally by "IO::Pty" to create a pseudo-tty. You
wouldn't want to use it directly except to import constants, use
"IO::Pty". For a list of importable constants, see IO::Tty::Constant.
Windows is now supported, but ONLY under the Cygwin environment, see
<http://sources.redhat.com/cygwin/>.
Please note that pty creation is very system-dependend. From my
experience, any modern POSIX system should be fine. Find below a list of
systems that "IO::Tty" should work on. A more detailed table (which is
slowly getting out-of-date) is available from the project pages document
manager at SourceForge <http://sourceforge.net/projects/expectperl/>.
If you have problems on your system and your system is listed in the
"verified" list, you probably have some non-standard setup, e.g. you
compiled your Linux-kernel yourself and disabled ptys (bummer!). Please
ask your friendly sysadmin for help.
If your system is not listed, unpack the latest version of "IO::Tty", do
a 'perl Makefile.PL; make; make test; uname -a' and send me
([email protected]) the results and I'll see what I can deduce from
that. There are chances that it will work right out-of-the-box...
If it's working on your system, please send me a short note with details
(version number, distribution, etc. 'uname -a' and 'perl -V' is a good
start; also, the output from "perl Makefile.PL" contains a lot of
interesting info, so please include that as well) so I can get an
overview. Thanks!
VERIFIED SYSTEMS, KNOWN ISSUES
This is a list of systems that "IO::Tty" seems to work on ('make test'
passes) with comments about "features":
* AIX 4.3
Returns EIO instead of EOF when the slave is closed. Benign.
* AIX 5.x
* FreeBSD 4.4
EOF on the slave tty is not reported back to the master.
* OpenBSD 2.8
The ioctl TIOCSCTTY sometimes fails. This is also known in
Tcl/Expect, see http://expect.nist.gov/FAQ.html
EOF on the slave tty is not reported back to the master.
* Darwin 7.9.0
* HPUX 10.20 & 11.00
EOF on the slave tty is not reported back to the master.
* IRIX 6.5
* Linux 2.2.x & 2.4.x
Returns EIO instead of EOF when the slave is closed. Benign.
* OSF 4.0
EOF on the slave tty is not reported back to the master.
* Solaris 8, 2.7, 2.6
Has the "feature" of returning EOF just once?!
EOF on the slave tty is not reported back to the master.
* Windows NT/2k/XP (under Cygwin)
When you send (print) a too long line (>160 chars) to a non-raw pty,
the call just hangs forever and even alarm() cannot get you out.
Don't complain to me...
EOF on the slave tty is not reported back to the master.
* z/OS
The following systems have not been verified yet for this version, but a
previous version worked on them:
* SCO Unix
* NetBSD
probably the same as the other *BSDs...
If you have additions to these lists, please mail them to
SEE ALSO
IO::Pty, IO::Tty::Constant
MAILING LISTS
As this module is mainly used by Expect, support for it is available via
the two Expect mailing lists, expectperl-announce and
expectperl-discuss, at
http://lists.sourceforge.net/lists/listinfo/expectperl-announce
and
http://lists.sourceforge.net/lists/listinfo/expectperl-discuss
AUTHORS
Originally by Graham Barr <[email protected]>, based on the Ptty module by
Nick Ing-Simmons <[email protected]>.
Now maintained and heavily rewritten by Roland Giersig
Contains copyrighted stuff from openssh v3.0p1, authored by Tatu Ylonen
<[email protected]>, Markus Friedl and Todd C. Miller
<[email protected]>. I also got a lot of inspiration from the
pty code in Xemacs.
COPYRIGHT
Now all code is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
Nevertheless the above AUTHORS retain their copyrights to the various
parts and want to receive credit if their source code is used. See the
source for details.
DISCLAIMER
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN
NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
In other words: Use at your own risk. Provided as is. Your mileage may
vary. Read the source, Luke!
And finally, just to be sure:
Any Use of This Product, in Any Manner Whatsoever, Will Increase the
Amount of Disorder in the Universe. Although No Liability Is Implied
Herein, the Consumer Is Warned That This Process Will Ultimately Lead to
the Heat Death of the Universe.