/usr/share/perl5/X11/Protocol/Connection.pm is in libx11-protocol-perl 0.56-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 | #!/usr/bin/perl
package X11::Protocol::Connection;
# Copyright (C) 1997 Stephen McCamant. All rights reserved. This program
# is free software; you can redistribute and/or modify it under the same
# terms as Perl itself.
use Carp;
use strict;
use vars '$VERSION';
$VERSION = 0.01;
sub give {
croak "X11 connection object doesn't support output";
}
sub get {
croak "X11 connection object doesn't support input";
}
sub fh {
croak "X11 connection object is incompatible with perl filehandles";
}
sub open {
croak "X11 connection object can't open itself";
}
1;
__END__
=head1 NAME
X11::Protocol::Connection - Perl module abstract base class for X11 client to server connections
=head1 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) ...
=head1 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:
=head2 open
$conn = X11::Protocol::Connection::Foo->open($host, $display_num)
Open a connection to the specified display (numbered from 0) on the
specified $host.
=head2 give
$conn->give($data)
Send the given data to the server. Normally, this method is used only
by the protocol module itself.
=head2 get
$data = $conn->get($n)
Read $n bytes of data from the server. Normally, this method is used
only by the protocol module itself.
=head2 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.
=head1 AUTHOR
Stephen McCamant <SMCCAM@cpan.org>.
=head1 SEE ALSO
L<perl(1)>,
L<X11::Protocol>,
L<X11::Protocol::Connection::Socket>,
L<X11::Protocol::Connection::FileHandle>,
L<X11::Protocol::Connection::INETSocket>,
L<X11::Protocol::Connection::UNIXSocket>,
L<X11::Protocol::Connection::INETFH>,
L<X11::Protocol::Connection::UNIXFH>.
=cut
|