arp(3) [plan9 man page]

ARP(3)							     Library Functions Manual							    ARP(3)

NAME

       arp - Internet Address Resolution Protocol

SYNOPSIS

       bind -a #a /net/arp

       /net/arp/ctl
       /net/arp/data
       /net/arp/stats

DESCRIPTION

       The  arp  device  provides  the	means by which the kernel resolves IP addresses into Ethernet addresses.  A cache is maintained by the arp
       device to speed the process.

       The ctl file controls the ARP cache maintained by the kernel.  The flush control message invalidates all entries in the cache.  The  delete
       ipaddr control message invalidates a single cache entry.  All IP addresses passed to the system are in the canonical textual form described
       in ip(2).  The perm ipaddr control message makes an existing cache entry permanent.

       When the kernel boots, ipconfig sets up the IP stream and arpd opens #a/arp/data (see ipconfig(8)).  This establishes  the  ARP	cache  and
       enables	arpd to receive all ARP packets from the network, which it uses to maintain the cache by writing the results of address resolution
       requests back into the cache.  The IP stream module uses the cache to translate IP addresses.

       Subsequent opens of the data file allow the contents of the cache to be examined.  Each cache entry consists of an IP address, an  Ethernet
       address,  and  the  status  of  the entry.  Entries may be invalid, permanent, or temporary.  Permanent entries will never be aged from the
       cache.  Temporary entries may be replaced by new addresses entered by the ARP server.

       The file stats reports the cache performance.

SEE ALSO

       ip(3), ipconfig(8)

SOURCE

       /sys/src/9/port/devarp.c

																	    ARP(3)

ARP(8)							    BSD System Manager's Manual 						    ARP(8)

NAME

     arp -- address resolution display and control

SYNOPSIS

     arp [-n] hostname
     arp [-nv] -a
     arp [-v] -d -a
     arp [-v] -d hostname [proxy]
     arp -s hostname ether_addr [temp] [pub [proxy]]
     arp -f filename

DESCRIPTION

     The arp program displays and modifies the Internet-to-Ethernet address translation tables used by the address resolution protocol (arp(4)).
     With no flags, the program displays the current ARP entry for hostname.  The host may be specified by name or by number, using Internet dot
     notation.

     Available options:

     -a      The program displays all of the current ARP entries.

     -d      A super-user may delete an entry for the host called hostname with the -d flag.  If the proxy keyword is specified, only the pub-
	     lished ``proxy only'' ARP entry for this host will be deleted.  If used with -a instead of a hostname, it will delete all arp
	     entries.

     -f      Causes the file filename to be read and multiple entries to be set in the ARP tables.  Entries in the file should be of the form

		   hostname ether_addr [temp] [pub]

	     with argument meanings as described below.

     -n      Show network addresses as numbers (normally arp attempts to display addresses symbolically).

     -s hostname ether_addr
	     Create an ARP entry for the host called hostname with the Ethernet address ether_addr.  The Ethernet address is given as six hex
	     bytes separated by colons.  The entry will be permanent unless the word temp is given in the command.  If the word pub is given, the
	     entry will be "published"; i.e., this system will act as an ARP server, responding to requests for hostname even though the host
	     address is not its own.  If the word proxy is also given, the published entry will be a ``proxy only'' entry.

     -v      Display verbose information when adding or deleting ARP entries.

SEE ALSO

     inet(3), arp(4), ifconfig(8)

HISTORY

     The arp command appeared in 4.3BSD.

BSD
								 January 31, 2006							       BSD