man/en_US/rarp.8

   1 .TH RARP 8 "4 August 1997" "net-tools" "Linux Programmer'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 arp(8), route(8), ifconfig(8), netstat(8)
  78 .SH AUTHORS
  79 Ross D. Martin, <martin@trcsun3.eas.asu.edu>
  80 .br
  81 Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org>
  82 .br
  83 Phil Blundell, <Philip.Blundell@pobox.com>