X11::Protocol::Connection(3pm)

X11::Protocol::Connection3pm

Perl module abstract base class for x11 client to server connections

Usage

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

Overview

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.

Releases

12 releases since Debian 3.1 (Sarge); the text changed 8 times.

  1. 3.1
  2. 4.0
  3. 5.0–6.0
  4. 7
  5. 8
  6. 9–10
  7. 11
  8. 12–13
  9. Arch

Author

Stephen McCamant <[email protected]>.

From perl-x11-protocol 0.56-18 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.