arp(1m) - osol9

1arp(1M)                 System Administration Commands                 arp(1M)
2
3
4

NAME

6       arp - address resolution display and control
7

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

DESCRIPTION

26       The  arp  program  displays  and  modifies  the Internet-to-MAC address
27       translation  tables  used  by  the  address  resolution  protocol  (see
28       arp(7P)).
29
30
31       With no flags, the program displays the current ARP entry for hostname.
32       The host may be specified by name or  by  number,  using  Internet  dot
33       notation.
34
35
36       Options  that modify the ARP translation tables (-d, -f, and -s) can be
37       used only when the invoked command is granted the sys_net_config privi‐
38       lege. See privileges(5).
39

OPTIONS

41       -a    Display  all  of  the current ARP entries. The definition for the
42             flags in the table are:
43
44             d    Unverified; this is a local IP  address  that  is  currently
45                  undergoing Duplicate Address Detection. ARP will not respond
46                  to requests for this address until Duplicate Address  Detec‐
47                  tion completes.
48
49
50             o    Old;  this  entry  is aging away. If IP requests it again, a
51                  new ARP query will be generated.  This  state  is  used  for
52                  detecting peer address changes.
53
54
55             y    Delayed; periodic address defense and conflict detection was
56                  unable to send a packet due to internal network  use  limits
57                  for  non-traffic-related  messages (100 packets per hour per
58                  interface). This occurs only on interfaces with  very  large
59                  numbers of aliases.
60
61
62             A    Authority;   this  machine  is  authoritative  for  this  IP
63                  address. ARP will not accept updates from other machines for
64                  this entry.
65
66
67             L    Local;  this  is a local IP address configured on one of the
68                  machine's logical interfaces. ARP will defend  this  address
69                  if another node attempts to claim it.
70
71
72             M    Mapping; only used for the multicast entry for 224.0.0.0
73
74
75             P    Publish;  includes  IP  address  for  the  machine  and  the
76                  addresses that have explicitly been added by the -s  option.
77                  ARP will respond to ARP requests for this address.
78
79
80             S    Static; entry cannot be changed by learned information. This
81                  indicates that the permanent flag was used when creating the
82                  entry.
83
84
85             U    Unresolved; waiting for ARP response.
86
87             You can use the -n option with the -a option to disable the auto‐
88             matic numeric IP address-to-name translation. Use arp -an or  arp
89             -na to display numeric IP addresses. The arp -a option is equiva‐
90             lent to:
91
92               # netstat -p -f inet
93
94
95             ...and -an and -na are equivalent to:
96
97               # netstat -pn -f inet
98
99
100
101
102       -d    Delete an entry for the host called hostname.
103
104             Note that ARP entries for IPMP (IP Network Multipathing) data and
105             test  addresses  are  managed  by  the  kernel and thus cannot be
106             deleted.
107
108
109       -f    Read the file named filename and set multiple entries in the  ARP
110             tables. Entries in the file should be of the form:
111
112               hostname MACaddress [temp] [pub] [trail] [permanent]
113
114
115             See the -s option for argument definitions.
116
117
118       -s    Create  an  ARP  entry  for the host called hostname with the MAC
119             address MACaddress. For example, an Ethernet address is given  as
120             six  hexadecimal bytes separated by colons. The entry will not be
121             subject to deletion by aging unless the word temp is specified in
122             the command. If the word pub is specified, the entry will be pub‐
123             lished, which means that this system will respond to ARP requests
124             for  hostname  even  though the hostname is not its own. The word
125             permanent indicates that the system will not accept  MAC  address
126             changes for hostname from the network.
127
128             Solaris  does  not  implement trailer encapsulation, and the word
129             trail is accepted on entries for compatibility only.
130
131             arp -s can be used for a limited form of proxy ARP when a host on
132             one  of  the directly attached networks is not physically present
133             on a subnet. Another machine can then be configured to respond to
134             ARP requests using arp -s. This is useful in certain SLIP config‐
135             urations.
136
137             Non-temporary proxy ARP entries for an IPMP  (IP  Network  Multi‐
138             pathing)  group are automatically managed by the kernel. Specifi‐
139             cally, if the hardware address in an entry matches  the  hardware
140             address  of  an IP interface in an IPMP group, and the IP address
141             is not local to the system, this will  be  regarded  as  an  IPMP
142             proxy  ARP entry. This entry will have its hardware address auto‐
143             matically adjusted in order to keep the IP address  reachable  so
144             long as the IPMP group has not entirely failed.
145
146             ARP  entries  must be consistent across an IPMP group. Therefore,
147             ARP entries cannot be associated with  individual  underlying  IP
148             interfaces  in an IPMP group, and must instead be associated with
149             the corresponding IPMP IP interface.
150
151             Note that ARP entries for IPMP data and test addresses  are  man‐
152             aged by the kernel and thus cannot be changed.
153
154

ATTRIBUTES

156       See attributes(5) for descriptions of the following attributes:
157
158
159
160
161       ┌─────────────────────────────┬─────────────────────────────┐
162       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
163       ├─────────────────────────────┼─────────────────────────────┤
164       │Availability                 │SUNWcsu                      │
165       └─────────────────────────────┴─────────────────────────────┘
166

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

ATTRIBUTES

SEE ALSO