NAME

DBGp::Client::Listener - wait for incoming DBGp connections

SYNOPSIS

            

              
              
$listener = DBGp::Client::Listener->new(
    port    => 9000,
);
$listener->listen;
$connection = $listener->accept;
# use the methods in the DBGp::Client::Connection object
            
          

DESCRIPTION

The main entry point for DBGp::Client: listens for incoming debugger connections and returns a DBGp::Client::Connection object.

METHODS

new

            

              
              
my $listener = DBGp::Client::Listener->new(%opts);
            
          

Possible options are port to specify a TCP port, and path to specify the path for an Unix-domain socket.

For Unix-domain socket, passing mode performs an additional chmod call before starting to listen for connections.

listen

            

              
              
$listener->listen;
            
          

Starts listening on the endpoint specified to the constructor; die()s if there is an error.

accept

            

              
              
my $connection = $listener->accept;
            
          

Waits for an incoming debugger connection and returns a fully-initialized DBGp::Client::Connection object; it calls "parse_init" in DBGp::Client::Connection on the connection object to read and parse the initialization message.

AUTHOR

Mattia Barbon <mbarbon@cpan.org>

LICENSE

Copyright (c) 2015 Mattia Barbon. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.