usr/src/man/man1m/arp.1m

   1 '\" te
   2 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
   3 .\" Copyright 1989 AT&T
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH ARP 1M "Sep 02, 2015"
   8 .SH NAME
   9 arp \- address resolution display and control
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBarp\fR \fIhostname\fR
  14 .fi
  15
  16 .LP
  17 .nf
  18 \fBarp\fR \fB-a\fR [\fB-n\fR]
  19 .fi
  20
  21 .LP
  22 .nf
  23 \fBarp\fR \fB-d\fR \fIhostname\fR
  24 .fi
  25
  26 .LP
  27 .nf
  28 \fBarp\fR \fB-f\fR \fIfilename\fR
  29 .fi
  30
  31 .LP
  32 .nf
  33 \fBarp\fR \fB-s\fR \fIhostname\fR \fIether_address\fR [temp] [pub] [trail]
  34      [permanent]
  35 .fi
  36
  37 .SH DESCRIPTION
  38 .LP
  39 The \fBarp\fR program displays and modifies the Internet-to-MAC address
  40 translation tables used by the address resolution protocol (see \fBarp\fR(7P)).
  41 .sp
  42 .LP
  43 With no flags, the program displays the current \fBARP\fR entry for
  44 \fIhostname\fR. The host may be specified by name or by number, using Internet
  45 dot notation.
  46 .sp
  47 .LP
  48 Options that modify the ARP translation tables (\fB-d\fR, \fB-f\fR, and
  49 \fB-s\fR) can be used only when the invoked command is granted the
  50 \fBPRIV_SYS_NET_CONFIG\fR privilege. See \fBprivileges\fR(5).
  51 .SH OPTIONS
  52 .ne 2
  53 .na
  54 \fB\fB-a\fR\fR
  55 .ad
  56 .RS 6n
  57 Display all of the current \fBARP\fR entries. The definition for the flags in
  58 the table are:
  59 .sp
  60 .ne 2
  61 .na
  62 \fB\fBd\fR\fR
  63 .ad
  64 .RS 5n
  65 Unverified; this is a local IP address that is currently undergoing Duplicate
  66 Address Detection. ARP will not respond to requests for this address until
  67 Duplicate Address Detection completes.
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fBo\fR\fR
  74 .ad
  75 .RS 5n
  76 Old; this entry is aging away. If IP requests it again, a new ARP query will be
  77 generated. This state is used for detecting peer address changes.
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fB\fBy\fR\fR
  84 .ad
  85 .RS 5n
  86 Delayed; periodic address defense and conflict detection was unable to send a
  87 packet due to internal network use limits for non-traffic-related messages (100
  88 packets per hour per interface). This occurs only on interfaces with very large
  89 numbers of aliases.
  90 .RE
  91
  92 .sp
  93 .ne 2
  94 .na
  95 \fB\fBA\fR\fR
  96 .ad
  97 .RS 5n
  98 Authority; this machine is authoritative for this IP address. ARP will not
  99 accept updates from other machines for this entry.
 100 .RE
 101
 102 .sp
 103 .ne 2
 104 .na
 105 \fB\fBL\fR\fR
 106 .ad
 107 .RS 5n
 108 Local; this is a local IP address configured on one of the machine's logical
 109 interfaces. ARP will defend this address if another node attempts to claim it.
 110 .RE
 111
 112 .sp
 113 .ne 2
 114 .na
 115 \fB\fBM\fR\fR
 116 .ad
 117 .RS 5n
 118 Mapping; only used for the multicast entry for \fB224.0.0.0\fR
 119 .RE
 120
 121 .sp
 122 .ne 2
 123 .na
 124 \fB\fBP\fR\fR
 125 .ad
 126 .RS 5n
 127 Publish; includes IP address for the machine and the addresses that have
 128 explicitly been added by the \fB-s\fR option. ARP will respond to ARP requests
 129 for this address.
 130 .RE
 131
 132 .sp
 133 .ne 2
 134 .na
 135 \fB\fBS\fR\fR
 136 .ad
 137 .RS 5n
 138 Static; entry cannot be changed by learned information. This indicates that the
 139 \fBpermanent\fR flag was used when creating the entry.
 140 .RE
 141
 142 .sp
 143 .ne 2
 144 .na
 145 \fB\fBU\fR\fR
 146 .ad
 147 .RS 5n
 148 Unresolved; waiting for ARP response.
 149 .RE
 150
 151 You can use the \fB-n\fR option with the \fB-a\fR option to disable the
 152 automatic numeric IP address-to-name translation. Use \fBarp\fR \fB-an\fR or
 153 \fBarp\fR \fB-na\fR to display numeric IP addresses. The \fBarp\fR \fB-a\fR
 154 option is equivalent to:
 155 .sp
 156 .in +2
 157 .nf
 158 # \fBnetstat -p -f inet\fR
 159 .fi
 160 .in -2
 161 .sp
 162
 163 \&...and \fB-an\fR and \fB-na\fR are equivalent to:
 164 .sp
 165 .in +2
 166 .nf
 167 # \fBnetstat -pn -f inet\fR
 168 .fi
 169 .in -2
 170 .sp
 171
 172 .RE
 173
 174 .sp
 175 .ne 2
 176 .na
 177 \fB\fB-d\fR\fR
 178 .ad
 179 .RS 6n
 180 Delete an entry for the host called \fIhostname\fR.
 181 .sp
 182 Note that ARP entries for IPMP (IP Network Multipathing) data and test
 183 addresses are managed by the kernel and thus cannot be deleted.
 184 .RE
 185
 186 .sp
 187 .ne 2
 188 .na
 189 \fB\fB-f\fR\fR
 190 .ad
 191 .RS 6n
 192 Read the file named \fIfilename\fR and set multiple entries in the \fBARP\fR
 193 tables. Entries in the file should be of the form:
 194 .sp
 195 .in +2
 196 .nf
 197 \fIhostname\fR \fIMACaddress\fR [temp] [pub] [trail] [permanent]
 198 .fi
 199 .in -2
 200 .sp
 201
 202 See the \fB-s\fR option for argument definitions.
 203 .RE
 204
 205 .sp
 206 .ne 2
 207 .na
 208 \fB\fB-s\fR\fR
 209 .ad
 210 .RS 6n
 211 Create an \fBARP\fR entry for the host called \fIhostname\fR with the MAC
 212 address \fIMACaddress\fR. For example, an Ethernet address is given as six
 213 hexadecimal bytes separated by colons. The entry will not be subject to
 214 deletion by aging unless the word \fBtemp\fR is specified in the command. If
 215 the word \fBpub\fR is specified, the entry will be published, which means that
 216 this system will respond to ARP requests for \fIhostname\fR even though the
 217 \fIhostname\fR is not its own. The word \fBpermanent\fR indicates that the
 218 system will not accept MAC address changes for \fIhostname\fR from the network.
 219 .sp
 220 Solaris does not implement trailer encapsulation, and the word \fBtrail\fR is
 221 accepted on entries for compatibility only.
 222 .sp
 223 \fBarp\fR \fB-s\fR can be used for a limited form of proxy ARP when a host on
 224 one of the directly attached networks is not physically present on a subnet.
 225 Another machine can then be configured to respond to ARP requests using
 226 \fBarp\fR \fB-s\fR. This is useful in certain SLIP configurations.
 227 .sp
 228 Non-temporary proxy ARP entries for an IPMP (IP Network Multipathing) group are
 229 automatically managed by the kernel. Specifically, if the hardware address in
 230 an entry matches the hardware address of an IP interface in an IPMP group, and
 231 the IP address is not local to the system, this will be regarded as an IPMP
 232 proxy ARP entry. This entry will have its hardware address automatically
 233 adjusted in order to keep the IP address reachable so long as the IPMP group
 234 has not entirely failed.
 235 .sp
 236 ARP entries must be consistent across an IPMP group. Therefore, ARP entries
 237 cannot be associated with individual underlying IP interfaces in an IPMP group,
 238 and must instead be associated with the corresponding IPMP IP interface.
 239 .sp
 240 Note that ARP entries for IPMP data and test addresses are managed by the
 241 kernel and thus cannot be changed.
 242 .RE
 243
 244 .SH SEE ALSO
 245 .LP
 246 \fBifconfig\fR(1M), \fBnetstat\fR(1M), \fBndp\fR(1M), \fBattributes\fR(5),
 247 \fBprivileges\fR(5), \fBarp\fR(7P)