| 1 | .\" Copyright (c) 1985 The Regents of the University of California. |
| 2 | .\" All rights reserved. |
| 3 | .\" |
| 4 | .\" Redistribution and use in source and binary forms are permitted |
| 5 | .\" provided that the above copyright notice and this paragraph are |
| 6 | .\" duplicated in all such forms and that any documentation, |
| 7 | .\" advertising materials, and other materials related to such |
| 8 | .\" distribution and use acknowledge that the software was developed |
| 9 | .\" by the University of California, Berkeley. The name of the |
| 10 | .\" University may not be used to endorse or promote products derived |
| 11 | .\" from this software without specific prior written permission. |
| 12 | .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR |
| 13 | .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED |
| 14 | .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. |
| 15 | .\" |
| 16 | .\" @(#)arp.8 6.3 (Berkeley) %G% |
| 17 | .\" |
| 18 | .TH ARP 8 "" |
| 19 | .UC 6 |
| 20 | .SH NAME |
| 21 | arp \- address resolution display and control |
| 22 | .SH SYNOPSIS |
| 23 | .B arp |
| 24 | .I hostname |
| 25 | .br |
| 26 | .B arp -a |
| 27 | [ |
| 28 | .I vmunix |
| 29 | ] [ |
| 30 | .I kmem |
| 31 | ] |
| 32 | .br |
| 33 | .B arp -d |
| 34 | .I hostname |
| 35 | .br |
| 36 | .B arp -s |
| 37 | .I hostname ether_addr |
| 38 | [ |
| 39 | .B temp |
| 40 | ] [ |
| 41 | .B pub |
| 42 | ] [ |
| 43 | .B trail |
| 44 | ] |
| 45 | .br |
| 46 | .B arp -f |
| 47 | .I filename |
| 48 | .SH DESCRIPTION |
| 49 | The |
| 50 | .I arp |
| 51 | program displays and modifies the Internet-to-Ethernet address translation |
| 52 | tables used by the address resolution protocol |
| 53 | .RI ( arp (4p)). |
| 54 | .LP |
| 55 | With no flags, the program displays the current ARP entry for |
| 56 | .I hostname. |
| 57 | The host may be specified by name or by number, |
| 58 | using Internet dot notation. |
| 59 | With the |
| 60 | .B -a |
| 61 | flag, the program displays all of the current ARP entries by reading the table |
| 62 | from the file |
| 63 | .I kmem |
| 64 | (default /dev/kmem) based on the kernel file |
| 65 | .I vmunix |
| 66 | (default /vmunix). |
| 67 | .LP |
| 68 | With the |
| 69 | .B -d |
| 70 | flag, a super-user may delete an entry for the host called |
| 71 | .I hostname. |
| 72 | .LP |
| 73 | The |
| 74 | .B -s |
| 75 | flag is given to create an ARP entry for the host called |
| 76 | .I hostname |
| 77 | with the Ethernet address |
| 78 | .I ether_addr. |
| 79 | The Ethernet address is given as six hex bytes separated by colons. |
| 80 | The entry will be permanent unless the word |
| 81 | .B temp |
| 82 | is given in the command. |
| 83 | If the word |
| 84 | .B pub |
| 85 | is given, the entry will be "published"; i.e., this system will |
| 86 | act as an ARP server, |
| 87 | responding to requests for |
| 88 | .I hostname |
| 89 | even though the host address is not its own. |
| 90 | The word |
| 91 | .B trail |
| 92 | indicates that trailer encapsulations may be sent to this host. |
| 93 | .LP |
| 94 | The |
| 95 | .B -f |
| 96 | flag causes the file |
| 97 | .I filename |
| 98 | to be read and multiple entries to be set in the ARP tables. Entries |
| 99 | in the file should be of the form |
| 100 | .IP |
| 101 | .I hostname ether_addr |
| 102 | [ |
| 103 | .B temp |
| 104 | ] [ |
| 105 | .B pub |
| 106 | ] [ |
| 107 | .B trail |
| 108 | ] |
| 109 | .LP |
| 110 | with argument meanings as given above. |
| 111 | .SH "SEE ALSO" |
| 112 | inet(3), arp(4), ifconfig(8) |