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