Functions | |
void | udp_input (struct pbuf *p, struct netif *inp) |
err_t | udp_send (struct udp_pcb *pcb, struct pbuf *p) |
err_t | udp_sendto (struct udp_pcb *pcb, struct pbuf *p, struct ip_addr *dst_ip, u16_t dst_port) |
err_t | udp_sendto_if (struct udp_pcb *pcb, struct pbuf *p, struct ip_addr *dst_ip, u16_t dst_port, struct netif *netif) |
err_t | udp_bind (struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port) |
err_t | udp_connect (struct udp_pcb *pcb, struct ip_addr *ipaddr, u16_t port) |
void | udp_disconnect (struct udp_pcb *pcb) |
void | udp_recv (struct udp_pcb *pcb, void(*recv)(void *arg, struct udp_pcb *upcb, struct pbuf *p, struct ip_addr *addr, u16_t port), void *recv_arg) |
void | udp_remove (struct udp_pcb *pcb) |
struct udp_pcb * | udp_new (void) |
void | udp_debug_print (struct udp_hdr *udphdr) |
err_t udp_bind | ( | struct udp_pcb * | pcb, | |
struct ip_addr * | ipaddr, | |||
u16_t | port | |||
) |
Bind an UDP PCB.
pcb | UDP PCB to be bound with a local address ipaddr and port. | |
ipaddr | local IP address to bind with. Use IP_ADDR_ANY to bind to all local interfaces. | |
port | local UDP port to bind with. Use 0 to automatically bind to a random port between UDP_LOCAL_PORT_RANGE_START and UDP_LOCAL_PORT_RANGE_END. |
err_t udp_connect | ( | struct udp_pcb * | pcb, | |
struct ip_addr * | ipaddr, | |||
u16_t | port | |||
) |
Connect an UDP PCB.
This will associate the UDP PCB with the remote address.
pcb | UDP PCB to be connected with remote address ipaddr and port. | |
ipaddr | remote IP address to connect with. | |
port | remote UDP port to connect with. |
The udp pcb is bound to a random local port if not already bound.
TODO: this functionality belongs in upper layers
TODO: this will bind the udp pcb locally, to the interface which is used to route output packets to the remote address. However, we might want to accept incoming packets on any interface!
void udp_debug_print | ( | struct udp_hdr * | udphdr | ) |
Print UDP header information for debug purposes.
udphdr | pointer to the udp header in memory. |
void udp_disconnect | ( | struct udp_pcb * | pcb | ) |
Disconnect a UDP PCB
pcb | the udp pcb to disconnect. |
void udp_input | ( | struct pbuf * | p, | |
struct netif * | inp | |||
) |
Process an incoming UDP datagram.
Given an incoming UDP datagram (as a chain of pbufs) this function finds a corresponding UDP PCB and hands over the pbuf to the pcbs recv function. If no pcb is found or the datagram is incorrect, the pbuf is freed.
p | pbuf to be demultiplexed to a UDP PCB. | |
inp | network interface on which the datagram was received. |
struct udp_pcb* udp_new | ( | void | ) | [read] |
Create a UDP PCB.
void udp_recv | ( | struct udp_pcb * | pcb, | |
void(*)(void *arg, struct udp_pcb *upcb, struct pbuf *p, struct ip_addr *addr, u16_t port) | recv, | |||
void * | recv_arg | |||
) |
Set a receive callback for a UDP PCB
This callback will be called when receiving a datagram for the pcb.
pcb | the pcb for wich to set the recv callback | |
recv | function pointer of the callback function | |
recv_arg | additional argument to pass to the callback function |
void udp_remove | ( | struct udp_pcb * | pcb | ) |
Remove an UDP PCB.
pcb | UDP PCB to be removed. The PCB is removed from the list of UDP PCB's and the data structure is freed from memory. |
err_t udp_send | ( | struct udp_pcb * | pcb, | |
struct pbuf * | p | |||
) |
Send data using UDP.
pcb | UDP PCB used to send the data. | |
p | chain of pbuf's to be sent. |
err_t udp_sendto | ( | struct udp_pcb * | pcb, | |
struct pbuf * | p, | |||
struct ip_addr * | dst_ip, | |||
u16_t | dst_port | |||
) |
Send data to a specified address using UDP.
pcb | UDP PCB used to send the data. | |
p | chain of pbuf's to be sent. | |
dst_ip | Destination IP address. | |
dst_port | Destination UDP port. |
If the PCB already has a remote address association, it will be restored after the data is sent.
err_t udp_sendto_if | ( | struct udp_pcb * | pcb, | |
struct pbuf * | p, | |||
struct ip_addr * | dst_ip, | |||
u16_t | dst_port, | |||
struct netif * | netif | |||
) |
Send data to a specified address using UDP. The netif used for sending can be specified.
This function exists mainly for DHCP, to be able to send UDP packets on a netif that is still down.
pcb | UDP PCB used to send the data. | |
p | chain of pbuf's to be sent. | |
dst_ip | Destination IP address. | |
dst_port | Destination UDP port. | |
netif | the netif used for sending. |