NAME
      Net::Ident - lookup the username on the remote end of a
      TCP/IP connection

SYNOPSIS
       use Net::Ident;

       $username = Net::Ident::lookup(SOCKET, $timeout);

       $username = Net::Ident::lookupFromInAddr($localsockaddr,
                                                 $remotesockaddr, $timeout);

       $obj = Net::Ident->new(SOCKET, $timeout);
       $obj = Net::Ident->newFromInAddr($localsockaddr, $remotesockaddr,
                                              $timeout);
       $status = $obj->query;
       $status = $obj->ready;
       $username = $obj->username;
       ($username, $opsys, $error) = $obj->username;
       $fh = $obj->getfh;
       $txt = $obj->geterror;

       use Net::Ident 'ident_lookup';

       $username = ident_lookup(SOCKET, $timeout);

       use Net::Ident 'lookupFromInAddr';

       $username = lookupFromInAddr($localsockaddr, $remotesockaddr, $timeout);

       use Net::Ident ':fh';

       $username = SOCKET->ident_lookup($timeout);

       use Net::Ident ':apache';

       # my Apache $r;
       $c = $r->connection;
       $username = $c->ident_lookup($timeout);


OVERVIEW
      Net::Ident is a module that looks up the username on the
      remote side of a TCP/IP connection through the ident
      (auth/tap) protocol described in RFC1413 (which supersedes
      RFC931). Note that this requires the remote site to run a
      daemon (often called identd) to provide the requested
      information, so it is not always available for all TCP/IP
      connections.