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