IO::Tty(3pm)

1Tty(3)                User Contributed Perl Documentation               Tty(3)
2
3
4

NAME

6       IO::Tty - Low-level allocate a pseudo-Tty, import constants.
7

VERSION

9       1.10
10

SYNOPSIS

12           use IO::Tty qw(TIOCNOTTY);
13           ...
14           # use only to import constants, see IO::Pty to create ptys.
15

DESCRIPTION

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
21       Windows is now supported, but ONLY under the Cygwin environment, see
22       <http://sources.redhat.com/cygwin/>.
23
24       Please note that pty creation is very system-dependend.  From my
25       experience, any modern POSIX system should be fine.  Find below a list
26       of systems that "IO::Tty" should work on.  A more detailed table (which
27       is slowly getting out-of-date) is available from the project pages
28       document manager at SourceForge
29       <http://sourceforge.net/projects/expectperl/>.
30
31       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
36       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
38       (RGiersig@cpan.org) the results and I'll see what I can deduce from
39       that.  There are chances that it will work right out-of-the-box...
40
41       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

VERIFIED SYSTEMS, KNOWN ISSUES

48       This is a list of systems that "IO::Tty" seems to work on ('make test'
49       passes) with comments about "features":
50
51       ·   AIX 4.3
52
53           Returns EIO instead of EOF when the slave is closed.  Benign.
54
55       ·   AIX 5.x
56
57       ·   FreeBSD 4.4
58
59           EOF on the slave tty is not reported back to the master.
60
61       ·   OpenBSD 2.8
62
63           The ioctl TIOCSCTTY sometimes fails.  This is also known in
64           Tcl/Expect, see http://expect.nist.gov/FAQ.html
65
66           EOF on the slave tty is not reported back to the master.
67
68       ·   Darwin 7.9.0
69
70       ·   HPUX 10.20 & 11.00
71
72           EOF on the slave tty is not reported back to the master.
73
74       ·   IRIX 6.5
75
76       ·   Linux 2.2.x & 2.4.x
77
78           Returns EIO instead of EOF when the slave is closed.  Benign.
79
80       ·   OSF 4.0
81
82           EOF on the slave tty is not reported back to the master.
83
84       ·   Solaris 8, 2.7, 2.6
85
86           Has the "feature" of returning EOF just once?!
87
88           EOF on the slave tty is not reported back to the master.
89
90       ·   Windows NT/2k/XP (under Cygwin)
91
92           When you send (print) a too long line (>160 chars) to a non-raw
93           pty, the call just hangs forever and even alarm() cannot get you
94           out.  Don't complain to me...
95
96           EOF on the slave tty is not reported back to the master.
97
98       ·   z/OS
99
100       The following systems have not been verified yet for this version, but
101       a previous version worked on them:
102
103       ·   SCO Unix
104
105       ·   NetBSD
106
107           probably the same as the other *BSDs...
108
109       If you have additions to these lists, please mail them to
110       <RGiersig@cpan.org>.
111

MAILING LISTS

116       As this module is mainly used by Expect, support for it is available
117       via the two Expect mailing lists, expectperl-announce and expectperl-
118       discuss, at
119
120         http://lists.sourceforge.net/lists/listinfo/expectperl-announce
121
122       and
123
124         http://lists.sourceforge.net/lists/listinfo/expectperl-discuss
125

AUTHORS

127       Originally by Graham Barr <gbarr@pobox.com>, based on the Ptty module
128       by Nick Ing-Simmons <nik@tiuk.ti.com>.
129
130       Now maintained and heavily rewritten by Roland Giersig
131       <RGiersig@cpan.org>.
132
133       Contains copyrighted stuff from openssh v3.0p1, authored by Tatu Ylonen
134       <ylo@cs.hut.fi>, Markus Friedl and Todd C. Miller
135       <Todd.Miller@courtesan.com>.  I also got a lot of inspiry from the pty
136       code in Xemacs.
137

COPYRIGHT

139       Now all code is free software; you can redistribute it and/or modify it
140       under the same terms as Perl itself.
141
142       Nevertheless the above AUTHORS retain their copyrights to the various
143       parts and want to receive credit if their source code is used.  See the
144       source for details.
145

DISCLAIMER

147       THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
148       WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
149       MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
150       IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
151       INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
152       BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
153       OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
154       ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
155       TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
156       USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
157       DAMAGE.
158
159       In other words: Use at your own risk.  Provided as is.  Your mileage
160       may vary.  Read the source, Luke!
161
162       And finally, just to be sure:
163
164       Any Use of This Product, in Any Manner Whatsoever, Will Increase the
165       Amount of Disorder in the Universe. Although No Liability Is Implied
166       Herein, the Consumer Is Warned That This Process Will Ultimately Lead
167       to the Heat Death of the Universe.
168
169
170
171perl v5.16.3                      2010-10-11                            Tty(3)