• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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="http://tools.ietf.org/rfc/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="http://tools.ietf.org/rfc/rfc951.txt">BOOTP</ulink>
46and later
47<ulink url="http://tools.ietf.org/rfc/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>.
120It is now maintained by
121<ulink url="mailto:yoshfuji@skbuff.net">YOSHIFUJI Hideaki
122&lt;yoshfuji@skbuff.net&gt;</ulink>.
123</para>
124</refsect1>
125
126<refsect1><title>SECURITY</title>
127<para>
128<command/rarpd/ requires <constant/CAP_NET_RAW/ capability
129to listen and send RARP and ARP packets. It also needs <constant/CAP_NET_ADMIN/
130to give to kernel hint for ARP resolution; this is not strictly required,
131but some (most of, to be more exact) clients are so badly broken that
132are not able to answer ARP before they are finally booted. This is
133not wonderful taking into account that clients using RARPD in 2002
134are all unsupported relic creatures of 90's and even earlier.
135</para>
136</refsect1>
137
138<refsect1><title>AVAILABILITY</title>
139<para>
140<command/rarpd/ is part of <filename/iputils/ package
141and the latest versions are  available in source form at
142<ulink url="http://www.skbuff.net/iputils/iputils-current.tar.bz2">
143http://www.skbuff.net/iputils/iputils-current.tar.bz2</ulink>.
144</para>
145</refsect1>
146
147<![IGNORE[
148<refsect1><title>COPYING</title>
149<para>
150<literallayout>
151This documentation is free software; you can redistribute
152it and/or modify it under the terms of the GNU General Public
153License Version 2.
154
155This program is distributed in the hope that it will be
156useful, but WITHOUT ANY WARRANTY; without even the implied
157warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
158See the GNU General Public License for more details.
159
160For more details see the file COPYING in the source
161distribution of Linux kernel of version 2.4.
162</literallayout>
163</para>
164</refsect1>
165]]>
166
167
168
169
170</refentry>
171