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 
 123 
 124 
 125 
 126 SunOS 5.11          Last change: 25 Jul 2006                    2
 127 
 128 
 129 
 130 
 131 
 132 
 133 System Administration Commands                            arp(1M)
 134 
 135 
 136 
 137      -f    Read the file named filename and set multiple  entries
 138            in  the  ARP  tables. Entries in the file should be of
 139            the form:
 140 
 141              hostname MACaddress [temp] [pub] [trail] [permanent]
 142 
 143 
 144            See the -s option for argument definitions.
 145 
 146 
 147      -s    Create an ARP entry for the host called hostname  with
 148            the  MAC  address MACaddress. For example, an Ethernet
 149            address is given as six hexadecimal bytes separated by
 150            colons.  The  entry will not be subject to deletion by
 151            aging unless the word temp is specified  in  the  com-
 152            mand.  If the word pub is specified, the entry will be
 153            published, which means that this system  will  respond
 154            to  ARP requests for hostname even though the hostname
 155            is not its own. The word permanent indicates that  the
 156            system  will  not accept MAC address changes for host-
 157            name from the network.
 158 
 159            Solaris does not implement trailer encapsulation,  and
 160            the  word trail is accepted on entries for compatibil-
 161            ity only.
 162 
 163            arp -s can be used for a limited  form  of  proxy  ARP
 164            when  a  host on one of the directly attached networks
 165            is not physically present on a subnet. Another machine
 166            can  then  be  configured  to  respond to ARP requests
 167            using arp -s. This is useful in  certain  SLIP  confi-
 168            gurations.
 169 
 170 
 171 ATTRIBUTES
 172      See attributes(5) for descriptions of the  following  attri-
 173      butes:
 174 
 175 
 176 
 177      ____________________________________________________________
 178     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
 179     |_____________________________|_____________________________|
 180     | Availability                | SUNWcsu                     |
 181     |_____________________________|_____________________________|
 182 
 183 
 184 SEE ALSO
 185      ifconfig(1M),  netstat(1M),  attributes(5),   privileges(5),
 186      arp(7P)
 187 
 188 
 189 
 190 
 191 
 192 SunOS 5.11          Last change: 25 Jul 2006                    3
 193 
 194 
 195