xref: /openbsd-src/usr.sbin/rarpd/rarpd.8 (revision 8fc426642614cb1b952a943be21bddf05d450176)
1*8fc42664Sjmc.\"	$OpenBSD: rarpd.8,v 1.21 2015/10/28 10:02:59 jmc Exp $
2f7d2c096Sderaadt.\"	$NetBSD: rarpd.8,v 1.7 1998/04/15 15:06:06 mrg Exp $
3cdbdb68aSaaron.\"
4df930be7Sderaadt.\" Copyright (c) 1988-1990 The Regents of the University of California.
5df930be7Sderaadt.\" All rights reserved.
6df930be7Sderaadt.\"
7df930be7Sderaadt.\" Redistribution and use in source and binary forms, with or without
8df930be7Sderaadt.\" modification, are permitted provided that: (1) source code distributions
9df930be7Sderaadt.\" retain the above copyright notice and this paragraph in its entirety, (2)
10df930be7Sderaadt.\" distributions including binary code include the above copyright notice and
11df930be7Sderaadt.\" this paragraph in its entirety in the documentation or other materials
12df930be7Sderaadt.\" provided with the distribution, and (3) all advertising materials mentioning
13df930be7Sderaadt.\" features or use of this software display the following acknowledgement:
14df930be7Sderaadt.\" ``This product includes software developed by the University of California,
15df930be7Sderaadt.\" Lawrence Berkeley Laboratory and its contributors.'' Neither the name of
16df930be7Sderaadt.\" the University nor the names of its contributors may be used to endorse
17df930be7Sderaadt.\" or promote products derived from this software without specific prior
18df930be7Sderaadt.\" written permission.
19df930be7Sderaadt.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
20df930be7Sderaadt.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
21df930be7Sderaadt.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
22*8fc42664Sjmc.\" @(#) $Id: rarpd.8,v 1.21 2015/10/28 10:02:59 jmc Exp $
23df930be7Sderaadt.\"
24*8fc42664Sjmc.Dd $Mdocdate: October 28 2015 $
25df930be7Sderaadt.Dt RARPD 8
267f3168a2Saaron.Os
27df930be7Sderaadt.Sh NAME
28df930be7Sderaadt.Nm rarpd
291c499c0bSaaron.Nd reverse ARP daemon
30df930be7Sderaadt.Sh SYNOPSIS
3143399070Saaron.Nm rarpd
32828aae0cSderaadt.Op Fl adflt
339e2d8646Sjsg.Ar if0 Op Ar ... ifN
34df930be7Sderaadt.Sh DESCRIPTION
351c499c0bSaaron.Nm
36df930be7Sderaadtservices Reverse ARP requests on the Ethernet connected to
379e2d8646Sjsgthe specified interfaces.
38df930be7SderaadtUpon receiving a request,
391c499c0bSaaron.Nm
40df930be7Sderaadtmaps the target hardware address to an IP address via its name, which
41df930be7Sderaadtmust be present in both the
42df930be7Sderaadt.Xr ethers 5
43df930be7Sderaadtand
44df930be7Sderaadt.Xr hosts 5
45df930be7Sderaadtdatabases.
46df930be7SderaadtIf a host does not exist in both databases, the translation cannot
47df930be7Sderaadtproceed and a reply will not be sent.
48df930be7Sderaadt.Pp
49df930be7SderaadtIn normal operation,
501c499c0bSaaron.Nm
51cdbdb68aSaaronforks a copy of itself and runs in the background.
52cdbdb68aSaaronAnomalies and errors are reported via
53df930be7Sderaadt.Xr syslog 3 .
541c499c0bSaaron.Pp
551c499c0bSaaronThe options are as follows:
56f1ba3473Saaron.Bl -tag -width Ds
57df930be7Sderaadt.It Fl a
58df930be7SderaadtListen on all the Ethernets attached to the system.
59df930be7SderaadtIf
601c499c0bSaaron.Fl a
619e2d8646Sjsgis omitted, a list of interfaces must be specified.
62df930be7Sderaadt.It Fl d
63df930be7SderaadtRun in debug mode, with all the output to stderr.
64df930be7SderaadtThis option implies the
65df930be7Sderaadt.Fl f
66df930be7Sderaadtoption.
67df930be7Sderaadt.It Fl f
68df930be7SderaadtRun in the foreground.
69f7d2c096Sderaadt.It Fl l
701c499c0bSaaronLog all requests to
711c499c0bSaaron.Xr syslog 3 .
72828aae0cSderaadt.It Fl t
737bd9d40cSjmcOnly honour a request if the server
747d68b7deSjmc(the host that
757d68b7deSjmc.Nm
767d68b7deSjmcis running on)
77828aae0cSderaadtcan "boot" the target; that is, if a file or directory called
787d68b7deSjmc.Pa /tftpboot/ipaddr
79828aae0cSderaadtexists, where
80828aae0cSderaadt.Pa ipaddr
812a3fa9a9Ssobradois the target IP address expressed in uppercase hexadecimal
82828aae0cSderaadt(only the first 8 characters of filenames are checked).
83df930be7Sderaadt.El
84df930be7Sderaadt.Sh FILES
85*8fc42664Sjmc.Bl -tag -width /etc/ethers -compact
86df930be7Sderaadt.It Pa /etc/ethers
877d68b7deSjmcEthernet host name database.
88df930be7Sderaadt.It Pa /etc/hosts
897d68b7deSjmcHost name database.
90df930be7Sderaadt.\" .It Pa /tftpboot
91df930be7Sderaadt.El
92df930be7Sderaadt.Sh SEE ALSO
93df930be7Sderaadt.Xr bpf 4 ,
941c499c0bSaaron.Xr diskless 8
95e8dc2910Sjmc.Sh STANDARDS
96df930be7Sderaadt.Rs
97e8dc2910Sjmc.%A R. Finlayson
98e8dc2910Sjmc.%A T. Mann
99e8dc2910Sjmc.%A J. Mogul
100e8dc2910Sjmc.%A M. Theimer
101e8dc2910Sjmc.%D June 1984
102e8dc2910Sjmc.%R RFC 903
103e8dc2910Sjmc.%T A Reverse Address Resolution Protocol
104df930be7Sderaadt.Re
105df930be7Sderaadt.Sh AUTHORS
10627e95970Sschwarze.An -nosplit
10727e95970Sschwarze.An Craig Leres Aq Mt leres@ee.lbl.gov
10827e95970Sschwarzeand
10927e95970Sschwarze.An Steven McCanne Aq Mt mccanne@ee.lbl.gov ,
110df930be7SderaadtLawrence Berkeley Laboratory, University of California, Berkeley, CA.
111