7  * \defgroup uiparp uIP Address Resolution Protocol 
  10  * The Address Resolution Protocol ARP is used for mapping between IP 
  11  * addresses and link level addresses such as the Ethernet MAC 
  12  * addresses. ARP uses broadcast queries to ask for the link level 
  13  * address of a known IP address and the host which is configured with 
  14  * the IP address for which the query was meant, will respond with its 
  17  * \note This ARP implementation only supports Ethernet. 
  22  * Implementation of the ARP Address Resolution Protocol. 
  23  * \author Adam Dunkels <adam@dunkels.com> 
  28  * Copyright (c) 2001-2003, Adam Dunkels. 
  29  * All rights reserved. 
  31  * Redistribution and use in source and binary forms, with or without 
  32  * modification, are permitted provided that the following conditions 
  34  * 1. Redistributions of source code must retain the above copyright 
  35  *    notice, this list of conditions and the following disclaimer. 
  36  * 2. Redistributions in binary form must reproduce the above copyright 
  37  *    notice, this list of conditions and the following disclaimer in the 
  38  *    documentation and/or other materials provided with the distribution. 
  39  * 3. The name of the author may not be used to endorse or promote 
  40  *    products derived from this software without specific prior 
  43  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS 
  44  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
  45  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
  46  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY 
  47  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
  48  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 
  49  * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
  50  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
  51  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 
  52  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 
  53  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
  55  * This file is part of the uIP TCP/IP stack. 
  57  * $Id: uip_arp.c,v 1.5 2008/02/07 01:35:00 adamdunkels Exp $ 
  67   struct uip_eth_hdr ethhdr
; 
  73   struct uip_eth_addr shwaddr
; 
  75   struct uip_eth_addr dhwaddr
; 
  80   struct uip_eth_hdr ethhdr
; 
  90   uip_ipaddr_t srcipaddr
, destipaddr
; 
  96 #define ARP_HWTYPE_ETH 1 
 100   struct uip_eth_addr ethaddr
; 
 104 static const struct uip_eth_addr broadcast_ethaddr 
= 
 105   {{0xff,0xff,0xff,0xff,0xff,0xff}}; 
 106 static const u16_t broadcast_ipaddr
[2] = {0xffff,0xffff}; 
 108 static struct arp_entry arp_table
[UIP_ARPTAB_SIZE
]; 
 109 static uip_ipaddr_t ipaddr
