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

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