<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">
<!-- conversion to man: 
  xsltproc  /usr/apps/docbook/xsl/1.67.2/manpages/docbook.xsl ping.8.dbk
-->
<refentry id="rarpd">
    <refentryinfo>
        <productname>Linux</productname>
        <title>System Administration</title>
        <date>27 September 2002</date>
    </refentryinfo>
	<refmeta>
		<refentrytitle>rarpd</refentrytitle>
		<manvolnum>8</manvolnum>
	</refmeta>
	<refnamediv>
		<refname>rarpd</refname>
		<refpurpose>answer RARP REQUESTs</refpurpose>
	</refnamediv>
	<refsynopsisdiv>
		<cmdsynopsis>
			<command>rarpd</command>
			<group>
				<arg choice="plain"><option>-a</option></arg>
				<arg choice="plain"><option>-A</option></arg>
				<arg choice="plain"><option>-v</option></arg>
				<arg choice="plain"><option>-d</option></arg>
				<arg choice="plain"><option>-e</option></arg>
			</group>
			<group>
				<arg choice="plain"><option>-b</option> <replaceable
					>bootdir</replaceable>
				</arg>
			</group>
			<arg choice="opt"><replaceable>interface</replaceable></arg>
		</cmdsynopsis>
	</refsynopsisdiv>
	
	<refsection>
		
		<title>DESCRIPTION</title>
		
<para>Listens for <ulink url="ftp://ftp.isi.edu/in-notes/rfc903.txt"
>RARP</ulink> requests from clients. Provided MAC address of client is 
found in <filename>/etc/ethers</filename> database and obtained host name 
is resolvable to an IP address appropriate for attached network,
<command>rarpd</command> answers to client with RARPD reply carrying an
IP address.</para>

<para> To allow multiple boot servers on the 
network <command>rarpd</command> optionally checks for presence Sun-like 
bootable image in TFTP directory. It should have 
form <code>Hexadecimal_IP.ARCH</code>, e.g. to load sparc 
193.233.7.98 <literal>C1E90762.SUN4M</literal> is
linked to an image appropriate for SUM4M in 
directory <filename>/etc/tftpboot</filename>.</para>
	</refsection>
	
	<refsection>
		
		<title>WARNING</title>
		
<para> This facility is deeply obsoleted by <ulink 
url="ftp://ftp.isi.edu/in-notes/rfc951.txt">BOOTP</ulink> and later <ulink
url="ftp://ftp.isi.edu/in-notes/rfc2131.txt">DHCP</ulink> protocols.
However, some clients really still need this to boot.</para>
	</refsection>
	
	<refsection>
		
		<title>OPTIONS</title>
		
		<variablelist>
			<varlistentry>
				<term>
					<option>-a</option>
				</term>
				<listitem>
<para>Listen on all the interfaces. Currently it is an
internal option, its function is overridden with
<replaceable>interface</replaceable> argument. It should not be
used.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>
					<option>-A</option>
				</term>
				<listitem>
<para>Listen not only RARP but also ARP messages, some rare
clients use ARP by some unknown reason.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>
					<option>-v</option>
				</term>
				<listitem>
<para>Be verbose.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>
					<option>-d</option>
				</term>
				<listitem>
<para>Debug mode. Do not go to background.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>
					<option>-e</option>
				</term>
				<listitem>
<para> Do not check for presence of a boot image, reply if
MAC address resolves to a valid IP address using
<filename>/etc/ethers</filename> database and DNS.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>
					<option>-b</option> <replaceable>bootdir</replaceable>
				</term>
				<listitem>
<para>TFTP boot directory. Default is <filename>/etc/tftpboot</filename></para>
				</listitem>
			</varlistentry>
		</variablelist>
	</refsection>
	
	<refsection>
		
		<title>SEE ALSO</title>
		
<para><citerefentry>
	<refentrytitle>arping</refentrytitle>
	<manvolnum>8</manvolnum>
</citerefentry>, <citerefentry>
	<refentrytitle>tftpd</refentrytitle>
	<manvolnum>8</manvolnum>
</citerefentry>.</para>
	</refsection>
	
	<refsection>
		
		<title>AUTHOR</title>
		
<para><command>rarpd</command> was written by <address>
<firstname>Alexey</firstname> <surname>Kuznetsov</surname><email
>kuznet@ms2.inr.ac.ru</email></address>.</para>
	</refsection>
	
	<refsection>
		
		<title>SECURITY</title>

<para><command>rarpd</command> requires <constant
>CAP_NET_RAWIO</constant> capability to listen and send RARP and 
ARP packets. It also needs <constant>CAP_NET_ADMIN</constant> to give to 
kernel hint for ARP resolution; this is not strictly required, but some
(most of, to be more exact) clients are so badly broken
that are not able to answer ARP before they are finally
booted. This is not wonderful taking into account that
clients using RARPD in 2002 are all unsupported relic
creatures of 90's and even earlier.</para>
	</refsection>
	
	<refsection>
		
		<title>AVAILABILITY</title>
		
<para><command>rarpd</command> is part 
of <application>iputils</application> package and the latest
versions are available in source form for anonymous via <ulink
url="ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz"/>.</para>
	</refsection>
</refentry>

