xref: /original-bsd/usr.sbin/arp/arp.8 (revision f922abba)
10539701cSbostic.\" Copyright (c) 1985, 1991, 1993
20539701cSbostic.\"	The Regents of the University of California.  All rights reserved.
3dd691317Smckusick.\"
43faee703Strent.\" %sccs.include.redist.man%
5dd691317Smckusick.\"
6*f922abbaSbostic.\"     @(#)arp.8	8.2 (Berkeley) 04/27/95
70cac7ccfSbostic.\"
813251ec2Scael.Dd
913251ec2Scael.Dt ARP 8
1013251ec2Scael.Os BSD 4.3
1113251ec2Scael.Sh NAME
1213251ec2Scael.Nm arp
1313251ec2Scael.Nd address resolution display and control
1413251ec2Scael.Sh SYNOPSIS
1513251ec2Scael.Nm arp
1613251ec2Scael.Ar hostname
1713251ec2Scael.Nm arp
1813251ec2Scael.Fl a
1913251ec2Scael.Nm arp
2013251ec2Scael.Fl d Ar hostname
2113251ec2Scael.Nm arp
2213251ec2Scael.Fl s Ar hostname ether_addr
2313251ec2Scael.Op Ar temp
2413251ec2Scael.Op Ar pub
2513251ec2Scael.Nm arp
2613251ec2Scael.Fl f Ar filename
2713251ec2Scael.Sh DESCRIPTION
28dd691317SmckusickThe
2913251ec2Scael.Nm arp
30dd691317Smckusickprogram displays and modifies the Internet-to-Ethernet address translation
318441610fSkarelstables used by the address resolution protocol
3213251ec2Scael.Pq Xr arp 4 .
3313251ec2ScaelWith no flags, the program displays the current
3413251ec2Scael.Tn ARP
3513251ec2Scaelentry for
3613251ec2Scael.Ar hostname .
378441610fSkarelsThe host may be specified by name or by number,
388441610fSkarelsusing Internet dot notation.
3913251ec2Scael.Pp
4013251ec2ScaelAvailable options:
4113251ec2Scael.Bl -tag -width Ds
4213251ec2Scael.It Fl a
4313251ec2ScaelThe program displays all of the current
4413251ec2Scael.Tn ARP
451eb208bbStorekentries.
4613251ec2Scael.It Fl d
4713251ec2ScaelA super-user may delete an entry for the host called
4813251ec2Scael.Ar hostname
4913251ec2Scaelwith the
5013251ec2Scael.Fl d
5113251ec2Scaelflag.
5213251ec2Scael.It Fl s Ar hostname ether_addr
5313251ec2ScaelCreate an
5413251ec2Scael.Tn ARP
5513251ec2Scaelentry for the host called
5613251ec2Scael.Ar hostname
57dd691317Smckusickwith the Ethernet address
5813251ec2Scael.Ar ether_addr .
59dd691317SmckusickThe Ethernet address is given as six hex bytes separated by colons.
60dd691317SmckusickThe entry will be permanent unless the word
6113251ec2Scael.Ar temp
62dd691317Smckusickis given in the command.
63dd691317SmckusickIf the word
6413251ec2Scael.Ar pub
658441610fSkarelsis given, the entry will be "published"; i.e., this system will
6613251ec2Scaelact as an
6713251ec2Scael.Tn ARP
6813251ec2Scaelserver,
698441610fSkarelsresponding to requests for
7013251ec2Scael.Ar hostname
718441610fSkarelseven though the host address is not its own.
7213251ec2Scael.It Fl f
7313251ec2ScaelCauses the file
7413251ec2Scael.Ar filename
7513251ec2Scaelto be read and multiple entries to be set in the
7613251ec2Scael.Tn ARP
7713251ec2Scaeltables.  Entries
78dd691317Smckusickin the file should be of the form
7913251ec2Scael.Pp
8013251ec2Scael.Bd -filled -offset indent -compact
8113251ec2Scael.Ar hostname ether_addr
8213251ec2Scael.Op Ar temp
8313251ec2Scael.Op Ar pub
8413251ec2Scael.Ed
8513251ec2Scael.Pp
86dd691317Smckusickwith argument meanings as given above.
8713251ec2Scael.El
8813251ec2Scael.Sh SEE ALSO
8913251ec2Scael.Xr inet 3 ,
9013251ec2Scael.Xr arp 4 ,
9113251ec2Scael.Xr ifconfig 8
9213251ec2Scael.Sh HISTORY
9313251ec2ScaelThe
9413251ec2Scael.Nm
9513251ec2Scaelcommand appeared in
9613251ec2Scael.Bx 4.3 .
97