Penguin
Recent Changes
Annotated edit history of arp(8) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 ARP
2 !!!ARP
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 FILES
8 SEE ALSO
9 AUTHORS
10 ----
11 !!NAME
12
13
14 arp - manipulate the system ARP cache
15 !!SYNOPSIS
16
17
18 __arp__ [[__-vn__] [[__-H type__] [[__-i if__]
19 __-a__ [[__hostname__]
20
21
22 __arp__ [[__-v__] [[__-i if__] __-d hostname__
23 [[__pub__]
24
25
26 __arp__ [[__-v__] [[__-H type__] [[__-i if__] __-s
27 hostname hw_addr__ [[__temp__]
28
29
30 __arp__ [[__-v__] [[__-H type__] [[__-i if__] __-s
31 hostname hw_addr__ [[__netmask nm__]
32 __pub__
33
34
35 __arp__ [[__-v__] [[__-H type__] [[__-i if__]
36 __-Ds hostname ifa__ [[__netmask nm__]
37 __pub__
38
39
40 __arp__ [[__-vnD__] [[__-H type__] [[__-i if__]
41 __-f [[filename]__
42 !!DESCRIPTION
43
44
45 __Arp__ manipulates the kernel's ARP cache in various
46 ways. The primary options are clearing an address mapping
47 entry and manually setting up one. For debugging purposes,
48 the __arp__ program also allows a complete dump of the
49 ARP cache.
50 !!OPTIONS
51
52
53 __-v, --verbose__
54
55
56 Tell the user what is going on by being
57 verbose.
58
59
60 __-n, --numeric__
61
62
63 shows numerical addresses instead of trying to determine
64 symbolic host, port or user names.
65
66
67 __-H type, --hw-type type__
68
69
70 When setting or reading the ARP cache, this optional
71 parameter tells __arp__ which class of entries it should
72 check for. The default value of this parameter is
73 __ether__ (i.e. hardware code 0x01 for IEEE 802.3 10Mbps
74 Ethernet). Other values might include network technologies
75 such as ARCnet (__arcnet__) , PROnet (__pronet__) ,
76 AX.25 (__ax25__) and NET/ROM
77 (__netrom__).
78
79
80 __-a [[hostname], --display [[hostname]__
81
82
83 Shows the entries of the specified hosts. If the
84 __hostname__ parameter is not used, __all__ entries
85 will be displayed.
86
87
88 __-d hostname, --delete hostname__
89
90
91 Remove any entry for the specified host. This can be used if
92 the indicated host is brought down, for
93 example.
94
95
96 __-D, --use-device__
97
98
99 Use the interface __ifa__'s hardware
100 address.
101
102
103 __-i If, --device If__
104
105
106 Select an interface. When dumping the ARP cache only entries
107 matching the specified interface will be printed. When
108 setting a permanent or __temp__ ARP entry this interface
109 will be associated with the entry; if this option is not
110 used, the kernel will guess based on the routing table. For
111 __pub__ entries the specified interface is the interface
112 on which ARP requests will be answered.__
113 NOTE:__ This has to be different from the interface to
114 which the IP datagrams will be routed.
115
116
117 __-s hostname hw_addr, --set hostname__
118
119
120 Manually create an ARP address mapping entry for host
121 __hostname__ with hardware address set to __hw_addr__
122 class, but for most classes one can assume that the usual
123 presentation can be used. For the Ethernet class, this is 6
124 bytes in hexadecimal, separated by colons. When adding proxy
125 arp entries (that is those with the __pub__lish flag set
126 a __netmask__ may be specified to proxy arp for entire
127 subnets. This is not good practice, but is supported by
128 older kernels because it can be useful. If the __temp__
129 flag is not supplied entries will be permanent stored into
130 the ARP cache.__
131 NOTE:__ As of kernel 2.2.0 it is no longer possible to set
132 an ARP entry for an entire subnet. Linux instead does
133 automagic proxy arp when a route exists and it is
134 forwarding. See arp(7) for details.
135
136
137 __-f filename, --file filename__
138
139
140 Similar to the __-s__ option, only this time the address
141 info is taken from file __filename__ set up. The name of
142 the data file is very often ''/etc/ethers'', but this is
143 not official. If no filename is specified /etc/ethers is
144 used as default.
145
146
147 The format of the file is simple; it only contains ASCII
148 text lines with a hostname, and a hardware address separated
149 by whitespace. Additionally the __pub__, __temp__ and
150 __netmask__ flags can be used.
151
152
153 In all places where a __hostname__ is expected, one can
154 also enter an __IP address__ in dotted-decimal
155 notation.
156
157
158 As a special case for compatibility the order of the
159 hostname and the hardware address can be
160 exchanged.
161
162
163 Each complete entry in the ARP cache will be marked with the
164 __C__ flag. Permanent entries are marked with __M__
165 and published entries have the __P__ flag.
166 !!FILES
167
168
169 ''/proc/net/arp,
170 /etc/networks
171 /etc/hosts
172 /etc/ethers''
173 !!SEE ALSO
174
175
176 rarp(8), route(8), ifconfig(8), netstat(8)
177 !!AUTHORS
178
179
180 Fred N. van Kempen,
181 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.