NetBSD/usr.sbin/arp/arp.8

137 lines
3.6 KiB
Groff
Raw Normal View History

.\" $NetBSD: arp.8,v 1.16 2003/08/07 11:25:12 agc Exp $
1995-03-01 14:50:52 +03:00
.\"
1994-05-13 12:09:19 +04:00
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
1993-03-21 12:45:37 +03:00
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. Neither the name of the University nor the names of its contributors
1993-03-21 12:45:37 +03:00
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
1997-03-07 10:04:42 +03:00
.\" from: @(#)arp.8 8.2 (Berkeley) 4/27/95
1993-03-21 12:45:37 +03:00
.\"
1997-03-07 10:04:42 +03:00
.Dd April 27, 1995
1993-03-21 12:45:37 +03:00
.Dt ARP 8
.Os
1993-03-21 12:45:37 +03:00
.Sh NAME
.Nm arp
.Nd address resolution display and control
.Sh SYNOPSIS
1997-10-17 03:46:38 +04:00
.Nm
1995-02-28 01:00:07 +03:00
.Op Fl n
1993-03-21 12:45:37 +03:00
.Ar hostname
.Nm
.Op Fl nv
1993-03-21 12:45:37 +03:00
.Fl a
.Nm
.Op Fl v
2002-01-19 06:05:58 +03:00
.Fl d
2002-01-22 04:35:39 +03:00
.Op Fl a | Ar hostname
.Nm
1993-03-21 12:45:37 +03:00
.Fl s Ar hostname ether_addr
.Op Ar temp
.Op Ar pub
.Nm
1993-03-21 12:45:37 +03:00
.Fl f Ar filename
.Sh DESCRIPTION
The
1997-10-17 03:46:38 +04:00
.Nm
1993-03-21 12:45:37 +03:00
program displays and modifies the Internet-to-Ethernet address translation
tables used by the address resolution protocol
.Pq Xr arp 4 .
With no flags, the program displays the current
.Tn ARP
entry for
.Ar hostname .
The host may be specified by name or by number,
using Internet dot notation.
.Pp
Available options:
.Bl -tag -width Ds
.It Fl a
The program displays all of the current
.Tn ARP
1994-05-13 12:09:19 +04:00
entries.
1993-03-21 12:45:37 +03:00
.It Fl d
A super-user may delete an entry for the host called
.Ar hostname
with the
.Fl d
flag. If used with
.Fl a
instead of a
.Ar hostname ,
it will delete all arp entries.
1995-02-28 01:00:07 +03:00
.It Fl n
Show network addresses as numbers (normally
1997-10-17 03:46:38 +04:00
.Nm
1995-02-28 01:00:07 +03:00
attempts to display addresses symbolically).
1993-03-21 12:45:37 +03:00
.It Fl s Ar hostname ether_addr
Create an
.Tn ARP
entry for the host called
.Ar hostname
2002-01-19 06:05:58 +03:00
with the Ethernet address
1993-03-21 12:45:37 +03:00
.Ar ether_addr .
The Ethernet address is given as six hex bytes separated by colons.
The entry will be permanent unless the word
.Ar temp
2002-01-19 06:05:58 +03:00
is given in the command.
1993-03-21 12:45:37 +03:00
If the word
.Ar pub
is given, the entry will be "published"; i.e., this system will
act as an
.Tn ARP
server,
2002-01-19 06:05:58 +03:00
responding to requests for
1993-03-21 12:45:37 +03:00
.Ar hostname
even though the host address is not its own.
.It Fl f
Causes the file
.Ar filename
to be read and multiple entries to be set in the
.Tn ARP
tables. Entries
in the file should be of the form
.Pp
.Bd -filled -offset indent -compact
.Ar hostname ether_addr
.Op Ar temp
.Op Ar pub
.Ed
.Pp
with argument meanings as given above.
.It Fl v
Display verbose information when adding or deleting
.Tn ARP
entries.
1993-03-21 12:45:37 +03:00
.El
.Sh SEE ALSO
.Xr inet 3 ,
.Xr arp 4 ,
.Xr ifconfig 8
.Sh HISTORY
The
.Nm
command appeared in
.Bx 4.3 .