usr.sbin/rarpd/rarpd.8

   1 .\" @(#) $FreeBSD: src/usr.sbin/rarpd/rarpd.8,v 1.9.2.5 2002/12/01 19:19:34 dwmalone Exp $ (LBL)
   2 .\"
   3 .\" Copyright (c) 1990, 1991, 1993 The Regents of the University of
   4 .\" California. All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that: (1) source code distributions
   8 .\" retain the above copyright notice and this paragraph in its entirety, (2)
   9 .\" distributions including binary code include the above copyright notice and
  10 .\" this paragraph in its entirety in the documentation or other materials
  11 .\" provided with the distribution, and (3) all advertising materials mentioning
  12 .\" features or use of this software display the following acknowledgement:
  13 .\" ``This product includes software developed by the University of California,
  14 .\" Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
  15 .\" the University nor the names of its contributors may be used to endorse
  16 .\" or promote products derived from this software without specific prior
  17 .\" written permission.
  18 .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  19 .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  20 .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  21 .\"
  22 .Dd November 16, 2001
  23 .Dt RARPD 8
  24 .Os
  25 .Sh NAME
  26 .Nm rarpd
  27 .Nd reverse ARP daemon
  28 .Sh SYNOPSIS
  29 .Nm
  30 .Op Fl adfsv
  31 .Op Fl t Ar directory
  32 .Op Ar interface
  33 .Sh DESCRIPTION
  34 The
  35 .Nm
  36 utility services Reverse ARP requests on the Ethernet connected to
  37 .Ar interface .
  38 Upon receiving a request,
  39 .Nm
  40 maps the target hardware address to an IP address via its name, which
  41 must be present in both the
  42 .Xr ethers 5
  43 and
  44 .Xr hosts 5
  45 databases.
  46 If a host does not exist in both databases, the translation cannot
  47 proceed and a reply will not be sent.
  48 .Pp
  49 By default, a request is honored only if the server
  50 (i.e., the host that
  51 .Nm
  52 is running on)
  53 can "boot" the target; that is, a file or directory matching the glob
  54 .Pa /tftpboot/\fIipaddr\fP*
  55 exists, where
  56 .Em ipaddr
  57 is the target IP address in hex.
  58 For example, the IP address 204.216.27.18 will be replied to if any of
  59 .Pa /tftpboot/CCD81B12 ,
  60 .Pa /tftpboot/CCD81B12.SUN3 ,
  61 or
  62 .Pa /tftpboot/CCD81B12-boot
  63 exist.
  64 This requirement can be overridden with the
  65 .Fl s
  66 flag (see below).
  67 .Pp
  68 In normal operation,
  69 .Nm
  70 forks a copy of itself and runs in the background.
  71 Anomalies and errors are reported via
  72 .Xr syslog 3 .
  73 .Pp
  74 The following options are available:
  75 .Bl -tag -width indent
  76 .It Fl a
  77 Listen on all the Ethernets attached to the system.
  78 If
  79 .Fl a
  80 is omitted, an interface must be specified.
  81 .It Fl d
  82 If
  83 .Fl f
  84 is also specified,
  85 .Nm
  86 logs messages to
  87 .Em stdout
  88 and
  89 .Em stderr
  90 instead of via
  91 .Xr syslog 3 .
  92 .It Fl f
  93 Run in the foreground.
  94 .It Fl s
  95 Supply a response to any RARP request for which an ethernet to IP address
  96 mapping exists; do not depend on the existence of
  97 .Pa /tftpboot/\fIipaddr\fP* .
  98 .It Fl t
  99 Supply an alternate tftp root directory to
 100 .Pa /tftpboot ,
 101 similar to the
 102 .Fl s
 103 option of
 104 .Xr tftpd 8 .
 105 This permits
 106 .Nm
 107 to selectively respond to RARP requests, but use an alternate directory
 108 for IP checking.
 109 .It Fl v
 110 Enable verbose syslogging.
 111 .El
 112 .Sh FILES
 113 .Bl -tag -width /etc/ethers -compact
 114 .It Pa /etc/ethers
 115 .It Pa /etc/hosts
 116 .It Pa /tftpboot
 117 .El
 118 .Sh SEE ALSO
 119 .Xr bpf 4
 120 .Rs
 121 .%A "Finlayson, R."
 122 .%A "Mann, T."
 123 .%A "Mogul, J.C."
 124 .%A "Theimer, M."
 125 .%T "RFC 903: Reverse Address Resolution Protocol"
 126 .%D "June 1984"
 127 .%O "4 p"
 128 .Re
 129 .Sh AUTHORS
 130 .An -nosplit
 131 .An Craig Leres Aq leres@ee.lbl.gov
 132 and
 133 .An Steven McCanne Aq mccanne@ee.lbl.gov .
 134 Lawrence Berkeley Laboratory, University of California, Berkeley, CA.
 135 .Sh BUGS
 136 The
 137 .Nm
 138 utility can depend on the DNS to resolve the name discovered from
 139 .Pa /etc/ethers .
 140 If this name is not in the DNS but is in
 141 .Pa /etc/hosts ,
 142 the DNS lookup can cause a delayed RARP response, so in this situation
 143 it is recommended to configure
 144 .Pa /etc/host.conf
 145 to read
 146 .Pa /etc/hosts
 147 first.