1.\" $NetBSD: arp.8,v 1.11 1999/03/22 18:43:48 garbled Exp $ 2.\" 3.\" Copyright (c) 1985, 1991, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by the University of 17.\" California, Berkeley and its contributors. 18.\" 4. Neither the name of the University nor the names of its contributors 19.\" may be used to endorse or promote products derived from this software 20.\" without specific prior written permission. 21.\" 22.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" SUCH DAMAGE. 33.\" 34.\" from: @(#)arp.8 8.2 (Berkeley) 4/27/95 35.\" 36.Dd April 27, 1995 37.Dt ARP 8 38.Os 39.Sh NAME 40.Nm arp 41.Nd address resolution display and control 42.Sh SYNOPSIS 43.Nm 44.Op Fl n 45.Ar hostname 46.Nm "" 47.Op Fl nv 48.Fl a 49.Nm "" 50.Op Fl v 51.Fl d Ar hostname 52.Nm "" 53.Fl s Ar hostname ether_addr 54.Op Ar temp 55.Op Ar pub 56.Nm "" 57.Fl f Ar filename 58.Sh DESCRIPTION 59The 60.Nm 61program displays and modifies the Internet-to-Ethernet address translation 62tables used by the address resolution protocol 63.Pq Xr arp 4 . 64With no flags, the program displays the current 65.Tn ARP 66entry for 67.Ar hostname . 68The host may be specified by name or by number, 69using Internet dot notation. 70.Pp 71Available options: 72.Bl -tag -width Ds 73.It Fl a 74The program displays all of the current 75.Tn ARP 76entries. 77.It Fl d 78A super-user may delete an entry for the host called 79.Ar hostname 80with the 81.Fl d 82flag. 83.It Fl n 84Show network addresses as numbers (normally 85.Nm 86attempts to display addresses symbolically). 87.It Fl s Ar hostname ether_addr 88Create an 89.Tn ARP 90entry for the host called 91.Ar hostname 92with the Ethernet address 93.Ar ether_addr . 94The Ethernet address is given as six hex bytes separated by colons. 95The entry will be permanent unless the word 96.Ar temp 97is given in the command. 98If the word 99.Ar pub 100is given, the entry will be "published"; i.e., this system will 101act as an 102.Tn ARP 103server, 104responding to requests for 105.Ar hostname 106even though the host address is not its own. 107.It Fl f 108Causes the file 109.Ar filename 110to be read and multiple entries to be set in the 111.Tn ARP 112tables. Entries 113in the file should be of the form 114.Pp 115.Bd -filled -offset indent -compact 116.Ar hostname ether_addr 117.Op Ar temp 118.Op Ar pub 119.Ed 120.Pp 121with argument meanings as given above. 122.It Fl v 123Display verbose information when adding or deleting 124.Tn ARP 125entries. 126.El 127.Sh SEE ALSO 128.Xr inet 3 , 129.Xr arp 4 , 130.Xr ifconfig 8 131.Sh HISTORY 132The 133.Nm 134command appeared in 135.Bx 4.3 . 136