home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _2a5ab90f09f8108afa5ba55939df0c85 < prev    next >
Text File  |  2000-03-23  |  5KB  |  129 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <UL>
  26.  
  27.         <LI><A HREF="#open">open</A></LI>
  28.         <LI><A HREF="#give">give</A></LI>
  29.         <LI><A HREF="#get">get</A></LI>
  30.         <LI><A HREF="#fh">fh</A></LI>
  31.     </UL>
  32.  
  33.     <LI><A HREF="#author">AUTHOR</A></LI>
  34.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  35. </UL>
  36. <!-- INDEX END -->
  37.  
  38. <HR>
  39. <P>
  40. <H1><A NAME="name">NAME</A></H1>
  41. <P>X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections</P>
  42. <P>
  43. <HR>
  44. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  45. <UL>
  46. <LI>Linux</LI>
  47. <LI>Solaris</LI>
  48. </UL>
  49. <HR>
  50. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  51. <PRE>
  52.   # In connection object module
  53.   package X11::Protocol::Connection::CarrierPigeon;
  54.   use X11::Protocol::Connection;
  55.   @ISA = ('X11::Protocol::Connection');
  56.   sub open { ... }
  57.   sub give { ... }
  58.   sub get { ... }
  59.   sub fh { ... }
  60.   ...</PRE>
  61. <PRE>
  62.   # In program
  63.   $connection = X11::Protocol::Connection::CarrierPigeon
  64.     ->open($host, $display_number);
  65.   $x = X11::Protocol->new($connection);</PRE>
  66. <PRE>
  67.   $connection->give($data);</PRE>
  68. <PRE>
  69.   $reply = unpack("I", $connection->get(4));</PRE>
  70. <PRE>
  71.   use IO::Select;
  72.   $sel = IO::select->new($connection->fh);
  73.   if ($sel->can_read == $connection->fh) ...</PRE>
  74. <P>
  75. <HR>
  76. <H1><A NAME="description">DESCRIPTION</A></H1>
  77. <P>This module is an abstract base class for the various
  78. X11::Protocol::Connection::* modules that provide connections to X
  79. servers for the X11::Protocol module. It provides stubs for the
  80. following methods:</P>
  81. <P>
  82. <H2><A NAME="open">open</A></H2>
  83. <PRE>
  84.   $conn = X11::Protocol::Connection::Foo->open($host, $display_num)</PRE>
  85. <P>Open a connection to the specified display (numbered from 0) on the
  86. specified $host.</P>
  87. <P>
  88. <H2><A NAME="give">give</A></H2>
  89. <PRE>
  90.   $conn->give($data)</PRE>
  91. <P>Send the given data to the server. Normally, this method is used only
  92. by the protocol module itself.</P>
  93. <P>
  94. <H2><A NAME="get">get</A></H2>
  95. <PRE>
  96.   $data = $conn->get($n)</PRE>
  97. <P>Read $n bytes of data from the server. Normally, this method is used
  98. only by the protocol module itself.</P>
  99. <P>
  100. <H2><A NAME="fh">fh</A></H2>
  101. <PRE>
  102.   $filehandle = $conn->fh</PRE>
  103. <P>Return an object suitable for use as a filehandle. This is mainly
  104. useful for doing <A HREF="../../../../lib/Pod/perlfunc.html#item_select"><CODE>select()</CODE></A> and other such system calls.</P>
  105. <P>
  106. <HR>
  107. <H1><A NAME="author">AUTHOR</A></H1>
  108. <P>Stephen McCamant <<A HREF="mailto:alias@mcs.com">alias@mcs.com</A>>.</P>
  109. <P>
  110. <HR>
  111. <H1><A NAME="see also">SEE ALSO</A></H1>
  112. <P><EM>perl(1)</EM>,
  113. <A HREF="../../../../site/lib/X11/Protocol.html">the X11::Protocol manpage</A>,
  114. <A HREF="../../../../site/lib/X11/Protocol/Connection/Socket.html">the X11::Protocol::Connection::Socket manpage</A>,
  115. <A HREF="../../../../site/lib/X11/Protocol/Connection/FileHandle.html">the X11::Protocol::Connection::FileHandle manpage</A>,
  116. <A HREF="../../../../site/lib/X11/Protocol/Connection/INETSocket.html">the X11::Protocol::Connection::INETSocket manpage</A>,
  117. <A HREF="../../../../site/lib/X11/Protocol/Connection/UNIXSocket.html">the X11::Protocol::Connection::UNIXSocket manpage</A>,
  118. <A HREF="../../../../site/lib/X11/Protocol/Connection/INETFH.html">the X11::Protocol::Connection::INETFH manpage</A>,
  119. <A HREF="../../../../site/lib/X11/Protocol/Connection/UNIXFH.html">the X11::Protocol::Connection::UNIXFH manpage</A>.</P>
  120. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  121. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  122. <STRONG><P CLASS=block> X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections</P></STRONG>
  123. </TD></TR>
  124. </TABLE>
  125.  
  126. </BODY>
  127.  
  128. </HTML>
  129.