1.\" Copyright (c) 1985, 1991 The Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)arp.8 6.5 (Berkeley) 03/16/91 7.\" 8.Dd 9.Dt ARP 8 10.Os BSD 4.3 11.Sh NAME 12.Nm arp 13.Nd address resolution display and control 14.Sh SYNOPSIS 15.Nm arp 16.Ar hostname 17.Nm arp 18.Fl a 19.Op Ar vmunix 20.Op Ar kmem 21.Nm arp 22.Fl d Ar hostname 23.Nm arp 24.Fl s Ar hostname ether_addr 25.Op Ar temp 26.Op Ar pub 27.Op Ar trail 28.Nm arp 29.Fl f Ar filename 30.Sh DESCRIPTION 31The 32.Nm arp 33program displays and modifies the Internet-to-Ethernet address translation 34tables used by the address resolution protocol 35.Pq Xr arp 4 . 36With no flags, the program displays the current 37.Tn ARP 38entry for 39.Ar hostname . 40The host may be specified by name or by number, 41using Internet dot notation. 42.Pp 43Available options: 44.Bl -tag -width Ds 45.It Fl a 46The program displays all of the current 47.Tn ARP 48entries by reading the table 49from the file 50.Ar kmem 51(default /dev/kmem) based on the kernel file 52.Ar vmunix 53(default 54.Pa /vmunix ) . 55.It Fl d 56A super-user may delete an entry for the host called 57.Ar hostname 58with the 59.Fl d 60flag. 61.It Fl s Ar hostname ether_addr 62Create an 63.Tn ARP 64entry for the host called 65.Ar hostname 66with the Ethernet address 67.Ar ether_addr . 68The Ethernet address is given as six hex bytes separated by colons. 69The entry will be permanent unless the word 70.Ar temp 71is given in the command. 72If the word 73.Ar pub 74is given, the entry will be "published"; i.e., this system will 75act as an 76.Tn ARP 77server, 78responding to requests for 79.Ar hostname 80even though the host address is not its own. 81The word 82.Ar trail 83indicates that trailer encapsulations may be sent to this host. 84.It Fl f 85Causes the file 86.Ar filename 87to be read and multiple entries to be set in the 88.Tn ARP 89tables. Entries 90in the file should be of the form 91.Pp 92.Bd -filled -offset indent -compact 93.Ar hostname ether_addr 94.Op Ar temp 95.Op Ar pub 96.Op Ar trail 97.Ed 98.Pp 99with argument meanings as given above. 100.El 101.Sh SEE ALSO 102.Xr inet 3 , 103.Xr arp 4 , 104.Xr ifconfig 8 105.Sh HISTORY 106The 107.Nm 108command appeared in 109.Bx 4.3 . 110