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