Home | History | Annotate | Download | only in doc
      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>
     25 Listens
     26 <ulink url="http://tools.ietf.org/rfc/rfc903.txt">RARP</ulink>
     27 requests from clients. Provided MAC address of client
     28 is found in <filename>/etc/ethers</filename> database and
     29 obtained host name is resolvable to an IP address appropriate
     30 for attached network, <command/rarpd/ answers to client with RARPD
     31 reply carrying an IP address.
     32 </para>
     33 <para>
     34 To allow multiple boot servers on the network <command/rarpd/
     35 optionally checks for presence Sun-like bootable image in TFTP directory.
     36 It should have form <userinput/Hexadecimal_IP.ARCH/, f.e. to load
     37 sparc 193.233.7.98 <filename/C1E90762.SUN4M/ is linked to
     38 an image appropriate for SUM4M in directory <filename>/etc/tftpboot</filename>.
     39 </para>
     40 </refsect1>
     41 
     42 <refsect1><title>WARNING</title>
     43 <para>
     44 This facility is deeply obsoleted by
     45 <ulink url="http://tools.ietf.org/rfc/rfc951.txt">BOOTP</ulink>
     46 and later
     47 <ulink url="http://tools.ietf.org/rfc/rfc2131.txt">DHCP</ulink> protocols.
     48 However, 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>
     60 Listen on all the interfaces. Currently it is an internal
     61 option, its function is overridden with <replaceable/interface/
     62 argument. It should not be used.
     63   </para></listitem>
     64  </varlistentry>
     65 
     66  <varlistentry>
     67   <term><option/-A/</term>
     68   <listitem><para>
     69 Listen not only RARP but also ARP messages, some rare clients
     70 use ARP by some unknown reason.
     71   </para></listitem>
     72  </varlistentry>
     73 
     74  <varlistentry>
     75   <term><option/-v/</term>
     76   <listitem><para>
     77 Be verbose.
     78   </para></listitem>
     79  </varlistentry>
     80 
     81  <varlistentry>
     82   <term><option/-d/</term>
     83   <listitem><para>
     84 Debug mode. Do not go to background.
     85   </para></listitem>
     86  </varlistentry>
     87 
     88  <varlistentry>
     89   <term><option/-e/</term>
     90   <listitem><para>
     91 Do not check for presence of a boot image, reply if MAC address
     92 resolves to a valid IP address using <filename>/etc/ethers</filename>
     93 database and DNS. 
     94   </para></listitem>
     95  </varlistentry>
     96 
     97  <varlistentry>
     98   <term><option>-b <replaceable/bootdir/</option></term>
     99   <listitem><para>
    100 TFTP 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 (a] ms2.inr.ac.ru">Alexey Kuznetsov
    119 &lt;kuznet (a] ms2.inr.ac.ru&gt;</ulink>.
    120 It is now maintained by
    121 <ulink url="mailto:yoshfuji (a] skbuff.net">YOSHIFUJI Hideaki
    122 &lt;yoshfuji (a] 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
    129 to listen and send RARP and ARP packets. It also needs <constant/CAP_NET_ADMIN/
    130 to give to kernel hint for ARP resolution; this is not strictly required,
    131 but some (most of, to be more exact) clients are so badly broken that
    132 are not able to answer ARP before they are finally booted. This is
    133 not wonderful taking into account that clients using RARPD in 2002
    134 are 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
    141 and the latest versions are  available in source form at
    142 <ulink url="http://www.skbuff.net/iputils/iputils-current.tar.bz2">
    143 http://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>
    151 This documentation is free software; you can redistribute
    152 it and/or modify it under the terms of the GNU General Public
    153 License Version 2.
    154 
    155 This program is distributed in the hope that it will be
    156 useful, but WITHOUT ANY WARRANTY; without even the implied
    157 warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
    158 See the GNU General Public License for more details.
    159  
    160 For more details see the file COPYING in the source
    161 distribution of Linux kernel of version 2.4.
    162 </literallayout>
    163 </para>
    164 </refsect1>
    165 ]]>
    166 
    167 
    168 
    169 
    170 </refentry>
    171