EVE 1.0
uIP conversion functions
Collaboration diagram for uIP conversion functions:

Macros

#define uip_ipaddr_to_quad(a)
 
#define uip_ipaddr(addr, addr0, addr1, addr2, addr3)
 
#define uip_ip6addr(addr, addr0, addr1, addr2, addr3, addr4, addr5, addr6, addr7)
 
#define uip_ip6addr_u8(addr, addr0, addr1, addr2, addr3, addr4, addr5, addr6, addr7, addr8, addr9, addr10, addr11, addr12, addr13, addr14, addr15)
 
#define uip_ipaddr_copy(dest, src)
 
#define uip_ip4addr_cmp(addr1, addr2)
 
#define uip_ipaddr_maskcmp(addr1, addr2, mask)
 
#define uip_ipaddr_mask(dest, src, mask)
 
#define uip_ipaddr1(addr)
 
#define uip_ipaddr2(addr)
 
#define uip_ipaddr3(addr)
 
#define uip_ipaddr4(addr)
 
#define UIP_HTONS(n)
 
#define uiplib_ipaddrconv   uiplib_ip4addrconv
 

Functions

CCIF uint16_t uip_htons (uint16_t val)
 

Detailed Description

These functions can be used for converting between different data formats used by uIP.

Macro Definition Documentation

#define uip_ipaddr_to_quad (   a)

Convert an IP address to four bytes separated by commas.

Example:

1 uip_ipaddr_t ipaddr;
2 printf("ipaddr=%d.%d.%d.%d\n", uip_ipaddr_to_quad(&ipaddr));
Parameters
aA pointer to a uip_ipaddr_t.

Definition at line 937 of file uip.h.

#define uip_ipaddr (   addr,
  addr0,
  addr1,
  addr2,
  addr3 
)

Construct an IP address from four bytes.

This function constructs an IP address of the type that uIP handles internally from four bytes. The function is handy for specifying IP addresses to use with e.g. the uip_connect() function.

Example:

1 uip_ipaddr_t ipaddr;
2 struct uip_conn *c;
3 
4 uip_ipaddr(&ipaddr, 192,168,1,2);
5 c = uip_connect(&ipaddr, UIP_HTONS(80));
Parameters
addrA pointer to a uip_ipaddr_t variable that will be filled in with the IP address.
addr0The first octet of the IP address.
addr1The second octet of the IP address.
addr2The third octet of the IP address.
addr3The forth octet of the IP address.

Definition at line 965 of file uip.h.

Referenced by tcpip_output().

#define uip_ip6addr (   addr,
  addr0,
  addr1,
  addr2,
  addr3,
  addr4,
  addr5,
  addr6,
  addr7 
)

Construct an IPv6 address from eight 16-bit words.

This function constructs an IPv6 address.

Definition at line 979 of file uip.h.

#define uip_ip6addr_u8 (   addr,
  addr0,
  addr1,
  addr2,
  addr3,
  addr4,
  addr5,
  addr6,
  addr7,
  addr8,
  addr9,
  addr10,
  addr11,
  addr12,
  addr13,
  addr14,
  addr15 
)

Construct an IPv6 address from sixteen 8-bit words.

This function constructs an IPv6 address.

Definition at line 997 of file uip.h.

#define uip_ipaddr_copy (   dest,
  src 
)

Copy an IP address from one place to another.

Copies an IP address from one place to another.

Example:

1 uip_ipaddr_t ipaddr1, ipaddr2;
2 
3 uip_ipaddr(&ipaddr1, 192,16,1,2);
4 uip_ipaddr_copy(&ipaddr2, &ipaddr1);
Parameters
destThe destination for the copy.
srcThe source from where to copy.

Definition at line 1036 of file uip.h.

Referenced by simple_udp_register(), uip_arp_arpin(), uip_arp_out(), uip_arp_timer(), uip_fw_init(), uip_init(), and uip_process().

#define uip_ip4addr_cmp (   addr1,
  addr2 
)

Compare two IP addresses

Compares two IP addresses.

Example:

1 uip_ipaddr_t ipaddr1, ipaddr2;
2 
3 uip_ipaddr(&ipaddr1, 192,16,1,2);
4 if(uip_ipaddr_cmp(&ipaddr2, &ipaddr1)) {
5  printf("They are the same");
6 }
Parameters
addr1The first IP address.
addr2The second IP address.

Definition at line 1065 of file uip.h.

#define uip_ipaddr_maskcmp (   addr1,
  addr2,
  mask 
)

Compare two IP addresses with netmasks

Compares two IP addresses with netmasks. The masks are used to mask out the bits that are to be compared.

Example:

