1<refentry id="rarpd">
2
3<refmeta>
4<refentrytitle>rarpd</refentrytitle>
5<manvolnum>8</manvolnum>
6<refmiscinfo>iputils-&snapshot;</refmiscinfo>
7</refmeta>
8
9<refnamediv>
10<refname>rarpd</refname>
11<refpurpose>answer RARP REQUESTs</refpurpose>
12</refnamediv>
13
14<refsynopsisdiv>
15<cmdsynopsis>
16<command>arping</command>
17<arg choice="opt"><option>-aAvde</option></arg>
18<arg choice="opt">-b <replaceable/bootdir/</arg>
19<arg choice="opt"><replaceable/interface/</arg>
20</cmdsynopsis>
21</refsynopsisdiv>
22
23<refsect1><title>DESCRIPTION</title>
24<para>
25Listens
26<ulink url="ftp://ftp.isi.edu/in-notes/rfc903.txt">RARP</ulink>
27requests from clients. Provided MAC address of client
28is found in <filename>/etc/ethers</filename> database and
29obtained host name is resolvable to an IP address appropriate
30for attached network, <command/rarpd/ answers to client with RARPD
31reply carrying an IP address.
32</para>
33<para>
34To allow multiple boot servers on the network <command/rarpd/
35optionally checks for presence Sun-like bootable image in TFTP directory.
36It should have form <userinput/Hexadecimal_IP.ARCH/, f.e. to load
37sparc 193.233.7.98 <filename/C1E90762.SUN4M/ is linked to
38an image appropriate for SUM4M in directory <filename>/etc/tftpboot</filename>.
39</para>
40</refsect1>
41
42<refsect1><title>WARNING</title>
43<para>
44This facility is deeply obsoleted by
45<ulink url="ftp://ftp.isi.edu/in-notes/rfc951.txt">BOOTP</ulink>
46and later
47<ulink url="ftp://ftp.isi.edu/in-notes/rfc2131.txt">DHCP</ulink> protocols.
48However, some clients really still need this to boot.
49</para>
50</refsect1>
51
52
53<refsect1><title>OPTIONS</title>
54
55<variablelist>
56
57 <varlistentry>
58  <term><option/-a/</term>
59  <listitem><para>
60Listen on all the interfaces. Currently it is an internal
61option, its function is overridden with <replaceable/interface/
62argument. It should not be used.
63  </para></listitem>
64 </varlistentry>
65
66 <varlistentry>
67  <term><option/-A/</term>
68  <listitem><para>
69Listen not only RARP but also ARP messages, some rare clients
70use ARP by some unknown reason.
71  </para></listitem>
72 </varlistentry>
73
74 <varlistentry>
75  <term><option/-v/</term>
76  <listitem><para>
77Be verbose.
78  </para></listitem>
79 </varlistentry>
80
81 <varlistentry>
82  <term><option/-d/</term>
83  <listitem><para>
84Debug mode. Do not go to background.
85  </para></listitem>
86 </varlistentry>
87
88 <varlistentry>
89  <term><option/-e/</term>
90  <listitem><para>
91Do not check for presence of a boot image, reply if MAC address
92resolves to a valid IP address using <filename>/etc/ethers</filename>
93database and DNS. 
94  </para></listitem>
95 </varlistentry>
96
97 <varlistentry>
98  <term><option>-b <replaceable/bootdir/</option></term>
99  <listitem><para>
100TFTP boot directory. Default is <filename>/etc/tftpboot</filename>
101  </para></listitem>
102 </varlistentry>
103</variablelist>
104</refsect1>
105
106<refsect1><title>SEE ALSO</title>
107<para>
108<link linkend="arping">
109<citerefentry><refentrytitle/arping/<manvolnum/8/</citerefentry></link>,
110<link linkend="tftpd">
111<citerefentry><refentrytitle/tftpd/<manvolnum/8/</citerefentry></link>.
112</para>
113</refsect1>
114
115<refsect1><title>AUTHOR</title>
116<para>
117<command/rarpd/ was written by
118<ulink url="mailto:kuznet@ms2.inr.ac.ru">Alexey Kuznetsov
119&lt;kuznet@ms2.inr.ac.ru&gt;</ulink>.
120</para>
121</refsect1>
122
123<refsect1><title>SECURITY</title>
124<para>
125<command/rarpd/ requires <constant/CAP_NET_RAWIO/ capability
126to listen and send RARP and ARP packets. It also needs <constant/CAP_NET_ADMIN/
127to give to kernel hint for ARP resolution; this is not strictly required,
128but some (most of, to be more exact) clients are so badly broken that
129are not able to answer ARP before they are finally booted. This is
130not wonderful taking into account that clients using RARPD in 2002
131are all unsupported relic creatures of 90's and even earlier.
132</para>
133</refsect1>
134
135<refsect1><title>AVAILABILITY</title>
136<para>
137<command/rarpd/ is part of <filename/iputils/ package
138and the latest versions are  available in source form for anonymous ftp
139<ulink url="ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz">
140ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz</ulink>.
141</para>
142</refsect1>
143
144<![IGNORE[
145<refsect1><title>COPYING</title>
146<para>
147<literallayout>
148This documentation is free software; you can redistribute
149it and/or modify it under the terms of the GNU General Public
150License Version 2.
151
152This program is distributed in the hope that it will be
153useful, but WITHOUT ANY WARRANTY; without even the implied
154warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
155See the GNU General Public License for more details.
156 
157For more details see the file COPYING in the source
158distribution of Linux kernel of version 2.4.
159</literallayout>
160</para>
161</refsect1>
162]]>
163
164
165
166
167</refentry>
168