x11::protocol::connection(3pm) [debian man page]

Protocol::Connection(3pm)				User Contributed Perl Documentation				 Protocol::Connection(3pm)

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

perl v5.14.2							    2003-01-27						 Protocol::Connection(3pm)

Auth(3pm)						User Contributed Perl Documentation						 Auth(3pm)

NAME

       X11::Auth - Perl module to read X11 authority files

SYNOPSIS

	 require X11::Auth;
	 $a = new X11::Auth;
	 ($auth_type, $auth_data) = $a->get_by_host($host, $disp_num);

DESCRIPTION

       This module is an approximate perl replacement for the libXau C library and the xauth(1) program. It reads and interprets the files
       (usually '~/.Xauthority') that hold authorization data used in connecting to X servers. Since it was written mainly for the use of
       X11::Protocol, its functionality is currently restricted to reading, not writing, of these files.

METHODS

   new
	 $auth = X11::Auth->new;
	 $auth = X11::Auth->open($filename);

       Open an authority file, and create an object to handle it. The filename will be taken from the XAUTHORITY environment variable, if present,
       or '.Xauthority' in the user's home directory, or it may be overridden by an argument. 'open' may be used as a synonym.

   get_one
	 ($family, $host_addr, $display_num, $auth_name, $auth_data)
	    = $auth->get_one;

       Read one entry from the file. Returns a null list at end of file.  $family is usually 'Internet' or 'Local', and $display_num can be any
       string.

   get_all
	 @auth_data = $auth->get_all;

       Read all of the entries in the file. Each member of the array returned is an array ref similar to the list returned by get_one().

   get_by_host
	 ($auth_name, $auth_data)
	    = $auth->get_by_host($host, $family, $display_num);

       Get authentication data for a connection of type $family to display $display_num on $host. If $family is 'Internet', the host will be
       translated into an appropriate address by gethostbyname(). If no data is found, returns an empty list.

COMPATIBILITY

       The following table shows the (rough) correspondence between libXau calls and X11::Auth methods:

	 libXau 		    X11::Auth
	 ------ 		    ---------
	 XauFileName		    $ENV{XAUTHORITY}
				    || "$ENV{HOME}/.Xauthority"
	 fopen(XauFileName(), "rb") $auth = new X11::Auth
	 XauReadAuth		    $auth->get_one
	 XauWriteAuth
	 XauGetAuthByAddr	    $auth->get_by_host
	 XauGetBestAuthByAddr
	 XauLockAuth
	 XauUnlockAuth
	 XauDisposeAuth

AUTHOR

       Stephen McCamant <SMCCAM@cpan.org>

SEE ALSO

       perl(1), X11::Protocol, Xau(3), xauth(1), lib/Xau/README in the X11 source distribution.

perl v5.14.2							    2006-01-19								 Auth(3pm)