xref: /netbsd/usr.sbin/rarpd/rarpd.8 (revision 75d797fa)
1*75d797faSabhinav.\"	$NetBSD: rarpd.8,v 1.14 2016/12/21 12:03:48 abhinav Exp $
2e3b965f6Sderaadt.\"
3e3b965f6Sderaadt.\" Copyright (c) 1988-1990 The Regents of the University of California.
4e3b965f6Sderaadt.\" All rights reserved.
5e3b965f6Sderaadt.\"
6e3b965f6Sderaadt.\" Redistribution and use in source and binary forms, with or without
7e3b965f6Sderaadt.\" modification, are permitted provided that: (1) source code distributions
8e3b965f6Sderaadt.\" retain the above copyright notice and this paragraph in its entirety, (2)
9e3b965f6Sderaadt.\" distributions including binary code include the above copyright notice and
10e3b965f6Sderaadt.\" this paragraph in its entirety in the documentation or other materials
11a2e6cc1fSmartin.\" provided with the distribution.  Neither the name of
12e3b965f6Sderaadt.\" the University nor the names of its contributors may be used to endorse
13e3b965f6Sderaadt.\" or promote products derived from this software without specific prior
14e3b965f6Sderaadt.\" written permission.
15e3b965f6Sderaadt.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
16e3b965f6Sderaadt.\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
17e3b965f6Sderaadt.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
18e3b965f6Sderaadt.\"
1970e6e040Sgrant.Dd October 17, 2002
20e3b965f6Sderaadt.Dt RARPD 8
21afe5a263Sjoerg.Os
22e3b965f6Sderaadt.Sh NAME
23e3b965f6Sderaadt.Nm rarpd
24e3b965f6Sderaadt.Nd Reverse ARP Daemon
25e3b965f6Sderaadt.Sh SYNOPSIS
26bffabae3Slukem.Nm
27aebb3d6cSmrg.Op Fl adfl
282c07094bSthorpej.Oo
292c07094bSthorpej.Ar interface
302c07094bSthorpej.Op Ar ...
312c07094bSthorpej.Oc
32e3b965f6Sderaadt.Sh DESCRIPTION
33bffabae3Slukem.Nm
34e3b965f6Sderaadtservices Reverse ARP requests on the Ethernet connected to
35e3b965f6Sderaadt.Ar interface .
36e3b965f6SderaadtUpon receiving a request,
37bffabae3Slukem.Nm
38e3b965f6Sderaadtmaps the target hardware address to an IP address via its name, which
39e3b965f6Sderaadtmust be present in both the
40e3b965f6Sderaadt.Xr ethers 5
41e3b965f6Sderaadtand
42e3b965f6Sderaadt.Xr hosts 5
43e3b965f6Sderaadtdatabases.
4412c67164SlukemIf a host does not exist in both databases the translation cannot
45e3b965f6Sderaadtproceed and a reply will not be sent.
46c78a02a7Sthorpej.\" .Pp
47c78a02a7Sthorpej.\" Additionally, a request is honored only if the server
4812c67164Slukem.\" (the host that rarpd is running on)
4912c67164Slukem.\" can `boot' the target.
5012c67164Slukem.\" .Pp
5112c67164Slukem.\" To be considered able to boot the target the server must have
5212c67164Slukem.\" a file or directory
53c78a02a7Sthorpej.\" .Pa /tftpboot/ Ns Em ipaddr
5412c67164Slukem.\" where
5512c67164Slukem.\" .Pa ipaddr
5612c67164Slukem.\" is the target IP address as an eight digit hexadecimal string.
5712c67164Slukem.\" For example, the IP address 203.8.3.18 is represented as
5812c67164Slukem.\" .Sq CB080312 .
59e3b965f6Sderaadt.Pp
60e3b965f6SderaadtIn normal operation,
61bffabae3Slukem.Nm
62e3b965f6Sderaadtforks a copy of itself and runs in
63e3b965f6Sderaadtthe background.  Anomalies and errors are reported via
64e3b965f6Sderaadt.Xr syslog 3 .
65e3b965f6Sderaadt.Sh OPTIONS
66e3b965f6Sderaadt.Bl -tag -width indent
67e3b965f6Sderaadt.It Fl a
68e3b965f6SderaadtListen on all the Ethernets attached to the system.
69e3b965f6SderaadtIf
70e3b965f6Sderaadt.Sq Fl a
71e3b965f6Sderaadtis omitted, an interface must be specified.
72e3b965f6Sderaadt.It Fl d
73e3b965f6SderaadtRun in debug mode, with all the output to stderr.
74e3b965f6SderaadtThis option implies the
75e3b965f6Sderaadt.Fl f
76e3b965f6Sderaadtoption.
77e3b965f6Sderaadt.It Fl f
78e3b965f6SderaadtRun in the foreground.
79aebb3d6cSmrg.It Fl l
80aebb3d6cSmrgLog all requests to syslog.
81e3b965f6Sderaadt.El
82e3b965f6Sderaadt.Sh FILES
83e3b965f6Sderaadt.Bl -tag -width Pa -compact
84e3b965f6Sderaadt.It Pa /etc/ethers
85e3b965f6Sderaadt.It Pa /etc/hosts
86c78a02a7Sthorpej.\" .It Pa /tftpboot
87e3b965f6Sderaadt.El
88e3b965f6Sderaadt.Sh SEE ALSO
89*75d797faSabhinav.Xr bpf 4 ,
90*75d797faSabhinav.Xr ethers 5 ,
91*75d797faSabhinav.Xr hosts 5
92e3b965f6Sderaadt.Rs
93e3b965f6Sderaadt.%R A Reverse Address Resolution Protocol
94e3b965f6Sderaadt.%N RFC 903
95e3b965f6Sderaadt.%A Finlayson, R.
96e3b965f6Sderaadt.%A Mann, T.
97e3b965f6Sderaadt.%A Mogul, J.C.
98e3b965f6Sderaadt.%A Theimer, M.
99e3b965f6Sderaadt.Re
100e3b965f6Sderaadt.Sh AUTHORS
101*75d797faSabhinav.An -nosplit
102*75d797faSabhinav.An Craig Leres Aq Mt leres@ee.lbl.gov
103*75d797faSabhinavand
104*75d797faSabhinav.An Steven McCanne Aq Mt mccanne@ee.lbl.gov .
105e3b965f6SderaadtLawrence Berkeley Laboratory, University of California, Berkeley, CA.
106