1 System Administration Commands arp(1M) 2 3 4 5 NAME 6 arp - address resolution display and control 7 8 SYNOPSIS 9 arp hostname 10 11 12 arp -a [-n] 13 14 15 arp -d hostname 16 17 18 arp -f filename 19 20 21 arp -s hostname ether_address [temp] [pub] [trail] 22 [permanent] 23 24 25 DESCRIPTION 26 The arp program displays and modifies the Internet-to-MAC 27 address translation tables used by the address resolution 28 protocol (see arp(7P)). 29 30 31 With no flags, the program displays the current ARP entry 32 for hostname. The host may be specified by name or by 33 number, using Internet dot notation. 34 35 36 Options that modify the ARP translation tables (-d, -f, and 37 -s) can be used only when the invoked command is granted the 38 sys_net_config privilege. See privileges(5). 39 40 OPTIONS 41 -a Display all of the current ARP entries. The definition 42 for the flags in the table are: 43 44 d Unverified; this is a local IP address that is 45 currently undergoing Duplicate Address Detection. 46 ARP will not respond to requests for this address 47 until Duplicate Address Detection completes. 48 49 50 o Old; this entry is aging away. If IP requests it 51 again, a new ARP query will be generated. This 52 state is used for detecting peer address changes. 53 54 55 y Delayed; periodic address defense and conflict 56 detection was unable to send a packet due to 57 58 59 60 SunOS 5.11 Last change: 25 Jul 2006 1 61 62 63 64 65 66 67 System Administration Commands arp(1M) 68 69 70 71 internal network use limits for non-traffic- 72 related messages (100 packets per hour per inter- 73 face). This occurs only on interfaces with very 74 large numbers of aliases. 75 76 77 A Authority; this machine is authoritative for this 78 IP address. ARP will not accept updates from 79 other machines for this entry. 80 81 82 L Local; this is a local IP address configured on 83 one of the machine's logical interfaces. ARP will 84 defend this address if another node attempts to 85 claim it. 86 87 88 M Mapping; only used for the multicast entry for 89 224.0.0.0 90 91 92 P Publish; includes IP address for the machine and 93 the addresses that have explicitly been added by 94 the -s option. ARP will respond to ARP requests 95 for this address. 96 97 98 S Static; entry cannot be changed by learned infor- 99 mation. This indicates that the permanent flag 100 was used when creating the entry. 101 102 103 U Unresolved; waiting for ARP response. 104 105 You can use the -n option with the -a option to dis- 106 able the automatic numeric IP address-to-name transla- 107 tion. Use arp -an or arp -na to display numeric IP 108 addresses. The arp -a option is equivalent to: 109 110 # netstat -p -f inet 111 112 113 ...and -an and -na are equivalent to: 114 115 # netstat -pn -f inet 116 117 118 119 120 -d Delete an entry for the host called hostname. 121 122 Note that ARP entries for IPMP data and test addresses 123 are managed by the kernel, and thus cannot be deleted. 124 125 126 127 128 SunOS 5.11 Last change: 25 Jul 2006 2 129 130 131 132 133 134 135 System Administration Commands arp(1M) 136 137 138 139 -f Read the file named filename and set multiple entries 140 in the ARP tables. Entries in the file should be of 141 the form: 142 143 hostname MACaddress [temp] [pub] [trail] [permanent] 144 145 146 See the -s option for argument definitions. 147 148 149 -s Create an ARP entry for the host called hostname with 150 the MAC address MACaddress. For example, an Ethernet 151 address is given as six hexadecimal bytes separated by 152 colons. The entry will not be subject to deletion by 153 aging unless the word temp is specified in the com- 154 mand. If the word pub is specified, the entry will be 155 published, which means that this system will respond 156 to ARP requests for hostname even though the hostname 157 is not its own. The word permanent indicates that the 158 system will not accept MAC address changes for host- 159 name from the network. 160 161 Solaris does not implement trailer encapsulation, and 162 the word trail is accepted on entries for compatibil- 163 ity only. 164 165 arp -s can be used for a limited form of proxy ARP 166 when a host on one of the directly attached networks 167 is not physically present on a subnet. Another machine 168 can then be configured to respond to ARP requests 169 using arp -s. This is useful in certain SLIP confi- 170 gurations. 171 172 Non-temporary proxy ARP entries for an IPMP group are 173 automatically managed by the kernel. Specifically, if 174 the hardware address in an entry matches the hardware 175 address of an IP interface in an IPMP group, and the 176 IP address is not local to the system, this will be 177 regarded as an IPMP proxy ARP entry. This entry will 178 have its hardware address automatically adjusted in 179 order to keep the IP address reachable so long as the 180 IPMP group has not entirely failed. 181 182 ARP entries must be consistent across an IPMP group. 183 Therefore, ARP entries cannot be associated with 184 individual underlying IP interfaces in an IPMP group, 185 and must instead be associated with the corresponding 186 IPMP IP interface. 187 188 Note that ARP entries for IPMP data and test addresses 189 are managed by the kernel, and thus cannot be changed. 190 191 192 ATTRIBUTES 193 See attributes(5) for descriptions of the following attri- 194 butes: 195 196 197 198 ____________________________________________________________ 199 | ATTRIBUTE TYPE | ATTRIBUTE VALUE | 200 |_____________________________|_____________________________| 201 | Availability | SUNWcsu | 202 |_____________________________|_____________________________| 203 204 205 SEE ALSO 206 ifconfig(1M), netstat(1M), attributes(5), privileges(5), 207 arp(7P) 208 209 210 211 212 213 SunOS 5.11 Last change: 25 Jul 2006 3 214 215 216