IO::Pty - Pseudo TTY object class
0.94_05 BETA
use IO::Pty; $pty = new IO::Pty; $slave = $pty->slave; foreach $val (1..10) { print $pty "$val\n"; $_ = <$slave>; print "$_"; } close($slave);
IO::Pty provides an interface to allow the creation of a pseudo tty.
IO::Pty
IO::Pty inherits from IO::Handle and so provide all the methods defined by the IO::Handle package.
IO::Handle
Please note that pty creation is very system-dependend. If you have problems, see IO::Tty for help.
The new constructor takes no arguments and returns a new file object which is the master side of the pseudo tty.
new
Returns the name of the slave pseudo tty. On UNIX machines this will be the pathname of the device. Use this name for informational purpose only, to get a slave filehandle, use slave().
The slave method will return the slave filehandle of the given master pty, opening it anew if necessary. If IO::Stty is installed, you can then call $slave->stty() to modify the terminal settings.
slave
The slave filehandle will be closed and destroyed. This is necessary in the parent after forking to get rid of the open filehandle, otherwise the parent will not notice if the child exits.
This will set the slave filehandle as the controlling terminal of the current process, which will become a session leader, so this should only be called by a child process after a fork(), e.g. in the callback to sync_exec() (see Proc::SyncExec).
IO::Tty, IO::Handle, Expect, Proc::SyncExec
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
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>.
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.
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.
To install IO::Tty, copy and paste the appropriate command in to your terminal.
cpanm
cpanm IO::Tty
CPAN shell
perl -MCPAN -e shell install IO::Tty
For more information on module installation, please visit the detailed CPAN module installation guide.