.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
.\" ========================================================================
.de Sh \" Subsection heading
.de Sp \" Vertical space (when we can't use .PP)
.de Vb \" Begin verbatim text
.de Ve \" End verbatim text
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. | will give a
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
. tm Index:\\$1\t\\n%\t"\\$2"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. \" simple accents for nroff and troff
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
.\" ========================================================================
.TH Tty 3 "2002-04-02" "perl v5.8.0" "User Contributed Perl Documentation"
IO::Tty \- Low\-level allocate a pseudo\-Tty, import constants.
\& use IO::Tty qw(TIOCNOTTY);
\& # use only to import constants, see IO::Pty to create ptys.
\&\f(CW\*(C`IO::Tty\*(C'\fR is used internally by \f(CW\*(C`IO::Pty\*(C'\fR to create a pseudo\-tty.
You wouldn't want to use it directly except to import constants, use
\&\f(CW\*(C`IO::Pty\*(C'\fR. For a list of importable constants, see
Windows is now supported, not natively but under the Cygwin
environment, see <http://sources.redhat.com/cygwin/>.
Please note that pty creation is very system\-dependend. From my
experience, any modern \s-1POSIX\s0 system should be fine. Find below a list
of systems that \f(CW\*(C`IO::Tty\*(C'\fR should work on. A more detailed table 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
\&\*(L"verified\*(R" 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 \f(CW\*(C`IO::Tty\*(C'\fR,
do a \f(CW'perl Makefile.PL; make; make test; uname \-a'\fR and send me
(\fIRGiersig@cpan.org\fR) 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. \f(CW'uname \-a'\fR is a good
start) so I can get an overview. Thanks!
.SH "VERIFIED SYSTEMS, KNOWN ISSUES"
.IX Header "VERIFIED SYSTEMS, KNOWN ISSUES"
This is a list of systems that \f(CW\*(C`IO::Tty\*(C'\fR seems to work on ('make
test' passes) with comments about \*(L"features\*(R":
.IP "\(bu \s-1AIX\s0 4.3" 4
Returns \s-1EIO\s0 instead of \s-1EOF\s0 when the slave is closed. Benign.
\&\s-1EOF\s0 on the slave tty is not reported back to the master.
The ioctl \s-1TIOCSCTTY\s0 sometimes fails. This is also known in
Tcl/Expect, see http://expect.nist.gov/FAQ.html
\&\s-1EOF\s0 on the slave tty is not reported back to the master.
.IP "\(bu \s-1HPUX\s0 10.20 & 11.00" 4
.IX Item "HPUX 10.20 & 11.00"
\&\s-1EOF\s0 on the slave tty is not reported back to the master.
.IP "\(bu \s-1IRIX\s0 6.5" 4
.IP "\(bu Linux 2.2.x & 2.4.x" 4
.IX Item "Linux 2.2.x & 2.4.x"
Returns \s-1EIO\s0 instead of \s-1EOF\s0 when the slave is closed. Benign.
.IP "\(bu \s-1OSF\s0 4.0" 4
\&\s-1EOF\s0 on the slave tty is not reported back to the master.
.IP "\(bu Solaris 8, 2.7, 2.6" 4
.IX Item "Solaris 8, 2.7, 2.6"
Has the \*(L"feature\*(R" of returning \s-1EOF\s0 just once?!
\&\s-1EOF\s0 on the slave tty is not reported back to the master.
.IP "\(bu Windows NT/2k (under Cygwin)" 4
.IX Item "Windows NT/2k (under Cygwin)"
When you send (print) a too long line (>160 chars) to a non-raw pty,
the call just hangs forever and even \fIalarm()\fR cannot get you out.
\&\s-1EOF\s0 on the slave tty is not reported back to the master.
The following systems have not been verified yet for this version, but
a previous version worked on them:
.IP "\(bu \s-1SCO\s0 Unix" 4
probably the same as the other *BSDs...
If you have additions to these lists, please mail them to
<\fIRGiersig@cpan.org\fR>.
IO::Pty, IO::Tty::Constant
.IX Header "MAILING LISTS"
As this module is mainly used by Expect, support for it is available
via the two Expect mailing lists, expectperl-announce and
\& http://lists.sourceforge.net/lists/listinfo/expectperl-announce
\& http://lists.sourceforge.net/lists/listinfo/expectperl-discuss
Originally by Graham Barr <\fIgbarr@pobox.com\fR>, based on the
Ptty module by Nick Ing-Simmons <\fInik@tiuk.ti.com\fR>.
Now maintained and heavily rewritten by Roland Giersig
<\fIRGiersig@cpan.org\fR>.
Contains copyrighted stuff from openssh v3.0p1, authored by Tatu
Ylonen <ylo@cs.hut.fi>, Markus Friedl and Todd C. Miller
<Todd.Miller@courtesan.com>. I also got a lot of inspiry from the pty
Now all code is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.
Nevertheless the above \s-1AUTHORS\s0 retain their copyrights to the various
parts and want to receive credit if their source code is used.
See the source for details.
\&\s-1THIS\s0 \s-1SOFTWARE\s0 \s-1IS\s0 \s-1PROVIDED\s0 ``\s-1AS\s0 \s-1IS\s0'' \s-1AND\s0 \s-1ANY\s0 \s-1EXPRESS\s0 \s-1OR\s0 \s-1IMPLIED\s0
\&\s-1WARRANTIES\s0, \s-1INCLUDING\s0, \s-1BUT\s0 \s-1NOT\s0 \s-1LIMITED\s0 \s-1TO\s0, \s-1THE\s0 \s-1IMPLIED\s0 \s-1WARRANTIES\s0 \s-1OF\s0
\&\s-1MERCHANTABILITY\s0 \s-1AND\s0 \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0 \s-1ARE\s0 \s-1DISCLAIMED\s0.
\&\s-1IN\s0 \s-1NO\s0 \s-1EVENT\s0 \s-1SHALL\s0 \s-1THE\s0 \s-1AUTHORS\s0 \s-1BE\s0 \s-1LIABLE\s0 \s-1FOR\s0 \s-1ANY\s0 \s-1DIRECT\s0, \s-1INDIRECT\s0,
\&\s-1INCIDENTAL\s0, \s-1SPECIAL\s0, \s-1EXEMPLARY\s0, \s-1OR\s0 \s-1CONSEQUENTIAL\s0 \s-1DAMAGES\s0 (\s-1INCLUDING\s0,
\&\s-1BUT\s0 \s-1NOT\s0 \s-1LIMITED\s0 \s-1TO\s0, \s-1PROCUREMENT\s0 \s-1OF\s0 \s-1SUBSTITUTE\s0 \s-1GOODS\s0 \s-1OR\s0 \s-1SERVICES\s0; \s-1LOSS\s0
\&\s-1OF\s0 \s-1USE\s0, \s-1DATA\s0, \s-1OR\s0 \s-1PROFITS\s0; \s-1OR\s0 \s-1BUSINESS\s0 \s-1INTERRUPTION\s0) \s-1HOWEVER\s0 \s-1CAUSED\s0 \s-1AND\s0
\&\s-1ON\s0 \s-1ANY\s0 \s-1THEORY\s0 \s-1OF\s0 \s-1LIABILITY\s0, \s-1WHETHER\s0 \s-1IN\s0 \s-1CONTRACT\s0, \s-1STRICT\s0 \s-1LIABILITY\s0, \s-1OR\s0
\&\s-1TORT\s0 (\s-1INCLUDING\s0 \s-1NEGLIGENCE\s0 \s-1OR\s0 \s-1OTHERWISE\s0) \s-1ARISING\s0 \s-1IN\s0 \s-1ANY\s0 \s-1WAY\s0 \s-1OUT\s0 \s-1OF\s0 \s-1THE\s0
\&\s-1USE\s0 \s-1OF\s0 \s-1THIS\s0 \s-1SOFTWARE\s0, \s-1EVEN\s0 \s-1IF\s0 \s-1ADVISED\s0 \s-1OF\s0 \s-1THE\s0 \s-1POSSIBILITY\s0 \s-1OF\s0 \s-1SUCH\s0
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.
projects / OpenSPARC-T2-DV / blob