1 uip_ipaddr_t ipaddr1, ipaddr2, mask;
2 
3 uip_ipaddr(&mask, 255,255,255,0);
4 uip_ipaddr(&ipaddr1, 192,16,1,2);
5 uip_ipaddr(&ipaddr2, 192,16,1,3);
6 if(uip_ipaddr_maskcmp(&ipaddr1, &ipaddr2, &mask)) {
7 printf("They are the same");
8 }
Parameters
addr1The first IP address.
addr2The second IP address.
maskThe netmask.

Definition at line 1100 of file uip.h.

Referenced by uip_arp_out().

#define uip_ipaddr_mask (   dest,
  src,
  mask 
)

Check if an address is a broadcast address for a network.

Checks if an address is the broadcast address for a network. The network is defined by an IP address that is on the network and the network's netmask.

Parameters
addrThe IP address.
netaddrThe network's IP address.
netmaskThe network's netmask. Mask out the network part of an IP address.

Masks out the network part of an IP address, given the address and the netmask.

Example:

1 uip_ipaddr_t ipaddr1, ipaddr2, netmask;
2 
3 uip_ipaddr(&ipaddr1, 192,16,1,2);
4 uip_ipaddr(&netmask, 255,255,255,0);
5 uip_ipaddr_mask(&ipaddr2, &ipaddr1, &netmask);

In the example above, the variable "ipaddr2" will contain the IP address 192.168.1.0.

Parameters
destWhere the result is to be placed.
srcThe IP address.
maskThe netmask.

Definition at line 1152 of file uip.h.

#define uip_ipaddr1 (   addr)

Pick the first octet of an IP address.

Picks out the first octet of an IP address.

Example:

1 uip_ipaddr_t ipaddr;
2 uint8_t octet;
3 
4 uip_ipaddr(&ipaddr, 1,2,3,4);
5 octet = uip_ipaddr1(&ipaddr);

In the example above, the variable "octet" will contain the value 1.

Definition at line 1175 of file uip.h.

#define uip_ipaddr2 (   addr)

Pick the second octet of an IP address.

Picks out the second octet of an IP address.

Example:

1 uip_ipaddr_t ipaddr;
2 uint8_t octet;
3 
4 uip_ipaddr(&ipaddr, 1,2,3,4);
5 octet = uip_ipaddr2(&ipaddr);

In the example above, the variable "octet" will contain the value 2.

Definition at line 1195 of file uip.h.

#define uip_ipaddr3 (   addr)

Pick the third octet of an IP address.

Picks out the third octet of an IP address.

Example:

1 uip_ipaddr_t ipaddr;
2 uint8_t octet;
3 
4 uip_ipaddr(&ipaddr, 1,2,3,4);
5 octet = uip_ipaddr3(&ipaddr);

In the example above, the variable "octet" will contain the value 3.

Definition at line 1215 of file uip.h.

#define uip_ipaddr4 (   addr)

Pick the fourth octet of an IP address.

Picks out the fourth octet of an IP address.

Example:

1 uip_ipaddr_t ipaddr;
2 uint8_t octet;
3 
4 uip_ipaddr(&ipaddr, 1,2,3,4);
5 octet = uip_ipaddr4(&ipaddr);

In the example above, the variable "octet" will contain the value 4.

Definition at line 1235 of file uip.h.

#define UIP_HTONS (   n)

Convert 16-bit quantity from host byte order to network byte order.

This macro is primarily used for converting constants from host byte order to network byte order. For converting variables to network byte order, use the uip_htons() function instead.

Definition at line 1248 of file uip.h.

Referenced by htons(), simple_udp_deregister(), simple_udp_register(), simple_udp_send(), simple_udp_sendto(), simple_udp_sendto_port(), uip_arp_arpin(), uip_arp_out(), uip_fw_forward(), uip_htons(), uip_init(), and uip_process().

#define uiplib_ipaddrconv   uiplib_ip4addrconv

Convert a textual representation of an IP address to a numerical representation.

This function takes a textual representation of an IP address in the form a.b.c.d for IPv4 or a:b:c:d:e:f:g:h for IPv6 and converts it into a numeric IP address representation that can be used by other uIP functions.

Parameters
addrstrA pointer to a string containing the IP address in textual form.
addrA pointer to a uip_ip4addr_t that will be filled in with the numerical representation of the address.
Return values
0If the IP address could not be parsed.
Non-zeroIf the IP address was parsed.

Definition at line 72 of file uiplib.h.

Function Documentation

CCIF uint16_t uip_htons ( uint16_t  val)

Convert a 16-bit quantity from host byte order to network byte order.

This function is primarily used for converting variables from host byte order to network byte order. For converting constants to network byte order, use the UIP_HTONS() macro instead.

Definition at line 2076 of file uip.c.

References UIP_HTONS.

Referenced by uip_chksum(), uip_init(), and uip_ipchksum().