X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections # In connection object module package X11::Protocol::Connection::CarrierPigeon; use X11::Protocol::Connection; @ISA = ('X11::Protocol::Connection'); sub open { ... } sub give { ... } sub get { ... } sub fh { ... } ... # In program $connection = X11::Protocol::Connection::CarrierPigeon ->open($host, $display_number); $x = X11::Protocol->new($connection); $connection->give($data); $reply = unpack("I", $connection->get(4)); use IO::Select; $sel = IO::select->new($connection->fh); if ($sel->can_read == $connection->fh) ... This module is an abstract base class for the various X11::Protocol::Connection::* modules that provide connections to X servers for the X11::Protocol module. It provides stubs for the following methods:

open
$conn = X11::Protocol::Connection::Foo->open($host, $display_num) Open a connection to the specified display (numbered from 0) on the specified $host.

give
$conn->give($data) Send the given data to the server. Normally, this method is used only by the protocol module itself.

get
$data = $conn->get($n) Read $n bytes of data from the server. Normally, this method is used only by the protocol module itself.

fh
$filehandle = $conn->fh Return an object suitable for use as a filehandle. This is mainly useful for doing select() and other such system calls. Stephen McCamant <alias@mcs.com>. perl(1), the X11::Protocol manpage, the X11::Protocol::Connection::Socket manpage, the X11::Protocol::Connection::FileHandle manpage, the X11::Protocol::Connection::INETSocket manpage, the X11::Protocol::Connection::UNIXSocket manpage, the X11::Protocol::Connection::INETFH manpage, the X11::Protocol::Connection::UNIXFH manpage.