1.\" Copyright (c) 1985, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)arp.8 8.2 (Berkeley) 04/27/95 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.Nm arp 20.Fl d Ar hostname 21.Nm arp 22.Fl s Ar hostname ether_addr 23.Op Ar temp 24.Op Ar pub 25.Nm arp 26.Fl f Ar filename 27.Sh DESCRIPTION 28The 29.Nm arp 30program displays and modifies the Internet-to-Ethernet address translation 31tables used by the address resolution protocol 32.Pq Xr arp 4 . 33With no flags, the program displays the current 34.Tn ARP 35entry for 36.Ar hostname . 37The host may be specified by name or by number, 38using Internet dot notation. 39.Pp 40Available options: 41.Bl -tag -width Ds 42.It Fl a 43The program displays all of the current 44.Tn ARP 45entries. 46.It Fl d 47A super-user may delete an entry for the host called 48.Ar hostname 49with the 50.Fl d 51flag. 52.It Fl s Ar hostname ether_addr 53Create an 54.Tn ARP 55entry for the host called 56.Ar hostname 57with the Ethernet address 58.Ar ether_addr . 59The Ethernet address is given as six hex bytes separated by colons. 60The entry will be permanent unless the word 61.Ar temp 62is given in the command. 63If the word 64.Ar pub 65is given, the entry will be "published"; i.e., this system will 66act as an 67.Tn ARP 68server, 69responding to requests for 70.Ar hostname 71even though the host address is not its own. 72.It Fl f 73Causes the file 74.Ar filename 75to be read and multiple entries to be set in the 76.Tn ARP 77tables. Entries 78in the file should be of the form 79.Pp 80.Bd -filled -offset indent -compact 81.Ar hostname ether_addr 82.Op Ar temp 83.Op Ar pub 84.Ed 85.Pp 86with argument meanings as given above. 87.El 88.Sh SEE ALSO 89.Xr inet 3 , 90.Xr arp 4 , 91.Xr ifconfig 8 92.Sh HISTORY 93The 94.Nm 95command appeared in 96.Bx 4.3 . 97