; 
 115 #define BUF   ((struct arp_hdr *)&uip_buf[0]) 
 116 #define IPBUF ((struct ethip_hdr *)&uip_buf[0]) 
 121 #define PRINTF(...) printf(__VA_ARGS__) 
 126 /*-----------------------------------------------------------------------------------*/ 
 128  * Initialize the ARP module. 
 131 /*-----------------------------------------------------------------------------------*/ 
 135   for(i 
= 0; i 
< UIP_ARPTAB_SIZE
; ++i
) { 
 136     memset(&arp_table
[i
].ipaddr
, 0, 4); 
 139 /*-----------------------------------------------------------------------------------*/ 
 141  * Periodic ARP processing function. 
 143  * This function performs periodic timer processing in the ARP module 
 144  * and should be called at regular intervals. The recommended interval 
 145  * is 10 seconds between the calls. 
 148 /*-----------------------------------------------------------------------------------*/ 
 152   struct arp_entry 
*tabptr 
= NULL
; 
 155   for(i 
= 0; i 
< UIP_ARPTAB_SIZE
; ++i
) { 
 156     tabptr 
= &arp_table
[i
]; 
 157     if(uip_ipaddr_cmp(&tabptr
->ipaddr
, &uip_all_zeroes_addr
) && 
 158        arptime 
- tabptr
->time 
>= UIP_ARP_MAXAGE
) { 
 159       memset(&tabptr
->ipaddr
, 0, 4); 
 164 /*-----------------------------------------------------------------------------------*/ 
 166 uip_arp_update(uip_ipaddr_t 
*ipaddr
, struct uip_eth_addr 
*ethaddr
) 
 168   register struct arp_entry 
*tabptr 
= NULL
; 
 169   /* Walk through the ARP mapping table and try to find an entry to 
 170      update. If none is found, the IP -> MAC address mapping is 
 171      inserted in the ARP table. */ 
 172   for(i 
= 0; i 
< UIP_ARPTAB_SIZE
; ++i
) { 
 174     tabptr 
= &arp_table
[i
]; 
 175     /* Only check those entries that are actually in use. */ 
 176     if(!uip_ipaddr_cmp(&tabptr
->ipaddr
, &uip_all_zeroes_addr
)) { 
 178       /* Check if the source IP address of the incoming packet matches 
 179          the IP address in this ARP table entry. */ 
 180       if(uip_ipaddr_cmp(ipaddr
, &tabptr
->ipaddr
)) { 
 182         /* An old entry found, update this and return. */ 
 183         memcpy(tabptr
->ethaddr
.addr
, ethaddr
->addr
, 6); 
 184         tabptr
->time 
= arptime
; 
 191   /* If we get here, no existing ARP table entry was found, so we 
 194   /* First, we try to find an unused entry in the ARP table. */ 
 195   for(i 
= 0; i 
< UIP_ARPTAB_SIZE
; ++i
) { 
 196     tabptr 
= &arp_table
[i
]; 
 197     if(uip_ipaddr_cmp(&tabptr
->ipaddr
, &uip_all_zeroes_addr
)) { 
 202   /* If no unused entry is found, we try to find the oldest entry and 
 204   if(i 
== UIP_ARPTAB_SIZE
) { 
 207     for(i 
= 0; i 
< UIP_ARPTAB_SIZE
; ++i
) { 
 208       tabptr 
= &arp_table
[i
]; 
 209       if(arptime 
- tabptr
->time 
> tmpage
) { 
 210         tmpage 
= arptime 
- tabptr
->time
; 
 215     tabptr 
= &arp_table
[i
]; 
 218   /* Now, i is the ARP table entry which we will fill with the new 
 220   uip_ipaddr_copy(&tabptr
->ipaddr
, ipaddr
); 
 221   memcpy(tabptr
->ethaddr
.addr
, ethaddr
->addr
, 6); 
 222   tabptr
->time 
= arptime
; 
 224 /*-----------------------------------------------------------------------------------*/ 
 226  * ARP processing for incoming IP packets 
 228  * This function should be called by the device driver when an IP 
 229  * packet has been received. The function will check if the address is 
 230  * in the ARP cache, and if so the ARP cache entry will be 
 231  * refreshed. If no ARP cache entry was found, a new one is created. 
 233  * This function expects an IP packet with a prepended Ethernet header 
 234  * in the uip_buf[] buffer, and the length of the packet in the global 
 237 /*-----------------------------------------------------------------------------------*/ 
 242   uip_len 
-= sizeof(struct uip_eth_hdr
); 
 244   /* Only insert/update an entry if the source IP address of the 
 245      incoming IP packet comes from a host on the local network. */ 
 246   if((IPBUF
->srcipaddr
[0] & uip_netmask
[0]) != 
 247      (uip_hostaddr
[0] & uip_netmask
[0])) { 
 250   if((IPBUF
->srcipaddr
[1] & uip_netmask
[1]) != 
 251      (uip_hostaddr
[1] & uip_netmask
[1])) { 
 254   uip_arp_update(IPBUF
->srcipaddr
, &(IPBUF
->ethhdr
.src
)); 
 259 /*-----------------------------------------------------------------------------------*/ 
 261  * ARP processing for incoming ARP packets. 
 263  * This function should be called by the device driver when an ARP 
 264  * packet has been received. The function will act differently 
 265  * depending on the ARP packet type: if it is a reply for a request 
 266  * that we previously sent out, the ARP cache will be filled in with 
 267  * the values from the ARP reply. If the incoming ARP packet is an ARP 
 268  * request for our IP address, an ARP reply packet is created and put 
 269  * into the uip_buf[] buffer. 
 271  * When the function returns, the value of the global variable uip_len 
 272  * indicates whether the device driver should send out a packet or 
 273  * not. If uip_len is zero, no packet should be sent. If uip_len is 
 274  * non-zero, it contains the length of the outbound packet that is 
 275  * present in the uip_buf[] buffer. 
 277  * This function expects an ARP packet with a prepended Ethernet 
 278  * header in the uip_buf[] buffer, and the length of the packet in the 
 279  * global variable uip_len. 
 281 /*-----------------------------------------------------------------------------------*/ 
 285   if(uip_len 
< sizeof(struct arp_hdr
)) { 
 291   switch(BUF
->opcode
) { 
 292   case HTONS(ARP_REQUEST
): 
 293     /* ARP request. If it asked for our address, we send out a 
 295     /*    if(BUF->dipaddr[0] == uip_hostaddr[0] && 
 296           BUF->dipaddr[1] == uip_hostaddr[1]) {*/ 
 297     PRINTF("uip_arp_arpin: request for %d.%d.%d.%d (we are %d.%d.%d.%d)\n", 
 298            BUF
->dipaddr
.u8
[0], BUF
->dipaddr
.u8
[1], 
 299            BUF
->dipaddr
.u8
[2], BUF
->dipaddr
.u8
[3], 
 300            uip_hostaddr
.u8
[0], uip_hostaddr
.u8
[1], 
 301            uip_hostaddr
.u8
[2], uip_hostaddr
.u8
[3]); 
 302     if(uip_ipaddr_cmp(&BUF
->dipaddr
, &uip_hostaddr
)) { 
 303       /* First, we register the one who made the request in our ARP 
 304          table, since it is likely that we will do more communication 
 305          with this host in the future. */ 
 306       uip_arp_update(&BUF
->sipaddr
, &BUF
->shwaddr
); 
 308       BUF
->opcode 
= HTONS(ARP_REPLY
); 
 310       memcpy(BUF
->dhwaddr
.addr
, BUF
->shwaddr
.addr
, 6); 
 311       memcpy(BUF
->shwaddr
.addr
, uip_ethaddr
.addr
, 6); 
 312       memcpy(BUF
->ethhdr
.src
.addr
, uip_ethaddr
.addr
, 6); 
 313       memcpy(BUF
->ethhdr
.dest
.addr
, BUF
->dhwaddr
.addr
, 6); 
 315       uip_ipaddr_copy(&BUF
->dipaddr
, &BUF
->sipaddr
); 
 316       uip_ipaddr_copy(&BUF
->sipaddr
, &uip_hostaddr
); 
 318       BUF
->ethhdr
.type 
= HTONS(UIP_ETHTYPE_ARP
); 
 319       uip_len 
= sizeof(struct arp_hdr
); 
 322   case HTONS(ARP_REPLY
): 
 323     /* ARP reply. We insert or update the ARP table if it was meant 
 325     if(uip_ipaddr_cmp(&BUF
->dipaddr
, &uip_hostaddr
)) { 
 326       uip_arp_update(&BUF
->sipaddr
, &BUF
->shwaddr
); 
 333 /*-----------------------------------------------------------------------------------*/ 
 335  * Prepend Ethernet header to an outbound IP packet and see if we need 
 336  * to send out an ARP request. 
 338  * This function should be called before sending out an IP packet. The 
 339  * function checks the destination IP address of the IP packet to see 
 340  * what Ethernet MAC address that should be used as a destination MAC 
 341  * address on the Ethernet. 
 343  * If the destination IP address is in the local network (determined 
 344  * by logical ANDing of netmask and our IP address), the function 
 345  * checks the ARP cache to see if an entry for the destination IP 
 346  * address is found. If so, an Ethernet header is prepended and the 
 347  * function returns. If no ARP cache entry is found for the 
 348  * destination IP address, the packet in the uip_buf[] is replaced by 
 349  * an ARP request packet for the IP address. The IP packet is dropped 
 350  * and it is assumed that they higher level protocols (e.g., TCP) 
 351  * eventually will retransmit the dropped packet. 
 353  * If the destination IP address is not on the local network, the IP 
 354  * address of the default router is used instead. 
 356  * When the function returns, a packet is present in the uip_buf[] 
 357  * buffer, and the length of the packet is in the global variable 
 360 /*-----------------------------------------------------------------------------------*/ 
 364   struct arp_entry 
*tabptr 
= NULL
; 
 366   /* Find the destination IP address in the ARP table and construct 
 367      the Ethernet header. If the destination IP address isn't on the 
 368      local network, we use the default router's IP address instead. 
 370      If not ARP table entry is found, we overwrite the original IP 
 371      packet with an ARP request for the IP address. */ 
 373   /* First check if destination is a local broadcast. */ 
 374   if(uip_ipaddr_cmp(&IPBUF
->destipaddr
, &uip_broadcast_addr
)) { 
 375     memcpy(IPBUF
->ethhdr
.dest
.addr
, broadcast_ethaddr
.addr
, 6); 
 377     /* Check if the destination address is on the local network. */ 
 378     if(!uip_ipaddr_maskcmp(&IPBUF
->destipaddr
, &uip_hostaddr
, &uip_netmask
)) { 
 379       /* Destination address was not on the local network, so we need to 
 380          use the default router's IP address instead of the destination 
 381          address when determining the MAC address. */ 
 382       uip_ipaddr_copy(&ipaddr
, &uip_draddr
); 
 384       /* Else, we use the destination IP address. */ 
 385       uip_ipaddr_copy(&ipaddr
, &IPBUF
->destipaddr
); 
 388     for(i 
= 0; i 
< UIP_ARPTAB_SIZE
; ++i
) { 
 389       tabptr 
= &arp_table
[i
]; 
 390       if(uip_ipaddr_cmp(&ipaddr
, &tabptr
->ipaddr
)) { 
 395     if(i 
== UIP_ARPTAB_SIZE
) { 
 396       /* The destination address was not in our ARP table, so we 
 397          overwrite the IP packet with an ARP request. */ 
 399       memset(BUF
->ethhdr
.dest
.addr
, 0xff, 6); 
 400       memset(BUF
->dhwaddr
.addr
, 0x00, 6); 
 401       memcpy(BUF
->ethhdr
.src
.addr
, uip_ethaddr
.addr
, 6); 
 402       memcpy(BUF
->shwaddr
.addr
, uip_ethaddr
.addr
, 6); 
 404       uip_ipaddr_copy(&BUF
->dipaddr
, &ipaddr
); 
 405       uip_ipaddr_copy(&BUF
->sipaddr
, &uip_hostaddr
); 
 406       BUF
->opcode 
= HTONS(ARP_REQUEST
); /* ARP request. */ 
 407       BUF
->hwtype 
= HTONS(ARP_HWTYPE_ETH
); 
 408       BUF
->protocol 
= HTONS(UIP_ETHTYPE_IP
); 
 411       BUF
->ethhdr
.type 
= HTONS(UIP_ETHTYPE_ARP
); 
 413       uip_appdata 
= &uip_buf
[UIP_TCPIP_HLEN 
+ UIP_LLH_LEN
]; 
 415       uip_len 
= sizeof(struct arp_hdr
); 
 419     /* Build an ethernet header. */ 
 420     memcpy(IPBUF
->ethhdr
.dest
.addr
, tabptr
->ethaddr
.addr
, 6); 
 422   memcpy(IPBUF
->ethhdr
.src
.addr
, uip_ethaddr
.addr
, 6); 
 424   IPBUF
->ethhdr
.type 
= HTONS(UIP_ETHTYPE_IP
); 
 426   uip_len 
+= sizeof(struct uip_eth_hdr
); 
 428 /*-----------------------------------------------------------------------------------*/