doc/pod/ident.pod

   1 =head1 NAME
   2
   3 ident - nnrpd ident resolver
   4
   5 =head1 SYNOPSIS
   6
   7 B<ident> [B<-p> I<port>] [B<-t>]
   8
   9 =head1 DESCRIPTION
  10
  11 This program attempts to resolve usernames for B<nnrpd> by using the
  12 ident protocol to query the remote host.  It contacts the remote host
  13 using either IPv4 or IPv6 depending on which protocol was used for the
  14 incoming NNTP connection.
  15
  16 =head1 OPTIONS
  17
  18 =over 4
  19
  20 =item B<-p> I<port>
  21
  22 If this option is given, attempt to contact identd on the specified
  23 remote port (which can be a numeric or symbolic specification).
  24 Non-numeric values will be looked up using getservbyname(3).  The
  25 default value is the result of C<getservbyname("ident")> if available,
  26 or port 113 otherwise.
  27
  28 =item B<-t>
  29
  30 If this option is given, the identity returned will never have a domain
  31 part.  That is, if the remote server returns a result containing an C<@>
  32 character, B<ident> truncates the response at the C<@>.  This is useful
  33 to allow the I<default-domain> parameter in F<reaers.conf> to override
  34 the domain supplied by the remote host (particularly if the supplied
  35 domain part is an unqualified local machine name rather than a full
  36 domain name).
  37
  38 =back
  39
  40 =head1 EXAMPLE
  41
  42 The following readers.conf(5) fragment tells nnrpd to trust ident
  43 information for hosts on a local network, but to replace the domain
  44 returned from the ident query:
  45
  46     auth LAN {
  47         hosts: "192.168/16"
  48         res: "ident -t"
  49         default-domain: "internal.example.com"
  50     }
  51
  52     access LAN {
  53         users: "*@internal.example.com"
  54         newsgroups: example.*
  55     }
  56
  57 Access is granted to the example.* groups for all users on the local
  58 network whose machines respond to ident queries.
  59
  60 =head1 HISTORY
  61
  62 This documentation was written by Jeffrey M. Vinocur <jeff@litech.org>.
  63
  64 $Id: ident.pod 5988 2002-12-12 23:02:14Z vinocur $
  65
  66 =head1 SEE ALSO
  67
  68 nnrpd(8), readers.conf(5)
  69
  70 =cut