git.sur5r.net Git - openldap/blob - doc/man/man8/in.xfingerd.8

   1 .TH IN.XFINGERD 8C "20 August 2000" "OpenLDAP LDVERSION"
   2 .\" $OpenLDAP$
   3 .\" Copyright 1998-2002 The OpenLDAP Foundation All Rights Reserved.
   4 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   5 .SH NAME
   6 in.xfingerd \- Finger to LDAP/X.500 gateway daemon
   7 .SH SYNOPSIS
   8 .B LIBEXECDIR/in.xfingerd [\-f filterfile] [\-i]
   9 .B [\-l] [\-t templatefile] [\-c rdncount] [\-x hostname]
  10 .B [\-b searchbase] [\-p port]
  11 .SH DESCRIPTION
  12 .B in.xfingerd
  13 is the LDAP/X.500 finger daemon.  It runs from
  14 .BR inetd (8)
  15 and translates
  16 finger queries into LDAP queries or X.500 queries via LDAP.
  17 It also understands
  18 UFN-style names, so fingering something like "tim howes,umich,us@hostname"
  19 will do a UFN search.
  20 .LP
  21 To arrange to have in.xfingerd started from inetd
  22 add a line like this to your
  23 .BR /etc/inetd.conf (5)
  24 file, or the equivalent:
  25 .LP
  26 .nf
  27 .ft tt
  28     finger stream tcp nowait nobody LIBEXECDIR/in.xfingerd in.xfingerd
  29 .ft
  30 .fi
  31 .LP
  32 For these changes to take effect with inetd, you will probably have
  33 to send it it a HUP signal.  See
  34 .BR inetd (8)
  35 for more details.
  36 .SH OPTIONS
  37 .TP
  38 .BI \-f " filterfile"
  39 Specify an alternate filter configuration file for use with the
  40 .BR ldap_getfilter (3)
  41 facility, used by
  42 .BR in.xfingerd .
  43 .TP
  44 .B \-i
  45 Run in interactive mode.  With this flag in.xfingerd can be
  46 run from a terminal in "one shot" mode, reading the finger
  47 request from standard input.  This is useful for debugging.
  48 .TP
  49 .B \-l
  50 Disable logging of various status and errors to the LOG_LOCAL4 facility via
  51 .BR syslog (8).
  52 Note that this flag turns OFF logging.  The default is on.
  53 .TP
  54 .BI \-t " templatefile"
  55 Specify an alternate template configuration file for use with the
  56 .BR ldap_init_templates (3)
  57 facility, used by
  58 BR in.xfingerd .
  59 .TP
  60 .BI \-c " rdncount"
  61 Specify the number of DN components to show for the names and DN attributes
  62 within entries matching the search.
  63 .TP
  64 .BI \-x " hostname"
  65 Specify an alternate host on which the ldap server is running.
  66 .TP
  67 .BI \-p " port"
  68 Specify an alternate port on which the ldap server is listening.
  69 .TP
  70 .BI \-b " searchbase"
  71 Specify an alternate search base for queries.
  72 .SH NOTES
  73 The default values for most of the things you can specify with
  74 options are configured at compile time in the
  75 .B include/ldapconfig.h.edit
  76 include file.  Also included there are various messages displayed
  77 by the finger daemon when finding no matches, encountering errors, etc.
  78 You should configure
  79 .B ldapconfig.h.edit
  80 for your site.
  81 .SH "SEE ALSO"
  82 .BR finger (1)
  83 .BR ldap (3),
  84 .BR ldap_getfilter (3),
  85 .BR inetd (8),
  86 .SH ACKNOWLEDGEMENTS
  87 .B      OpenLDAP
  88 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
  89 .B      OpenLDAP
  90 is derived from University of Michigan LDAP 3.3 Release.