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 <kuznet (a] ms2.inr.ac.ru></ulink>. 120 It is now maintained by 121 <ulink url="mailto:yoshfuji (a] skbuff.net">YOSHIFUJI Hideaki 122 <yoshfuji (a] skbuff.net></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