Manual Pages for UNIX Operating System command usage for man arp

System Administration Commands                            arp(1M)



NAME
     arp - address resolution display and control

SYNOPSIS
     arp hostname


     arp -a [-n]


     arp -d hostname


     arp -f filename


     arp -s hostname ether_address [temp] [pub] [trail]
          [permanent]


DESCRIPTION
     The arp program displays and  modifies  the  Internet-to-MAC
     address  translation  tables  used by the address resolution
     protocol (see arp(7P)).


     With no flags, the program displays the  current  ARP  entry
     for  hostname.  The  host  may  be  specified  by name or by
     number, using Internet dot notation.


     Options that modify the ARP translation tables (-d, -f,  and
     -s) can be used only when the invoked command is granted the
     sys_net_config privilege. See privileges(5).

OPTIONS
     -a    Display all of the current ARP entries. The definition
           for the flags in the table are:

           d    Unverified; this is a local IP  address  that  is
                currently undergoing Duplicate Address Detection.
                ARP will not respond to requests for this address
                until Duplicate Address Detection completes.


           o    Old; this entry is aging away. If IP requests  it
                again,  a  new  ARP query will be generated. This
                state is used for detecting peer address changes.


           y    Delayed; periodic address  defense  and  conflict
                detection  was  unable  to  send  a packet due to



SunOS 5.11           Last change: 5 Jan 2009                    1






System Administration Commands                            arp(1M)



                internal  network  use  limits  for  non-traffic-
                related messages (100 packets per hour per inter-
                face). This occurs only on interfaces  with  very
                large numbers of aliases.


           A    Authority; this machine is authoritative for this
                IP  address.  ARP  will  not  accept updates from
                other machines for this entry.


           L    Local; this is a local IP address  configured  on
                one of the machine's logical interfaces. ARP will
                defend this address if another node  attempts  to
                claim it.


           M    Mapping; only used for the  multicast  entry  for
                224.0.0.0


           P    Publish; includes IP address for the machine  and
                the  addresses that have explicitly been added by
                the -s option. ARP will respond to  ARP  requests
                for this address.


           S    Static; entry cannot be changed by learned infor-
                mation.  This  indicates  that the permanent flag
                was used when creating the entry.


           U    Unresolved; waiting for ARP response.

           You can use the -n option with the -a option  to  dis-
           able the automatic numeric IP address-to-name transla-
           tion. Use arp -an or arp -na  to  display  numeric  IP
           addresses. The arp -a option is equivalent to:

             # netstat -p -f inet


           ...and -an and -na are equivalent to:

             # netstat -pn -f inet




     -d    Delete an entry for the host called hostname.

           Note  that  ARP   entries   for   IPMP   (IP   Network



SunOS 5.11           Last change: 5 Jan 2009                    2






System Administration Commands                            arp(1M)



           Multipathing)  data  and test addresses are managed by
           the kernel and thus cannot be deleted.


     -f    Read the file named filename and set multiple  entries
           in  the  ARP  tables. Entries in the file should be of
           the form:

             hostname MACaddress [temp] [pub] [trail] [permanent]


           See the -s option for argument definitions.


     -s    Create an ARP entry for the host called hostname  with
           the  MAC  address MACaddress. For example, an Ethernet
           address is given as six hexadecimal bytes separated by
           colons.  The  entry will not be subject to deletion by
           aging unless the word temp is specified  in  the  com-
           mand.  If the word pub is specified, the entry will be
           published, which means that this system  will  respond
           to  ARP requests for hostname even though the hostname
           is not its own. The word permanent indicates that  the
           system  will  not accept MAC address changes for host-
           name from the network.

           Solaris does not implement trailer encapsulation,  and
           the  word trail is accepted on entries for compatibil-
           ity only.

           arp -s can be used for a limited  form  of  proxy  ARP
           when  a  host on one of the directly attached networks
           is not physically present on a subnet. Another machine
           can  then  be  configured  to  respond to ARP requests
           using arp -s. This is useful in  certain  SLIP  confi-
           gurations.

           Non-temporary proxy ARP entries for an IPMP  (IP  Net-
           work  Multipathing) group are automatically managed by
           the kernel. Specifically, if the hardware  address  in
           an  entry matches the hardware address of an IP inter-
           face in an IPMP group, and the IP address is not local
           to  the system, this will be regarded as an IPMP proxy
           ARP entry. This entry will have its  hardware  address
           automatically adjusted in order to keep the IP address
           reachable so long as the IPMP group has  not  entirely
           failed.

           ARP entries must be consistent across an  IPMP  group.
           Therefore, ARP entries cannot be associated with indi-
           vidual underlying IP interfaces in an IPMP group,  and
           must instead be associated with the corresponding IPMP



SunOS 5.11           Last change: 5 Jan 2009                    3






System Administration Commands                            arp(1M)



           IP interface.

           Note that ARP entries for IPMP data and test addresses
           are managed by the kernel and thus cannot be changed.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|


SEE ALSO
     ifconfig(1M),  netstat(1M),  attributes(5),   privileges(5),
     arp(7P)

































SunOS 5.11           Last change: 5 Jan 2009                    4