---
name: "X11::Protocol::Connection"
section: "3pm"
platform: "linux"
package: "perl-x11-protocol"
version: "0.56-18"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/X11::Protocol::Connection"
---

# X11::Protocol::Connection(3pm)

Perl module abstract base class for X11 client to server connections

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

## AUTHOR

Stephen McCamant \<SMCCAM@cpan.org\>.

## SEE ALSO

[**perl**(1)](/perl/1.md), X11::Protocol, X11::Protocol::Connection::Socket, X11::Protocol::Connection::FileHandle, X11::Protocol::Connection::INETSocket, X11::Protocol::Connection::UNIXSocket, X11::Protocol::Connection::INETFH, X11::Protocol::Connection::UNIXFH.