| 1 |
.TH RARP 8 "2008\-10\-03" "net\-tools" "Linux System Administrator's Manual" |
| 2 |
.SH NAME |
| 3 |
rarp \- manipulate the system RARP table |
| 4 |
.SH SYNOPSIS |
| 5 |
.B "rarp [\-V] [\-\-version] [\-h] [\-\-help]" |
| 6 |
.br |
| 7 |
.B "rarp \-a" |
| 8 |
.br |
| 9 |
.B "rarp [\-v] \-d hostname ..." |
| 10 |
.br |
| 11 |
.B "rarp [\-v] [\-t type] \-s hostname hw_addr" |
| 12 |
.SH NOTE |
| 13 |
.P |
| 14 |
This program is obsolete. From version 2.3, the Linux kernel |
| 15 |
no longer contains RARP support. For a replacement RARP daemon, see |
| 16 |
.I |
| 17 |
ftp://ftp.dementia.org/pub/net\-tools |
| 18 |
.SH DESCRIPTION |
| 19 |
.B Rarp |
| 20 |
manipulates the kernel's RARP table in various ways. The primary options |
| 21 |
are clearing an address mapping entry and manually setting up one. For |
| 22 |
debugging purposes, the |
| 23 |
.B rarp |
| 24 |
program also allows a complete dump of the RARP table. |
| 25 |
.SH OPTIONS |
| 26 |
.TP |
| 27 |
.B \-V |
| 28 |
Display the version of RARP in use. |
| 29 |
.TP |
| 30 |
.B \-v |
| 31 |
Tell the user what is going on by being verbose. |
| 32 |
.TP |
| 33 |
.B "\-t type" |
| 34 |
When setting or reading the RARP table, this optional parameter tells |
| 35 |
.B rarp |
| 36 |
which class of entries it should check for. The default value of |
| 37 |
this parameter is |
| 38 |
.B ether |
| 39 |
(i.e. hardware code |
| 40 |
.B 0x01 |
| 41 |
for |
| 42 |
.B "IEEE 802.3 10Mbps Ethernet". |
| 43 |
Other values might include network technologies such as |
| 44 |
.B AX.25 (ax25) |
| 45 |
and |
| 46 |
.B NET/ROM (netrom). |
| 47 |
.TP |
| 48 |
.B "\-a" |
| 49 |
.TP |
| 50 |
.B "\-\-list" |
| 51 |
Lists the entries in the RARP table. |
| 52 |
.TP |
| 53 |
.B "\-d hostname" |
| 54 |
.TP |
| 55 |
.B "\-\-delete hostname" |
| 56 |
Remove all RARP entries for the specified host. |
| 57 |
.TP |
| 58 |
.B "\-s hostname hw_addr" |
| 59 |
.TP |
| 60 |
.B "\-\-set hostname hw_addr" |
| 61 |
Create a RARP address mapping entry for host |
| 62 |
.B hostname |
| 63 |
with hardware address set to |
| 64 |
.BR hw_addr . |
| 65 |
The format of the hardware address is dependent on the hardware |
| 66 |
class, but for most classes one can assume that the usual presentation |
| 67 |
can be used. For the Ethernet class, this is 6 bytes in hexadecimal, |
| 68 |
separated by colons. |
| 69 |
.SH WARNING |
| 70 |
Some systems (notably older Suns) assume that the host replying to |
| 71 |
a RARP query can also provide other remote boot services. Therefore |
| 72 |
never gratuitously add rarp entries unless you wish to meet the wrath |
| 73 |
of the network administrator. |
| 74 |
.SH FILES |
| 75 |
.I /proc/net/rarp, |
| 76 |
.SH SEE ALSO |
| 77 |
.BR arp (8), |
| 78 |
.BR route (8), |
| 79 |
.BR ifconfig (8), |
| 80 |
.BR netstat (8) |
| 81 |
.SH AUTHORS |
| 82 |
Ross D. Martin, <[email protected]> |
| 83 |
.br |
| 84 |
Fred N. van Kempen, <[email protected]> |
| 85 |
.br |
| 86 |
Phil Blundell, <[email protected]> |