NAME

Pty - Perl extension to allow access to the SVR4 pseudo-tty functions

SYNOPSIS

This module may be used as follows:

   use Pty qw(ALL);
   use IO::File;
   my ($fdm) = IO::File->new("/dev/ptmx", "r+");
   grantpt($fdm);
   unlockpt($fdm);
   my ($slavename) = ptsname($fdm);
   my ($fds) = IO::File->new($slavename, "r");
   my ($mod);
   ioctl($fds, I_PUSH, $mod = "ptem");
   ioctl($fds, I_PUSH, $mod = "ldterm");

DESCRIPTION

This module allows access to the SVR4 pseudo-tty functions. grantpt() and unlockpt() follow the convention used by ioctl() for returning values, i.e. -1 is returned as undef, 0 is returned as the string "0 but true", and any other value is returned unchanged. ptsname() returns the pty name if sucessful, and undef otherwise.

constants

The following streams-related constants are available:

I_ATMARK I_CANPUT I_CKBAND I_EGETSIG I_ESETSIG I_FDINSERT I_FIND I_FLUSH I_FLUSHBAND I_GERROPT I_GETBAND I_GETCLTIME I_GETSIG I_GRDOPT I_GWROPT I_LINK I_LIST I_LOOK I_NREAD I_PEEK I_PLINK I_POP I_PUNLINK I_PUSH I_RECVFD I_SENDFD I_SERROPT I_SETCLTIME I_SETSIG I_SRDOPT I_STR I_SWROPT I_UNLINK);

grantpt()

Changes the mode and ownership of the slave pty associated with the corresponding master pty. Parameter is a filehandle.

unlockpt()

Unlocks the slave pty associated with the corresponding master pty. Parameter is a filehandle.

ptsname()

Returns the name of the slave pty associated with the corresponding master pty. Parameter is a filehandle.

COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Alan Burlison, Alan.Burlison@uk.sun.com

SEE ALSO

perl(1), grantpt(), unlockpt(), ptsname() and your O/S specific documentation for ptys