Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Tty(3)		      User Contributed Perl Documentation		Tty(3)

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

VERSION
       1.16

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
       (RGiersig@cpan.org) 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":

       o   AIX 4.3

	   Returns EIO instead of EOF when the slave is	closed.	 Benign.

       o   AIX 5.x

       o   FreeBSD 4.4

	   EOF on the slave tty	is not reported	back to	the master.

       o   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.

       o   Darwin 7.9.0

       o   HPUX	10.20 &	11.00

	   EOF on the slave tty	is not reported	back to	the master.

       o   IRIX	6.5

       o   Linux 2.2.x & 2.4.x

	   Returns EIO instead of EOF when the slave is	closed.	 Benign.

       o   OSF 4.0

	   EOF on the slave tty	is not reported	back to	the master.

       o   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.

       o   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.

       o   z/OS

       The following systems have not been verified yet	for this version, but
       a previous version worked on them:

       o   SCO Unix

       o   NetBSD

	   probably the	same as	the other *BSDs...

       If you have additions to	these lists, please mail them to
       <RGiersig@cpan.org>.

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 <gbarr@pobox.com>, based on the Ptty module
       by Nick Ing-Simmons <nik@tiuk.ti.com>.

       Now maintained and heavily rewritten by Roland Giersig
       <RGiersig@cpan.org>.

       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 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.

perl v5.32.1			  2021-01-22				Tty(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | VERIFIED SYSTEMS, KNOWN ISSUES | SEE ALSO | MAILING LISTS | AUTHORS | COPYRIGHT | DISCLAIMER

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=IO::Tty&sektion=3&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help