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