MAN page from Mandrake Other perl-X11-Protocol-0.04-1.i386.rpm

Protocol::Connection

Section: User Contributed Perl Documentation (3)
Updated: perl 5.004, patch 04
Index

NAME

X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections

SYNOPSIS

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

DESCRIPTION

This module is an abstract base class for the variousX11::Protocol::Connection::* modules that provide connections to Xservers for the X11::Protocol module. It provides stubs for thefollowing methods:

open

  $conn = X11::Protocol::Connection::Foo->open($host, $display_num)

Open a connection to the specified display (numbered from 0) on thespecified $host.

give

  $conn->give($data)

Send the given data to the server. Normally, this method is used onlyby the protocol module itself.

get

  $data = $conn->get($n)

Read $n bytes of data from the server. Normally, this method is usedonly by the protocol module itself.

  $filehandle = $conn->fh

Return an object suitable for use as a filehandle. This is mainlyuseful for doing select() and other such system calls.

AUTHOR

Stephen McCamant <aliasAATTmcs.com>.

This document was created byman2html,using the manual pages.