home *** CD-ROM | disk | FTP | other *** search
-
- <HTML>
- <HEAD>
- <TITLE>X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections</TITLE>
- <LINK REL="stylesheet" HREF="../../../../Active.css" TYPE="text/css">
- <LINK REV="made" HREF="mailto:">
- </HEAD>
-
- <BODY>
- <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
- <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
- <STRONG><P CLASS=block> X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections</P></STRONG>
- </TD></TR>
- </TABLE>
-
- <A NAME="__index__"></A>
- <!-- INDEX BEGIN -->
-
- <UL>
-
- <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
-
- <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
- <LI><A HREF="#description">DESCRIPTION</A></LI>
- <UL>
-
- <LI><A HREF="#open">open</A></LI>
- <LI><A HREF="#give">give</A></LI>
- <LI><A HREF="#get">get</A></LI>
- <LI><A HREF="#fh">fh</A></LI>
- </UL>
-
- <LI><A HREF="#author">AUTHOR</A></LI>
- <LI><A HREF="#see also">SEE ALSO</A></LI>
- </UL>
- <!-- INDEX END -->
-
- <HR>
- <P>
- <H1><A NAME="name">NAME</A></H1>
- <P>X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections</P>
- <P>
- <HR>
- <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
- <UL>
- <LI>Linux</LI>
- <LI>Solaris</LI>
- </UL>
- <HR>
- <H1><A NAME="synopsis">SYNOPSIS</A></H1>
- <PRE>
- # 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 { ... }
- ...</PRE>
- <PRE>
- # In program
- $connection = X11::Protocol::Connection::CarrierPigeon
- ->open($host, $display_number);
- $x = X11::Protocol->new($connection);</PRE>
- <PRE>
- $connection->give($data);</PRE>
- <PRE>
- $reply = unpack("I", $connection->get(4));</PRE>
- <PRE>
- use IO::Select;
- $sel = IO::select->new($connection->fh);
- if ($sel->can_read == $connection->fh) ...</PRE>
- <P>
- <HR>
- <H1><A NAME="description">DESCRIPTION</A></H1>
- <P>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:</P>
- <P>
- <H2><A NAME="open">open</A></H2>
- <PRE>
- $conn = X11::Protocol::Connection::Foo->open($host, $display_num)</PRE>
- <P>Open a connection to the specified display (numbered from 0) on the
- specified $host.</P>
- <P>
- <H2><A NAME="give">give</A></H2>
- <PRE>
- $conn->give($data)</PRE>
- <P>Send the given data to the server. Normally, this method is used only
- by the protocol module itself.</P>
- <P>
- <H2><A NAME="get">get</A></H2>
- <PRE>
- $data = $conn->get($n)</PRE>
- <P>Read $n bytes of data from the server. Normally, this method is used
- only by the protocol module itself.</P>
- <P>
- <H2><A NAME="fh">fh</A></H2>
- <PRE>
- $filehandle = $conn->fh</PRE>
- <P>Return an object suitable for use as a filehandle. This is mainly
- useful for doing <A HREF="../../../../lib/Pod/perlfunc.html#item_select"><CODE>select()</CODE></A> and other such system calls.</P>
- <P>
- <HR>
- <H1><A NAME="author">AUTHOR</A></H1>
- <P>Stephen McCamant <<A HREF="mailto:alias@mcs.com">alias@mcs.com</A>>.</P>
- <P>
- <HR>
- <H1><A NAME="see also">SEE ALSO</A></H1>
- <P><EM>perl(1)</EM>,
- <A HREF="../../../../site/lib/X11/Protocol.html">the X11::Protocol manpage</A>,
- <A HREF="../../../../site/lib/X11/Protocol/Connection/Socket.html">the X11::Protocol::Connection::Socket manpage</A>,
- <A HREF="../../../../site/lib/X11/Protocol/Connection/FileHandle.html">the X11::Protocol::Connection::FileHandle manpage</A>,
- <A HREF="../../../../site/lib/X11/Protocol/Connection/INETSocket.html">the X11::Protocol::Connection::INETSocket manpage</A>,
- <A HREF="../../../../site/lib/X11/Protocol/Connection/UNIXSocket.html">the X11::Protocol::Connection::UNIXSocket manpage</A>,
- <A HREF="../../../../site/lib/X11/Protocol/Connection/INETFH.html">the X11::Protocol::Connection::INETFH manpage</A>,
- <A HREF="../../../../site/lib/X11/Protocol/Connection/UNIXFH.html">the X11::Protocol::Connection::UNIXFH manpage</A>.</P>
- <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
- <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
- <STRONG><P CLASS=block> X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections</P></STRONG>
- </TD></TR>
- </TABLE>
-
- </BODY>
-
- </HTML>
-