README
1NAME
2 Net::Ident - lookup the username on the remote end of a
3 TCP/IP connection
4
5SYNOPSIS
6 use Net::Ident;
7
8 $username = Net::Ident::lookup(SOCKET, $timeout);
9
10 $username = Net::Ident::lookupFromInAddr($localsockaddr,
11 $remotesockaddr, $timeout);
12
13 $obj = Net::Ident->new(SOCKET, $timeout);
14 $obj = Net::Ident->newFromInAddr($localsockaddr, $remotesockaddr,
15 $timeout);
16 $status = $obj->query;
17 $status = $obj->ready;
18 $username = $obj->username;
19 ($username, $opsys, $error) = $obj->username;
20 $fh = $obj->getfh;
21 $txt = $obj->geterror;
22
23 use Net::Ident 'ident_lookup';
24
25 $username = ident_lookup(SOCKET, $timeout);
26
27 use Net::Ident 'lookupFromInAddr';
28
29 $username = lookupFromInAddr($localsockaddr, $remotesockaddr, $timeout);
30
31 use Net::Ident ':fh';
32
33 $username = SOCKET->ident_lookup($timeout);
34
35 use Net::Ident ':apache';
36
37 # my Apache $r;
38 $c = $r->connection;
39 $username = $c->ident_lookup($timeout);
40
41
42OVERVIEW
43 Net::Ident is a module that looks up the username on the
44 remote side of a TCP/IP connection through the ident
45 (auth/tap) protocol described in RFC1413 (which supersedes
46 RFC931). Note that this requires the remote site to run a
47 daemon (often called identd) to provide the requested
48 information, so it is not always available for all TCP/IP
49 connections.
50