1*5d5fbe79SDavid van Moolenbroek /**
2*5d5fbe79SDavid van Moolenbroek * @file
3*5d5fbe79SDavid van Moolenbroek * User Datagram Protocol module\n
4*5d5fbe79SDavid van Moolenbroek * The code for the User Datagram Protocol UDP & UDPLite (RFC 3828).\n
5*5d5fbe79SDavid van Moolenbroek * See also @ref udp_raw
6*5d5fbe79SDavid van Moolenbroek *
7*5d5fbe79SDavid van Moolenbroek * @defgroup udp_raw UDP
8*5d5fbe79SDavid van Moolenbroek * @ingroup callbackstyle_api
9*5d5fbe79SDavid van Moolenbroek * User Datagram Protocol module\n
10*5d5fbe79SDavid van Moolenbroek * @see @ref raw_api and @ref netconn
11*5d5fbe79SDavid van Moolenbroek */
12*5d5fbe79SDavid van Moolenbroek
13*5d5fbe79SDavid van Moolenbroek /*
14*5d5fbe79SDavid van Moolenbroek * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
15*5d5fbe79SDavid van Moolenbroek * All rights reserved.
16*5d5fbe79SDavid van Moolenbroek *
17*5d5fbe79SDavid van Moolenbroek * Redistribution and use in source and binary forms, with or without modification,
18*5d5fbe79SDavid van Moolenbroek * are permitted provided that the following conditions are met:
19*5d5fbe79SDavid van Moolenbroek *
20*5d5fbe79SDavid van Moolenbroek * 1. Redistributions of source code must retain the above copyright notice,
21*5d5fbe79SDavid van Moolenbroek * this list of conditions and the following disclaimer.
22*5d5fbe79SDavid van Moolenbroek * 2. Redistributions in binary form must reproduce the above copyright notice,
23*5d5fbe79SDavid van Moolenbroek * this list of conditions and the following disclaimer in the documentation
24*5d5fbe79SDavid van Moolenbroek * and/or other materials provided with the distribution.
25*5d5fbe79SDavid van Moolenbroek * 3. The name of the author may not be used to endorse or promote products
26*5d5fbe79SDavid van Moolenbroek * derived from this software without specific prior written permission.
27*5d5fbe79SDavid van Moolenbroek *
28*5d5fbe79SDavid van Moolenbroek * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
29*5d5fbe79SDavid van Moolenbroek * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
30*5d5fbe79SDavid van Moolenbroek * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
31*5d5fbe79SDavid van Moolenbroek * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
32*5d5fbe79SDavid van Moolenbroek * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
33*5d5fbe79SDavid van Moolenbroek * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
34*5d5fbe79SDavid van Moolenbroek * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
35*5d5fbe79SDavid van Moolenbroek * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
36*5d5fbe79SDavid van Moolenbroek * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
37*5d5fbe79SDavid van Moolenbroek * OF SUCH DAMAGE.
38*5d5fbe79SDavid van Moolenbroek *
39*5d5fbe79SDavid van Moolenbroek * This file is part of the lwIP TCP/IP stack.
40*5d5fbe79SDavid van Moolenbroek *
41*5d5fbe79SDavid van Moolenbroek * Author: Adam Dunkels <adam@sics.se>
42*5d5fbe79SDavid van Moolenbroek *
43*5d5fbe79SDavid van Moolenbroek */
44*5d5fbe79SDavid van Moolenbroek
45*5d5fbe79SDavid van Moolenbroek /* @todo Check the use of '(struct udp_pcb).chksum_len_rx'!
46*5d5fbe79SDavid van Moolenbroek */
47*5d5fbe79SDavid van Moolenbroek
48*5d5fbe79SDavid van Moolenbroek #include "lwip/opt.h"
49*5d5fbe79SDavid van Moolenbroek
50*5d5fbe79SDavid van Moolenbroek #if LWIP_UDP /* don't build if not configured for use in lwipopts.h */
51*5d5fbe79SDavid van Moolenbroek
52*5d5fbe79SDavid van Moolenbroek #include "lwip/udp.h"
53*5d5fbe79SDavid van Moolenbroek #include "lwip/def.h"
54*5d5fbe79SDavid van Moolenbroek #include "lwip/memp.h"
55*5d5fbe79SDavid van Moolenbroek #include "lwip/inet_chksum.h"
56*5d5fbe79SDavid van Moolenbroek #include "lwip/ip_addr.h"
57*5d5fbe79SDavid van Moolenbroek #include "lwip/ip6.h"
58*5d5fbe79SDavid van Moolenbroek #include "lwip/ip6_addr.h"
59*5d5fbe79SDavid van Moolenbroek #include "lwip/netif.h"
60*5d5fbe79SDavid van Moolenbroek #include "lwip/icmp.h"
61*5d5fbe79SDavid van Moolenbroek #include "lwip/icmp6.h"
62*5d5fbe79SDavid van Moolenbroek #include "lwip/stats.h"
63*5d5fbe79SDavid van Moolenbroek #include "lwip/snmp.h"
64*5d5fbe79SDavid van Moolenbroek #include "lwip/dhcp.h"
65*5d5fbe79SDavid van Moolenbroek
66*5d5fbe79SDavid van Moolenbroek #include <string.h>
67*5d5fbe79SDavid van Moolenbroek
68*5d5fbe79SDavid van Moolenbroek #ifndef UDP_LOCAL_PORT_RANGE_START
69*5d5fbe79SDavid van Moolenbroek /* From http://www.iana.org/assignments/port-numbers:
70*5d5fbe79SDavid van Moolenbroek "The Dynamic and/or Private Ports are those from 49152 through 65535" */
71*5d5fbe79SDavid van Moolenbroek #define UDP_LOCAL_PORT_RANGE_START 0xc000
72*5d5fbe79SDavid van Moolenbroek #define UDP_LOCAL_PORT_RANGE_END 0xffff
73*5d5fbe79SDavid van Moolenbroek #define UDP_ENSURE_LOCAL_PORT_RANGE(port) ((u16_t)(((port) & ~UDP_LOCAL_PORT_RANGE_START) + UDP_LOCAL_PORT_RANGE_START))
74*5d5fbe79SDavid van Moolenbroek #endif
75*5d5fbe79SDavid van Moolenbroek
76*5d5fbe79SDavid van Moolenbroek /* last local UDP port */
77*5d5fbe79SDavid van Moolenbroek static u16_t udp_port = UDP_LOCAL_PORT_RANGE_START;
78*5d5fbe79SDavid van Moolenbroek
79*5d5fbe79SDavid van Moolenbroek /* The list of UDP PCBs */
80*5d5fbe79SDavid van Moolenbroek /* exported in udp.h (was static) */
81*5d5fbe79SDavid van Moolenbroek struct udp_pcb *udp_pcbs;
82*5d5fbe79SDavid van Moolenbroek
83*5d5fbe79SDavid van Moolenbroek /**
84*5d5fbe79SDavid van Moolenbroek * Initialize this module.
85*5d5fbe79SDavid van Moolenbroek */
86*5d5fbe79SDavid van Moolenbroek void
udp_init(void)87*5d5fbe79SDavid van Moolenbroek udp_init(void)
88*5d5fbe79SDavid van Moolenbroek {
89*5d5fbe79SDavid van Moolenbroek #if LWIP_RANDOMIZE_INITIAL_LOCAL_PORTS && defined(LWIP_RAND)
90*5d5fbe79SDavid van Moolenbroek udp_port = UDP_ENSURE_LOCAL_PORT_RANGE(LWIP_RAND());
91*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_RANDOMIZE_INITIAL_LOCAL_PORTS && defined(LWIP_RAND) */
92*5d5fbe79SDavid van Moolenbroek }
93*5d5fbe79SDavid van Moolenbroek
94*5d5fbe79SDavid van Moolenbroek /**
95*5d5fbe79SDavid van Moolenbroek * Allocate a new local UDP port.
96*5d5fbe79SDavid van Moolenbroek *
97*5d5fbe79SDavid van Moolenbroek * @return a new (free) local UDP port number
98*5d5fbe79SDavid van Moolenbroek */
99*5d5fbe79SDavid van Moolenbroek static u16_t
udp_new_port(void)100*5d5fbe79SDavid van Moolenbroek udp_new_port(void)
101*5d5fbe79SDavid van Moolenbroek {
102*5d5fbe79SDavid van Moolenbroek u16_t n = 0;
103*5d5fbe79SDavid van Moolenbroek struct udp_pcb *pcb;
104*5d5fbe79SDavid van Moolenbroek
105*5d5fbe79SDavid van Moolenbroek again:
106*5d5fbe79SDavid van Moolenbroek if (udp_port++ == UDP_LOCAL_PORT_RANGE_END) {
107*5d5fbe79SDavid van Moolenbroek udp_port = UDP_LOCAL_PORT_RANGE_START;
108*5d5fbe79SDavid van Moolenbroek }
109*5d5fbe79SDavid van Moolenbroek /* Check all PCBs. */
110*5d5fbe79SDavid van Moolenbroek for (pcb = udp_pcbs; pcb != NULL; pcb = pcb->next) {
111*5d5fbe79SDavid van Moolenbroek if (pcb->local_port == udp_port) {
112*5d5fbe79SDavid van Moolenbroek if (++n > (UDP_LOCAL_PORT_RANGE_END - UDP_LOCAL_PORT_RANGE_START)) {
113*5d5fbe79SDavid van Moolenbroek return 0;
114*5d5fbe79SDavid van Moolenbroek }
115*5d5fbe79SDavid van Moolenbroek goto again;
116*5d5fbe79SDavid van Moolenbroek }
117*5d5fbe79SDavid van Moolenbroek }
118*5d5fbe79SDavid van Moolenbroek return udp_port;
119*5d5fbe79SDavid van Moolenbroek }
120*5d5fbe79SDavid van Moolenbroek
121*5d5fbe79SDavid van Moolenbroek /** Common code to see if the current input packet matches the pcb
122*5d5fbe79SDavid van Moolenbroek * (current input packet is accessed via ip(4/6)_current_* macros)
123*5d5fbe79SDavid van Moolenbroek *
124*5d5fbe79SDavid van Moolenbroek * @param pcb pcb to check
125*5d5fbe79SDavid van Moolenbroek * @param inp network interface on which the datagram was received (only used for IPv4)
126*5d5fbe79SDavid van Moolenbroek * @param broadcast 1 if his is an IPv4 broadcast (global or subnet-only), 0 otherwise (only used for IPv4)
127*5d5fbe79SDavid van Moolenbroek * @return 1 on match, 0 otherwise
128*5d5fbe79SDavid van Moolenbroek */
129*5d5fbe79SDavid van Moolenbroek static u8_t
udp_input_local_match(struct udp_pcb * pcb,struct netif * inp,u8_t broadcast)130*5d5fbe79SDavid van Moolenbroek udp_input_local_match(struct udp_pcb *pcb, struct netif *inp, u8_t broadcast)
131*5d5fbe79SDavid van Moolenbroek {
132*5d5fbe79SDavid van Moolenbroek LWIP_UNUSED_ARG(inp); /* in IPv6 only case */
133*5d5fbe79SDavid van Moolenbroek LWIP_UNUSED_ARG(broadcast); /* in IPv6 only case */
134*5d5fbe79SDavid van Moolenbroek
135*5d5fbe79SDavid van Moolenbroek /* Dual-stack: PCBs listening to any IP type also listen to any IP address */
136*5d5fbe79SDavid van Moolenbroek if (IP_IS_ANY_TYPE_VAL(pcb->local_ip)) {
137*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4 && IP_SOF_BROADCAST_RECV
138*5d5fbe79SDavid van Moolenbroek if ((broadcast != 0) && !ip_get_option(pcb, SOF_BROADCAST)) {
139*5d5fbe79SDavid van Moolenbroek return 0;
140*5d5fbe79SDavid van Moolenbroek }
141*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV4 && IP_SOF_BROADCAST_RECV */
142*5d5fbe79SDavid van Moolenbroek return 1;
143*5d5fbe79SDavid van Moolenbroek }
144*5d5fbe79SDavid van Moolenbroek
145*5d5fbe79SDavid van Moolenbroek /* Only need to check PCB if incoming IP version matches PCB IP version */
146*5d5fbe79SDavid van Moolenbroek if (IP_ADDR_PCB_VERSION_MATCH_EXACT(pcb, ip_current_dest_addr())) {
147*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4
148*5d5fbe79SDavid van Moolenbroek /* Special case: IPv4 broadcast: all or broadcasts in my subnet
149*5d5fbe79SDavid van Moolenbroek * Note: broadcast variable can only be 1 if it is an IPv4 broadcast */
150*5d5fbe79SDavid van Moolenbroek if (broadcast != 0) {
151*5d5fbe79SDavid van Moolenbroek #if IP_SOF_BROADCAST_RECV
152*5d5fbe79SDavid van Moolenbroek if (ip_get_option(pcb, SOF_BROADCAST))
153*5d5fbe79SDavid van Moolenbroek #endif /* IP_SOF_BROADCAST_RECV */
154*5d5fbe79SDavid van Moolenbroek {
155*5d5fbe79SDavid van Moolenbroek if (ip4_addr_isany(ip_2_ip4(&pcb->local_ip)) ||
156*5d5fbe79SDavid van Moolenbroek ((ip4_current_dest_addr()->addr == IPADDR_BROADCAST)) ||
157*5d5fbe79SDavid van Moolenbroek ip4_addr_netcmp(ip_2_ip4(&pcb->local_ip), ip4_current_dest_addr(), netif_ip4_netmask(inp))) {
158*5d5fbe79SDavid van Moolenbroek return 1;
159*5d5fbe79SDavid van Moolenbroek }
160*5d5fbe79SDavid van Moolenbroek }
161*5d5fbe79SDavid van Moolenbroek } else
162*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV4 */
163*5d5fbe79SDavid van Moolenbroek /* Handle IPv4 and IPv6: all or exact match */
164*5d5fbe79SDavid van Moolenbroek if (ip_addr_isany(&pcb->local_ip) || ip_addr_cmp(&pcb->local_ip, ip_current_dest_addr())) {
165*5d5fbe79SDavid van Moolenbroek return 1;
166*5d5fbe79SDavid van Moolenbroek }
167*5d5fbe79SDavid van Moolenbroek }
168*5d5fbe79SDavid van Moolenbroek
169*5d5fbe79SDavid van Moolenbroek return 0;
170*5d5fbe79SDavid van Moolenbroek }
171*5d5fbe79SDavid van Moolenbroek
172*5d5fbe79SDavid van Moolenbroek /**
173*5d5fbe79SDavid van Moolenbroek * Process an incoming UDP datagram.
174*5d5fbe79SDavid van Moolenbroek *
175*5d5fbe79SDavid van Moolenbroek * Given an incoming UDP datagram (as a chain of pbufs) this function
176*5d5fbe79SDavid van Moolenbroek * finds a corresponding UDP PCB and hands over the pbuf to the pcbs
177*5d5fbe79SDavid van Moolenbroek * recv function. If no pcb is found or the datagram is incorrect, the
178*5d5fbe79SDavid van Moolenbroek * pbuf is freed.
179*5d5fbe79SDavid van Moolenbroek *
180*5d5fbe79SDavid van Moolenbroek * @param p pbuf to be demultiplexed to a UDP PCB (p->payload pointing to the UDP header)
181*5d5fbe79SDavid van Moolenbroek * @param inp network interface on which the datagram was received.
182*5d5fbe79SDavid van Moolenbroek *
183*5d5fbe79SDavid van Moolenbroek */
184*5d5fbe79SDavid van Moolenbroek void
udp_input(struct pbuf * p,struct netif * inp)185*5d5fbe79SDavid van Moolenbroek udp_input(struct pbuf *p, struct netif *inp)
186*5d5fbe79SDavid van Moolenbroek {
187*5d5fbe79SDavid van Moolenbroek struct udp_hdr *udphdr;
188*5d5fbe79SDavid van Moolenbroek struct udp_pcb *pcb, *prev;
189*5d5fbe79SDavid van Moolenbroek struct udp_pcb *uncon_pcb;
190*5d5fbe79SDavid van Moolenbroek u16_t src, dest;
191*5d5fbe79SDavid van Moolenbroek u8_t broadcast;
192*5d5fbe79SDavid van Moolenbroek u8_t for_us = 0;
193*5d5fbe79SDavid van Moolenbroek
194*5d5fbe79SDavid van Moolenbroek LWIP_UNUSED_ARG(inp);
195*5d5fbe79SDavid van Moolenbroek
196*5d5fbe79SDavid van Moolenbroek PERF_START;
197*5d5fbe79SDavid van Moolenbroek
198*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.recv);
199*5d5fbe79SDavid van Moolenbroek
200*5d5fbe79SDavid van Moolenbroek /* Check minimum length (UDP header) */
201*5d5fbe79SDavid van Moolenbroek if (p->len < UDP_HLEN) {
202*5d5fbe79SDavid van Moolenbroek /* drop short packets */
203*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG,
204*5d5fbe79SDavid van Moolenbroek ("udp_input: short UDP datagram (%"U16_F" bytes) discarded\n", p->tot_len));
205*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.lenerr);
206*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.drop);
207*5d5fbe79SDavid van Moolenbroek MIB2_STATS_INC(mib2.udpinerrors);
208*5d5fbe79SDavid van Moolenbroek pbuf_free(p);
209*5d5fbe79SDavid van Moolenbroek goto end;
210*5d5fbe79SDavid van Moolenbroek }
211*5d5fbe79SDavid van Moolenbroek
212*5d5fbe79SDavid van Moolenbroek udphdr = (struct udp_hdr *)p->payload;
213*5d5fbe79SDavid van Moolenbroek
214*5d5fbe79SDavid van Moolenbroek /* is broadcast packet ? */
215*5d5fbe79SDavid van Moolenbroek broadcast = ip_addr_isbroadcast(ip_current_dest_addr(), ip_current_netif());
216*5d5fbe79SDavid van Moolenbroek
217*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp_input: received datagram of length %"U16_F"\n", p->tot_len));
218*5d5fbe79SDavid van Moolenbroek
219*5d5fbe79SDavid van Moolenbroek /* convert src and dest ports to host byte order */
220*5d5fbe79SDavid van Moolenbroek src = lwip_ntohs(udphdr->src);
221*5d5fbe79SDavid van Moolenbroek dest = lwip_ntohs(udphdr->dest);
222*5d5fbe79SDavid van Moolenbroek
223*5d5fbe79SDavid van Moolenbroek udp_debug_print(udphdr);
224*5d5fbe79SDavid van Moolenbroek
225*5d5fbe79SDavid van Moolenbroek /* print the UDP source and destination */
226*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp ("));
227*5d5fbe79SDavid van Moolenbroek ip_addr_debug_print(UDP_DEBUG, ip_current_dest_addr());
228*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, (", %"U16_F") <-- (", lwip_ntohs(udphdr->dest)));
229*5d5fbe79SDavid van Moolenbroek ip_addr_debug_print(UDP_DEBUG, ip_current_src_addr());
230*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, (", %"U16_F")\n", lwip_ntohs(udphdr->src)));
231*5d5fbe79SDavid van Moolenbroek
232*5d5fbe79SDavid van Moolenbroek pcb = NULL;
233*5d5fbe79SDavid van Moolenbroek prev = NULL;
234*5d5fbe79SDavid van Moolenbroek uncon_pcb = NULL;
235*5d5fbe79SDavid van Moolenbroek /* Iterate through the UDP pcb list for a matching pcb.
236*5d5fbe79SDavid van Moolenbroek * 'Perfect match' pcbs (connected to the remote port & ip address) are
237*5d5fbe79SDavid van Moolenbroek * preferred. If no perfect match is found, the first unconnected pcb that
238*5d5fbe79SDavid van Moolenbroek * matches the local port and ip address gets the datagram. */
239*5d5fbe79SDavid van Moolenbroek for (pcb = udp_pcbs; pcb != NULL; pcb = pcb->next) {
240*5d5fbe79SDavid van Moolenbroek /* print the PCB local and remote address */
241*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("pcb ("));
242*5d5fbe79SDavid van Moolenbroek ip_addr_debug_print(UDP_DEBUG, &pcb->local_ip);
243*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, (", %"U16_F") <-- (", pcb->local_port));
244*5d5fbe79SDavid van Moolenbroek ip_addr_debug_print(UDP_DEBUG, &pcb->remote_ip);
245*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, (", %"U16_F")\n", pcb->remote_port));
246*5d5fbe79SDavid van Moolenbroek
247*5d5fbe79SDavid van Moolenbroek /* compare PCB local addr+port to UDP destination addr+port */
248*5d5fbe79SDavid van Moolenbroek if ((pcb->local_port == dest) &&
249*5d5fbe79SDavid van Moolenbroek (udp_input_local_match(pcb, inp, broadcast) != 0)) {
250*5d5fbe79SDavid van Moolenbroek if (((pcb->flags & UDP_FLAGS_CONNECTED) == 0) &&
251*5d5fbe79SDavid van Moolenbroek ((uncon_pcb == NULL)
252*5d5fbe79SDavid van Moolenbroek #if SO_REUSE
253*5d5fbe79SDavid van Moolenbroek /* prefer specific IPs over cath-all */
254*5d5fbe79SDavid van Moolenbroek || !ip_addr_isany(&pcb->local_ip)
255*5d5fbe79SDavid van Moolenbroek #endif /* SO_REUSE */
256*5d5fbe79SDavid van Moolenbroek )) {
257*5d5fbe79SDavid van Moolenbroek /* the first unconnected matching PCB */
258*5d5fbe79SDavid van Moolenbroek uncon_pcb = pcb;
259*5d5fbe79SDavid van Moolenbroek }
260*5d5fbe79SDavid van Moolenbroek
261*5d5fbe79SDavid van Moolenbroek /* compare PCB remote addr+port to UDP source addr+port */
262*5d5fbe79SDavid van Moolenbroek if ((pcb->remote_port == src) &&
263*5d5fbe79SDavid van Moolenbroek (ip_addr_isany_val(pcb->remote_ip) ||
264*5d5fbe79SDavid van Moolenbroek ip_addr_cmp(&pcb->remote_ip, ip_current_src_addr()))) {
265*5d5fbe79SDavid van Moolenbroek /* the first fully matching PCB */
266*5d5fbe79SDavid van Moolenbroek if (prev != NULL) {
267*5d5fbe79SDavid van Moolenbroek /* move the pcb to the front of udp_pcbs so that is
268*5d5fbe79SDavid van Moolenbroek found faster next time */
269*5d5fbe79SDavid van Moolenbroek prev->next = pcb->next;
270*5d5fbe79SDavid van Moolenbroek pcb->next = udp_pcbs;
271*5d5fbe79SDavid van Moolenbroek udp_pcbs = pcb;
272*5d5fbe79SDavid van Moolenbroek } else {
273*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.cachehit);
274*5d5fbe79SDavid van Moolenbroek }
275*5d5fbe79SDavid van Moolenbroek break;
276*5d5fbe79SDavid van Moolenbroek }
277*5d5fbe79SDavid van Moolenbroek }
278*5d5fbe79SDavid van Moolenbroek
279*5d5fbe79SDavid van Moolenbroek prev = pcb;
280*5d5fbe79SDavid van Moolenbroek }
281*5d5fbe79SDavid van Moolenbroek /* no fully matching pcb found? then look for an unconnected pcb */
282*5d5fbe79SDavid van Moolenbroek if (pcb == NULL) {
283*5d5fbe79SDavid van Moolenbroek pcb = uncon_pcb;
284*5d5fbe79SDavid van Moolenbroek }
285*5d5fbe79SDavid van Moolenbroek
286*5d5fbe79SDavid van Moolenbroek /* Check checksum if this is a match or if it was directed at us. */
287*5d5fbe79SDavid van Moolenbroek if (pcb != NULL) {
288*5d5fbe79SDavid van Moolenbroek for_us = 1;
289*5d5fbe79SDavid van Moolenbroek } else {
290*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV6
291*5d5fbe79SDavid van Moolenbroek if (ip_current_is_v6()) {
292*5d5fbe79SDavid van Moolenbroek for_us = netif_get_ip6_addr_match(inp, ip6_current_dest_addr()) >= 0;
293*5d5fbe79SDavid van Moolenbroek }
294*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV6 */
295*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4
296*5d5fbe79SDavid van Moolenbroek if (!ip_current_is_v6()) {
297*5d5fbe79SDavid van Moolenbroek for_us = ip4_addr_cmp(netif_ip4_addr(inp), ip4_current_dest_addr());
298*5d5fbe79SDavid van Moolenbroek }
299*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV4 */
300*5d5fbe79SDavid van Moolenbroek }
301*5d5fbe79SDavid van Moolenbroek
302*5d5fbe79SDavid van Moolenbroek if (for_us) {
303*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_input: calculating checksum\n"));
304*5d5fbe79SDavid van Moolenbroek #if CHECKSUM_CHECK_UDP
305*5d5fbe79SDavid van Moolenbroek IF__NETIF_CHECKSUM_ENABLED(inp, CHECKSUM_CHECK_UDP) {
306*5d5fbe79SDavid van Moolenbroek #if LWIP_UDPLITE
307*5d5fbe79SDavid van Moolenbroek if (ip_current_header_proto() == IP_PROTO_UDPLITE) {
308*5d5fbe79SDavid van Moolenbroek /* Do the UDP Lite checksum */
309*5d5fbe79SDavid van Moolenbroek u16_t chklen = lwip_ntohs(udphdr->len);
310*5d5fbe79SDavid van Moolenbroek if (chklen < sizeof(struct udp_hdr)) {
311*5d5fbe79SDavid van Moolenbroek if (chklen == 0) {
312*5d5fbe79SDavid van Moolenbroek /* For UDP-Lite, checksum length of 0 means checksum
313*5d5fbe79SDavid van Moolenbroek over the complete packet (See RFC 3828 chap. 3.1) */
314*5d5fbe79SDavid van Moolenbroek chklen = p->tot_len;
315*5d5fbe79SDavid van Moolenbroek } else {
316*5d5fbe79SDavid van Moolenbroek /* At least the UDP-Lite header must be covered by the
317*5d5fbe79SDavid van Moolenbroek checksum! (Again, see RFC 3828 chap. 3.1) */
318*5d5fbe79SDavid van Moolenbroek goto chkerr;
319*5d5fbe79SDavid van Moolenbroek }
320*5d5fbe79SDavid van Moolenbroek }
321*5d5fbe79SDavid van Moolenbroek if (ip_chksum_pseudo_partial(p, IP_PROTO_UDPLITE,
322*5d5fbe79SDavid van Moolenbroek p->tot_len, chklen,
323*5d5fbe79SDavid van Moolenbroek ip_current_src_addr(), ip_current_dest_addr()) != 0) {
324*5d5fbe79SDavid van Moolenbroek goto chkerr;
325*5d5fbe79SDavid van Moolenbroek }
326*5d5fbe79SDavid van Moolenbroek } else
327*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_UDPLITE */
328*5d5fbe79SDavid van Moolenbroek {
329*5d5fbe79SDavid van Moolenbroek if (udphdr->chksum != 0) {
330*5d5fbe79SDavid van Moolenbroek if (ip_chksum_pseudo(p, IP_PROTO_UDP, p->tot_len,
331*5d5fbe79SDavid van Moolenbroek ip_current_src_addr(),
332*5d5fbe79SDavid van Moolenbroek ip_current_dest_addr()) != 0) {
333*5d5fbe79SDavid van Moolenbroek goto chkerr;
334*5d5fbe79SDavid van Moolenbroek }
335*5d5fbe79SDavid van Moolenbroek }
336*5d5fbe79SDavid van Moolenbroek }
337*5d5fbe79SDavid van Moolenbroek }
338*5d5fbe79SDavid van Moolenbroek #endif /* CHECKSUM_CHECK_UDP */
339*5d5fbe79SDavid van Moolenbroek if (pbuf_header(p, -UDP_HLEN)) {
340*5d5fbe79SDavid van Moolenbroek /* Can we cope with this failing? Just assert for now */
341*5d5fbe79SDavid van Moolenbroek LWIP_ASSERT("pbuf_header failed\n", 0);
342*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.drop);
343*5d5fbe79SDavid van Moolenbroek MIB2_STATS_INC(mib2.udpinerrors);
344*5d5fbe79SDavid van Moolenbroek pbuf_free(p);
345*5d5fbe79SDavid van Moolenbroek goto end;
346*5d5fbe79SDavid van Moolenbroek }
347*5d5fbe79SDavid van Moolenbroek
348*5d5fbe79SDavid van Moolenbroek if (pcb != NULL) {
349*5d5fbe79SDavid van Moolenbroek MIB2_STATS_INC(mib2.udpindatagrams);
350*5d5fbe79SDavid van Moolenbroek #if SO_REUSE && SO_REUSE_RXTOALL
351*5d5fbe79SDavid van Moolenbroek if (ip_get_option(pcb, SOF_REUSEADDR) &&
352*5d5fbe79SDavid van Moolenbroek (broadcast || ip_addr_ismulticast(ip_current_dest_addr()))) {
353*5d5fbe79SDavid van Moolenbroek /* pass broadcast- or multicast packets to all multicast pcbs
354*5d5fbe79SDavid van Moolenbroek if SOF_REUSEADDR is set on the first match */
355*5d5fbe79SDavid van Moolenbroek struct udp_pcb *mpcb;
356*5d5fbe79SDavid van Moolenbroek u8_t p_header_changed = 0;
357*5d5fbe79SDavid van Moolenbroek s16_t hdrs_len = (s16_t)(ip_current_header_tot_len() + UDP_HLEN);
358*5d5fbe79SDavid van Moolenbroek for (mpcb = udp_pcbs; mpcb != NULL; mpcb = mpcb->next) {
359*5d5fbe79SDavid van Moolenbroek if (mpcb != pcb) {
360*5d5fbe79SDavid van Moolenbroek /* compare PCB local addr+port to UDP destination addr+port */
361*5d5fbe79SDavid van Moolenbroek if ((mpcb->local_port == dest) &&
362*5d5fbe79SDavid van Moolenbroek (udp_input_local_match(mpcb, inp, broadcast) != 0)) {
363*5d5fbe79SDavid van Moolenbroek /* pass a copy of the packet to all local matches */
364*5d5fbe79SDavid van Moolenbroek if (mpcb->recv != NULL) {
365*5d5fbe79SDavid van Moolenbroek struct pbuf *q;
366*5d5fbe79SDavid van Moolenbroek /* for that, move payload to IP header again */
367*5d5fbe79SDavid van Moolenbroek if (p_header_changed == 0) {
368*5d5fbe79SDavid van Moolenbroek pbuf_header_force(p, hdrs_len);
369*5d5fbe79SDavid van Moolenbroek p_header_changed = 1;
370*5d5fbe79SDavid van Moolenbroek }
371*5d5fbe79SDavid van Moolenbroek #if defined(__minix)
372*5d5fbe79SDavid van Moolenbroek q = pchain_alloc(PBUF_RAW, p->tot_len);
373*5d5fbe79SDavid van Moolenbroek #else /* !defined(__minix) */
374*5d5fbe79SDavid van Moolenbroek q = pbuf_alloc(PBUF_RAW, p->tot_len, PBUF_RAM);
375*5d5fbe79SDavid van Moolenbroek #endif /* !defined(__minix) */
376*5d5fbe79SDavid van Moolenbroek if (q != NULL) {
377*5d5fbe79SDavid van Moolenbroek err_t err = pbuf_copy(q, p);
378*5d5fbe79SDavid van Moolenbroek if (err == ERR_OK) {
379*5d5fbe79SDavid van Moolenbroek /* move payload to UDP data */
380*5d5fbe79SDavid van Moolenbroek pbuf_header(q, -hdrs_len);
381*5d5fbe79SDavid van Moolenbroek mpcb->recv(mpcb->recv_arg, mpcb, q, ip_current_src_addr(), src);
382*5d5fbe79SDavid van Moolenbroek }
383*5d5fbe79SDavid van Moolenbroek }
384*5d5fbe79SDavid van Moolenbroek }
385*5d5fbe79SDavid van Moolenbroek }
386*5d5fbe79SDavid van Moolenbroek }
387*5d5fbe79SDavid van Moolenbroek }
388*5d5fbe79SDavid van Moolenbroek if (p_header_changed) {
389*5d5fbe79SDavid van Moolenbroek /* and move payload to UDP data again */
390*5d5fbe79SDavid van Moolenbroek pbuf_header(p, -hdrs_len);
391*5d5fbe79SDavid van Moolenbroek }
392*5d5fbe79SDavid van Moolenbroek }
393*5d5fbe79SDavid van Moolenbroek #endif /* SO_REUSE && SO_REUSE_RXTOALL */
394*5d5fbe79SDavid van Moolenbroek /* callback */
395*5d5fbe79SDavid van Moolenbroek if (pcb->recv != NULL) {
396*5d5fbe79SDavid van Moolenbroek /* now the recv function is responsible for freeing p */
397*5d5fbe79SDavid van Moolenbroek pcb->recv(pcb->recv_arg, pcb, p, ip_current_src_addr(), src);
398*5d5fbe79SDavid van Moolenbroek } else {
399*5d5fbe79SDavid van Moolenbroek /* no recv function registered? then we have to free the pbuf! */
400*5d5fbe79SDavid van Moolenbroek pbuf_free(p);
401*5d5fbe79SDavid van Moolenbroek goto end;
402*5d5fbe79SDavid van Moolenbroek }
403*5d5fbe79SDavid van Moolenbroek } else {
404*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_input: not for us.\n"));
405*5d5fbe79SDavid van Moolenbroek
406*5d5fbe79SDavid van Moolenbroek #if LWIP_ICMP || LWIP_ICMP6
407*5d5fbe79SDavid van Moolenbroek /* No match was found, send ICMP destination port unreachable unless
408*5d5fbe79SDavid van Moolenbroek destination address was broadcast/multicast. */
409*5d5fbe79SDavid van Moolenbroek if (!broadcast && !ip_addr_ismulticast(ip_current_dest_addr())) {
410*5d5fbe79SDavid van Moolenbroek /* move payload pointer back to ip header */
411*5d5fbe79SDavid van Moolenbroek pbuf_header_force(p, (s16_t)(ip_current_header_tot_len() + UDP_HLEN));
412*5d5fbe79SDavid van Moolenbroek icmp_port_unreach(ip_current_is_v6(), p);
413*5d5fbe79SDavid van Moolenbroek }
414*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_ICMP || LWIP_ICMP6 */
415*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.proterr);
416*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.drop);
417*5d5fbe79SDavid van Moolenbroek MIB2_STATS_INC(mib2.udpnoports);
418*5d5fbe79SDavid van Moolenbroek pbuf_free(p);
419*5d5fbe79SDavid van Moolenbroek }
420*5d5fbe79SDavid van Moolenbroek } else {
421*5d5fbe79SDavid van Moolenbroek pbuf_free(p);
422*5d5fbe79SDavid van Moolenbroek }
423*5d5fbe79SDavid van Moolenbroek end:
424*5d5fbe79SDavid van Moolenbroek PERF_STOP("udp_input");
425*5d5fbe79SDavid van Moolenbroek return;
426*5d5fbe79SDavid van Moolenbroek #if CHECKSUM_CHECK_UDP
427*5d5fbe79SDavid van Moolenbroek chkerr:
428*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS,
429*5d5fbe79SDavid van Moolenbroek ("udp_input: UDP (or UDP Lite) datagram discarded due to failing checksum\n"));
430*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.chkerr);
431*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.drop);
432*5d5fbe79SDavid van Moolenbroek MIB2_STATS_INC(mib2.udpinerrors);
433*5d5fbe79SDavid van Moolenbroek pbuf_free(p);
434*5d5fbe79SDavid van Moolenbroek PERF_STOP("udp_input");
435*5d5fbe79SDavid van Moolenbroek #endif /* CHECKSUM_CHECK_UDP */
436*5d5fbe79SDavid van Moolenbroek }
437*5d5fbe79SDavid van Moolenbroek
438*5d5fbe79SDavid van Moolenbroek /**
439*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
440*5d5fbe79SDavid van Moolenbroek * Send data using UDP.
441*5d5fbe79SDavid van Moolenbroek *
442*5d5fbe79SDavid van Moolenbroek * @param pcb UDP PCB used to send the data.
443*5d5fbe79SDavid van Moolenbroek * @param p chain of pbuf's to be sent.
444*5d5fbe79SDavid van Moolenbroek *
445*5d5fbe79SDavid van Moolenbroek * The datagram will be sent to the current remote_ip & remote_port
446*5d5fbe79SDavid van Moolenbroek * stored in pcb. If the pcb is not bound to a port, it will
447*5d5fbe79SDavid van Moolenbroek * automatically be bound to a random port.
448*5d5fbe79SDavid van Moolenbroek *
449*5d5fbe79SDavid van Moolenbroek * @return lwIP error code.
450*5d5fbe79SDavid van Moolenbroek * - ERR_OK. Successful. No error occurred.
451*5d5fbe79SDavid van Moolenbroek * - ERR_MEM. Out of memory.
452*5d5fbe79SDavid van Moolenbroek * - ERR_RTE. Could not find route to destination address.
453*5d5fbe79SDavid van Moolenbroek * - ERR_VAL. No PCB or PCB is dual-stack
454*5d5fbe79SDavid van Moolenbroek * - More errors could be returned by lower protocol layers.
455*5d5fbe79SDavid van Moolenbroek *
456*5d5fbe79SDavid van Moolenbroek * @see udp_disconnect() udp_sendto()
457*5d5fbe79SDavid van Moolenbroek */
458*5d5fbe79SDavid van Moolenbroek err_t
udp_send(struct udp_pcb * pcb,struct pbuf * p)459*5d5fbe79SDavid van Moolenbroek udp_send(struct udp_pcb *pcb, struct pbuf *p)
460*5d5fbe79SDavid van Moolenbroek {
461*5d5fbe79SDavid van Moolenbroek if ((pcb == NULL) || IP_IS_ANY_TYPE_VAL(pcb->remote_ip)) {
462*5d5fbe79SDavid van Moolenbroek return ERR_VAL;
463*5d5fbe79SDavid van Moolenbroek }
464*5d5fbe79SDavid van Moolenbroek
465*5d5fbe79SDavid van Moolenbroek /* send to the packet using remote ip and port stored in the pcb */
466*5d5fbe79SDavid van Moolenbroek return udp_sendto(pcb, p, &pcb->remote_ip, pcb->remote_port);
467*5d5fbe79SDavid van Moolenbroek }
468*5d5fbe79SDavid van Moolenbroek
469*5d5fbe79SDavid van Moolenbroek #if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP
470*5d5fbe79SDavid van Moolenbroek /** @ingroup udp_raw
471*5d5fbe79SDavid van Moolenbroek * Same as udp_send() but with checksum
472*5d5fbe79SDavid van Moolenbroek */
473*5d5fbe79SDavid van Moolenbroek err_t
udp_send_chksum(struct udp_pcb * pcb,struct pbuf * p,u8_t have_chksum,u16_t chksum)474*5d5fbe79SDavid van Moolenbroek udp_send_chksum(struct udp_pcb *pcb, struct pbuf *p,
475*5d5fbe79SDavid van Moolenbroek u8_t have_chksum, u16_t chksum)
476*5d5fbe79SDavid van Moolenbroek {
477*5d5fbe79SDavid van Moolenbroek if ((pcb == NULL) || IP_IS_ANY_TYPE_VAL(pcb->remote_ip)) {
478*5d5fbe79SDavid van Moolenbroek return ERR_VAL;
479*5d5fbe79SDavid van Moolenbroek }
480*5d5fbe79SDavid van Moolenbroek
481*5d5fbe79SDavid van Moolenbroek /* send to the packet using remote ip and port stored in the pcb */
482*5d5fbe79SDavid van Moolenbroek return udp_sendto_chksum(pcb, p, &pcb->remote_ip, pcb->remote_port,
483*5d5fbe79SDavid van Moolenbroek have_chksum, chksum);
484*5d5fbe79SDavid van Moolenbroek }
485*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */
486*5d5fbe79SDavid van Moolenbroek
487*5d5fbe79SDavid van Moolenbroek /**
488*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
489*5d5fbe79SDavid van Moolenbroek * Send data to a specified address using UDP.
490*5d5fbe79SDavid van Moolenbroek *
491*5d5fbe79SDavid van Moolenbroek * @param pcb UDP PCB used to send the data.
492*5d5fbe79SDavid van Moolenbroek * @param p chain of pbuf's to be sent.
493*5d5fbe79SDavid van Moolenbroek * @param dst_ip Destination IP address.
494*5d5fbe79SDavid van Moolenbroek * @param dst_port Destination UDP port.
495*5d5fbe79SDavid van Moolenbroek *
496*5d5fbe79SDavid van Moolenbroek * dst_ip & dst_port are expected to be in the same byte order as in the pcb.
497*5d5fbe79SDavid van Moolenbroek *
498*5d5fbe79SDavid van Moolenbroek * If the PCB already has a remote address association, it will
499*5d5fbe79SDavid van Moolenbroek * be restored after the data is sent.
500*5d5fbe79SDavid van Moolenbroek *
501*5d5fbe79SDavid van Moolenbroek * @return lwIP error code (@see udp_send for possible error codes)
502*5d5fbe79SDavid van Moolenbroek *
503*5d5fbe79SDavid van Moolenbroek * @see udp_disconnect() udp_send()
504*5d5fbe79SDavid van Moolenbroek */
505*5d5fbe79SDavid van Moolenbroek err_t
udp_sendto(struct udp_pcb * pcb,struct pbuf * p,const ip_addr_t * dst_ip,u16_t dst_port)506*5d5fbe79SDavid van Moolenbroek udp_sendto(struct udp_pcb *pcb, struct pbuf *p,
507*5d5fbe79SDavid van Moolenbroek const ip_addr_t *dst_ip, u16_t dst_port)
508*5d5fbe79SDavid van Moolenbroek {
509*5d5fbe79SDavid van Moolenbroek #if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP
510*5d5fbe79SDavid van Moolenbroek return udp_sendto_chksum(pcb, p, dst_ip, dst_port, 0, 0);
511*5d5fbe79SDavid van Moolenbroek }
512*5d5fbe79SDavid van Moolenbroek
513*5d5fbe79SDavid van Moolenbroek /** @ingroup udp_raw
514*5d5fbe79SDavid van Moolenbroek * Same as udp_sendto(), but with checksum */
515*5d5fbe79SDavid van Moolenbroek err_t
udp_sendto_chksum(struct udp_pcb * pcb,struct pbuf * p,const ip_addr_t * dst_ip,u16_t dst_port,u8_t have_chksum,u16_t chksum)516*5d5fbe79SDavid van Moolenbroek udp_sendto_chksum(struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip,
517*5d5fbe79SDavid van Moolenbroek u16_t dst_port, u8_t have_chksum, u16_t chksum)
518*5d5fbe79SDavid van Moolenbroek {
519*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */
520*5d5fbe79SDavid van Moolenbroek struct netif *netif;
521*5d5fbe79SDavid van Moolenbroek const ip_addr_t *src_ip_route;
522*5d5fbe79SDavid van Moolenbroek
523*5d5fbe79SDavid van Moolenbroek if ((pcb == NULL) || (dst_ip == NULL) || !IP_ADDR_PCB_VERSION_MATCH(pcb, dst_ip)) {
524*5d5fbe79SDavid van Moolenbroek return ERR_VAL;
525*5d5fbe79SDavid van Moolenbroek }
526*5d5fbe79SDavid van Moolenbroek
527*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_send\n"));
528*5d5fbe79SDavid van Moolenbroek
529*5d5fbe79SDavid van Moolenbroek if (IP_IS_ANY_TYPE_VAL(pcb->local_ip)) {
530*5d5fbe79SDavid van Moolenbroek /* Don't call ip_route() with IP_ANY_TYPE */
531*5d5fbe79SDavid van Moolenbroek src_ip_route = IP46_ADDR_ANY(IP_GET_TYPE(dst_ip));
532*5d5fbe79SDavid van Moolenbroek } else {
533*5d5fbe79SDavid van Moolenbroek src_ip_route = &pcb->local_ip;
534*5d5fbe79SDavid van Moolenbroek }
535*5d5fbe79SDavid van Moolenbroek LWIP_UNUSED_ARG(src_ip_route); /* IPv4 only and no source based routing */
536*5d5fbe79SDavid van Moolenbroek
537*5d5fbe79SDavid van Moolenbroek #if LWIP_MULTICAST_TX_OPTIONS
538*5d5fbe79SDavid van Moolenbroek netif = NULL;
539*5d5fbe79SDavid van Moolenbroek if (ip_addr_ismulticast(dst_ip)) {
540*5d5fbe79SDavid van Moolenbroek /* For IPv6, the interface to use for packets with a multicast destination
541*5d5fbe79SDavid van Moolenbroek * is specified using an interface index. The same approach may be used for
542*5d5fbe79SDavid van Moolenbroek * IPv4 as well, in which case it overrides the IPv4 multicast override
543*5d5fbe79SDavid van Moolenbroek * address below. Here we have to look up the netif by going through the
544*5d5fbe79SDavid van Moolenbroek * list, but by doing so we skip a route lookup. If the interface index has
545*5d5fbe79SDavid van Moolenbroek * gone stale, we fall through and do the regular route lookup after all. */
546*5d5fbe79SDavid van Moolenbroek if (pcb->mcast_ifindex != NETIF_NO_INDEX) {
547*5d5fbe79SDavid van Moolenbroek netif = netif_get_by_index(pcb->mcast_ifindex);
548*5d5fbe79SDavid van Moolenbroek }
549*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4
550*5d5fbe79SDavid van Moolenbroek else
551*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV6
552*5d5fbe79SDavid van Moolenbroek if (IP_IS_V4(dst_ip))
553*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV6 */
554*5d5fbe79SDavid van Moolenbroek {
555*5d5fbe79SDavid van Moolenbroek /* IPv4 does not use source-based routing by default, so we use an
556*5d5fbe79SDavid van Moolenbroek administratively selected interface for multicast by default.
557*5d5fbe79SDavid van Moolenbroek However, this can be overridden by setting an interface address
558*5d5fbe79SDavid van Moolenbroek in pcb->mcast_ip4 that is used for routing. If this routing lookup
559*5d5fbe79SDavid van Moolenbroek fails, we try regular routing as though no override was set. */
560*5d5fbe79SDavid van Moolenbroek if (!ip4_addr_isany_val(pcb->mcast_ip4) &&
561*5d5fbe79SDavid van Moolenbroek !ip4_addr_cmp(&pcb->mcast_ip4, IP4_ADDR_BROADCAST)) {
562*5d5fbe79SDavid van Moolenbroek netif = ip4_route_src(ip_2_ip4(src_ip_route), &pcb->mcast_ip4);
563*5d5fbe79SDavid van Moolenbroek }
564*5d5fbe79SDavid van Moolenbroek }
565*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV4 */
566*5d5fbe79SDavid van Moolenbroek }
567*5d5fbe79SDavid van Moolenbroek
568*5d5fbe79SDavid van Moolenbroek if (netif == NULL)
569*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_MULTICAST_TX_OPTIONS */
570*5d5fbe79SDavid van Moolenbroek {
571*5d5fbe79SDavid van Moolenbroek /* find the outgoing network interface for this packet */
572*5d5fbe79SDavid van Moolenbroek netif = ip_route(src_ip_route, dst_ip);
573*5d5fbe79SDavid van Moolenbroek }
574*5d5fbe79SDavid van Moolenbroek
575*5d5fbe79SDavid van Moolenbroek /* no outgoing network interface could be found? */
576*5d5fbe79SDavid van Moolenbroek if (netif == NULL) {
577*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("udp_send: No route to "));
578*5d5fbe79SDavid van Moolenbroek ip_addr_debug_print(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, dst_ip);
579*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("\n"));
580*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.rterr);
581*5d5fbe79SDavid van Moolenbroek return ERR_RTE;
582*5d5fbe79SDavid van Moolenbroek }
583*5d5fbe79SDavid van Moolenbroek #if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP
584*5d5fbe79SDavid van Moolenbroek return udp_sendto_if_chksum(pcb, p, dst_ip, dst_port, netif, have_chksum, chksum);
585*5d5fbe79SDavid van Moolenbroek #else /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */
586*5d5fbe79SDavid van Moolenbroek return udp_sendto_if(pcb, p, dst_ip, dst_port, netif);
587*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */
588*5d5fbe79SDavid van Moolenbroek }
589*5d5fbe79SDavid van Moolenbroek
590*5d5fbe79SDavid van Moolenbroek /**
591*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
592*5d5fbe79SDavid van Moolenbroek * Send data to a specified address using UDP.
593*5d5fbe79SDavid van Moolenbroek * The netif used for sending can be specified.
594*5d5fbe79SDavid van Moolenbroek *
595*5d5fbe79SDavid van Moolenbroek * This function exists mainly for DHCP, to be able to send UDP packets
596*5d5fbe79SDavid van Moolenbroek * on a netif that is still down.
597*5d5fbe79SDavid van Moolenbroek *
598*5d5fbe79SDavid van Moolenbroek * @param pcb UDP PCB used to send the data.
599*5d5fbe79SDavid van Moolenbroek * @param p chain of pbuf's to be sent.
600*5d5fbe79SDavid van Moolenbroek * @param dst_ip Destination IP address.
601*5d5fbe79SDavid van Moolenbroek * @param dst_port Destination UDP port.
602*5d5fbe79SDavid van Moolenbroek * @param netif the netif used for sending.
603*5d5fbe79SDavid van Moolenbroek *
604*5d5fbe79SDavid van Moolenbroek * dst_ip & dst_port are expected to be in the same byte order as in the pcb.
605*5d5fbe79SDavid van Moolenbroek *
606*5d5fbe79SDavid van Moolenbroek * @return lwIP error code (@see udp_send for possible error codes)
607*5d5fbe79SDavid van Moolenbroek *
608*5d5fbe79SDavid van Moolenbroek * @see udp_disconnect() udp_send()
609*5d5fbe79SDavid van Moolenbroek */
610*5d5fbe79SDavid van Moolenbroek err_t
udp_sendto_if(struct udp_pcb * pcb,struct pbuf * p,const ip_addr_t * dst_ip,u16_t dst_port,struct netif * netif)611*5d5fbe79SDavid van Moolenbroek udp_sendto_if(struct udp_pcb *pcb, struct pbuf *p,
612*5d5fbe79SDavid van Moolenbroek const ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif)
613*5d5fbe79SDavid van Moolenbroek {
614*5d5fbe79SDavid van Moolenbroek #if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP
615*5d5fbe79SDavid van Moolenbroek return udp_sendto_if_chksum(pcb, p, dst_ip, dst_port, netif, 0, 0);
616*5d5fbe79SDavid van Moolenbroek }
617*5d5fbe79SDavid van Moolenbroek
618*5d5fbe79SDavid van Moolenbroek /** Same as udp_sendto_if(), but with checksum */
619*5d5fbe79SDavid van Moolenbroek err_t
udp_sendto_if_chksum(struct udp_pcb * pcb,struct pbuf * p,const ip_addr_t * dst_ip,u16_t dst_port,struct netif * netif,u8_t have_chksum,u16_t chksum)620*5d5fbe79SDavid van Moolenbroek udp_sendto_if_chksum(struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip,
621*5d5fbe79SDavid van Moolenbroek u16_t dst_port, struct netif *netif, u8_t have_chksum,
622*5d5fbe79SDavid van Moolenbroek u16_t chksum)
623*5d5fbe79SDavid van Moolenbroek {
624*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */
625*5d5fbe79SDavid van Moolenbroek const ip_addr_t *src_ip;
626*5d5fbe79SDavid van Moolenbroek
627*5d5fbe79SDavid van Moolenbroek if ((pcb == NULL) || (dst_ip == NULL) || !IP_ADDR_PCB_VERSION_MATCH(pcb, dst_ip)) {
628*5d5fbe79SDavid van Moolenbroek return ERR_VAL;
629*5d5fbe79SDavid van Moolenbroek }
630*5d5fbe79SDavid van Moolenbroek
631*5d5fbe79SDavid van Moolenbroek /* PCB local address is IP_ANY_ADDR or multicast? */
632*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV6
633*5d5fbe79SDavid van Moolenbroek if (IP_IS_V6(dst_ip)) {
634*5d5fbe79SDavid van Moolenbroek if (ip6_addr_isany(ip_2_ip6(&pcb->local_ip)) ||
635*5d5fbe79SDavid van Moolenbroek ip6_addr_ismulticast(ip_2_ip6(&pcb->local_ip))) {
636*5d5fbe79SDavid van Moolenbroek src_ip = ip6_select_source_address(netif, ip_2_ip6(dst_ip));
637*5d5fbe79SDavid van Moolenbroek if (src_ip == NULL) {
638*5d5fbe79SDavid van Moolenbroek /* No suitable source address was found. */
639*5d5fbe79SDavid van Moolenbroek return ERR_RTE;
640*5d5fbe79SDavid van Moolenbroek }
641*5d5fbe79SDavid van Moolenbroek } else {
642*5d5fbe79SDavid van Moolenbroek /* use UDP PCB local IPv6 address as source address, if still valid. */
643*5d5fbe79SDavid van Moolenbroek if (netif_get_ip6_addr_match(netif, ip_2_ip6(&pcb->local_ip)) < 0) {
644*5d5fbe79SDavid van Moolenbroek /* Address isn't valid anymore. */
645*5d5fbe79SDavid van Moolenbroek return ERR_RTE;
646*5d5fbe79SDavid van Moolenbroek }
647*5d5fbe79SDavid van Moolenbroek src_ip = &pcb->local_ip;
648*5d5fbe79SDavid van Moolenbroek }
649*5d5fbe79SDavid van Moolenbroek }
650*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV6 */
651*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4 && LWIP_IPV6
652*5d5fbe79SDavid van Moolenbroek else
653*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV4 && LWIP_IPV6 */
654*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4
655*5d5fbe79SDavid van Moolenbroek if (ip4_addr_isany(ip_2_ip4(&pcb->local_ip)) ||
656*5d5fbe79SDavid van Moolenbroek ip4_addr_ismulticast(ip_2_ip4(&pcb->local_ip))) {
657*5d5fbe79SDavid van Moolenbroek /* if the local_ip is any or multicast
658*5d5fbe79SDavid van Moolenbroek * use the outgoing network interface IP address as source address */
659*5d5fbe79SDavid van Moolenbroek src_ip = netif_ip_addr4(netif);
660*5d5fbe79SDavid van Moolenbroek } else {
661*5d5fbe79SDavid van Moolenbroek /* check if UDP PCB local IP address is correct
662*5d5fbe79SDavid van Moolenbroek * this could be an old address if netif->ip_addr has changed */
663*5d5fbe79SDavid van Moolenbroek if (!ip4_addr_cmp(ip_2_ip4(&(pcb->local_ip)), netif_ip4_addr(netif))) {
664*5d5fbe79SDavid van Moolenbroek /* local_ip doesn't match, drop the packet */
665*5d5fbe79SDavid van Moolenbroek return ERR_RTE;
666*5d5fbe79SDavid van Moolenbroek }
667*5d5fbe79SDavid van Moolenbroek /* use UDP PCB local IP address as source address */
668*5d5fbe79SDavid van Moolenbroek src_ip = &pcb->local_ip;
669*5d5fbe79SDavid van Moolenbroek }
670*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV4 */
671*5d5fbe79SDavid van Moolenbroek #if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP
672*5d5fbe79SDavid van Moolenbroek return udp_sendto_if_src_chksum(pcb, p, dst_ip, dst_port, netif, have_chksum, chksum, src_ip);
673*5d5fbe79SDavid van Moolenbroek #else /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */
674*5d5fbe79SDavid van Moolenbroek return udp_sendto_if_src(pcb, p, dst_ip, dst_port, netif, src_ip);
675*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */
676*5d5fbe79SDavid van Moolenbroek }
677*5d5fbe79SDavid van Moolenbroek
678*5d5fbe79SDavid van Moolenbroek /** @ingroup udp_raw
679*5d5fbe79SDavid van Moolenbroek * Same as @ref udp_sendto_if, but with source address */
680*5d5fbe79SDavid van Moolenbroek err_t
udp_sendto_if_src(struct udp_pcb * pcb,struct pbuf * p,const ip_addr_t * dst_ip,u16_t dst_port,struct netif * netif,const ip_addr_t * src_ip)681*5d5fbe79SDavid van Moolenbroek udp_sendto_if_src(struct udp_pcb *pcb, struct pbuf *p,
682*5d5fbe79SDavid van Moolenbroek const ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif, const ip_addr_t *src_ip)
683*5d5fbe79SDavid van Moolenbroek {
684*5d5fbe79SDavid van Moolenbroek #if LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP
685*5d5fbe79SDavid van Moolenbroek return udp_sendto_if_src_chksum(pcb, p, dst_ip, dst_port, netif, 0, 0, src_ip);
686*5d5fbe79SDavid van Moolenbroek }
687*5d5fbe79SDavid van Moolenbroek
688*5d5fbe79SDavid van Moolenbroek /** Same as udp_sendto_if_src(), but with checksum */
689*5d5fbe79SDavid van Moolenbroek err_t
udp_sendto_if_src_chksum(struct udp_pcb * pcb,struct pbuf * p,const ip_addr_t * dst_ip,u16_t dst_port,struct netif * netif,u8_t have_chksum,u16_t chksum,const ip_addr_t * src_ip)690*5d5fbe79SDavid van Moolenbroek udp_sendto_if_src_chksum(struct udp_pcb *pcb, struct pbuf *p, const ip_addr_t *dst_ip,
691*5d5fbe79SDavid van Moolenbroek u16_t dst_port, struct netif *netif, u8_t have_chksum,
692*5d5fbe79SDavid van Moolenbroek u16_t chksum, const ip_addr_t *src_ip)
693*5d5fbe79SDavid van Moolenbroek {
694*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_CHECKSUM_ON_COPY && CHECKSUM_GEN_UDP */
695*5d5fbe79SDavid van Moolenbroek struct udp_hdr *udphdr;
696*5d5fbe79SDavid van Moolenbroek err_t err;
697*5d5fbe79SDavid van Moolenbroek struct pbuf *q; /* q will be sent down the stack */
698*5d5fbe79SDavid van Moolenbroek u8_t ip_proto;
699*5d5fbe79SDavid van Moolenbroek u8_t ttl;
700*5d5fbe79SDavid van Moolenbroek
701*5d5fbe79SDavid van Moolenbroek if ((pcb == NULL) || (dst_ip == NULL) || !IP_ADDR_PCB_VERSION_MATCH(pcb, src_ip) ||
702*5d5fbe79SDavid van Moolenbroek !IP_ADDR_PCB_VERSION_MATCH(pcb, dst_ip)) {
703*5d5fbe79SDavid van Moolenbroek return ERR_VAL;
704*5d5fbe79SDavid van Moolenbroek }
705*5d5fbe79SDavid van Moolenbroek
706*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4 && IP_SOF_BROADCAST
707*5d5fbe79SDavid van Moolenbroek /* broadcast filter? */
708*5d5fbe79SDavid van Moolenbroek if (!ip_get_option(pcb, SOF_BROADCAST) &&
709*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV6
710*5d5fbe79SDavid van Moolenbroek IP_IS_V4(dst_ip) &&
711*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV6 */
712*5d5fbe79SDavid van Moolenbroek ip_addr_isbroadcast(dst_ip, netif)) {
713*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS,
714*5d5fbe79SDavid van Moolenbroek ("udp_sendto_if: SOF_BROADCAST not enabled on pcb %p\n", (void *)pcb));
715*5d5fbe79SDavid van Moolenbroek return ERR_VAL;
716*5d5fbe79SDavid van Moolenbroek }
717*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV4 && IP_SOF_BROADCAST */
718*5d5fbe79SDavid van Moolenbroek
719*5d5fbe79SDavid van Moolenbroek /* if the PCB is not yet bound to a port, bind it here */
720*5d5fbe79SDavid van Moolenbroek if (pcb->local_port == 0) {
721*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_send: not yet bound to a port, binding now\n"));
722*5d5fbe79SDavid van Moolenbroek err = udp_bind(pcb, &pcb->local_ip, pcb->local_port);
723*5d5fbe79SDavid van Moolenbroek if (err != ERR_OK) {
724*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("udp_send: forced port bind failed\n"));
725*5d5fbe79SDavid van Moolenbroek return err;
726*5d5fbe79SDavid van Moolenbroek }
727*5d5fbe79SDavid van Moolenbroek }
728*5d5fbe79SDavid van Moolenbroek
729*5d5fbe79SDavid van Moolenbroek /* packet too large to add a UDP header without causing an overflow? */
730*5d5fbe79SDavid van Moolenbroek if ((u16_t)(p->tot_len + UDP_HLEN) < p->tot_len) {
731*5d5fbe79SDavid van Moolenbroek return ERR_MEM;
732*5d5fbe79SDavid van Moolenbroek }
733*5d5fbe79SDavid van Moolenbroek /* not enough space to add an UDP header to first pbuf in given p chain? */
734*5d5fbe79SDavid van Moolenbroek if (pbuf_header(p, UDP_HLEN)) {
735*5d5fbe79SDavid van Moolenbroek /* allocate header in a separate new pbuf */
736*5d5fbe79SDavid van Moolenbroek q = pbuf_alloc(PBUF_IP, UDP_HLEN, PBUF_RAM);
737*5d5fbe79SDavid van Moolenbroek /* new header pbuf could not be allocated? */
738*5d5fbe79SDavid van Moolenbroek if (q == NULL) {
739*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("udp_send: could not allocate header\n"));
740*5d5fbe79SDavid van Moolenbroek return ERR_MEM;
741*5d5fbe79SDavid van Moolenbroek }
742*5d5fbe79SDavid van Moolenbroek if (p->tot_len != 0) {
743*5d5fbe79SDavid van Moolenbroek /* chain header q in front of given pbuf p (only if p contains data) */
744*5d5fbe79SDavid van Moolenbroek pbuf_chain(q, p);
745*5d5fbe79SDavid van Moolenbroek }
746*5d5fbe79SDavid van Moolenbroek /* first pbuf q points to header pbuf */
747*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG,
748*5d5fbe79SDavid van Moolenbroek ("udp_send: added header pbuf %p before given pbuf %p\n", (void *)q, (void *)p));
749*5d5fbe79SDavid van Moolenbroek } else {
750*5d5fbe79SDavid van Moolenbroek /* adding space for header within p succeeded */
751*5d5fbe79SDavid van Moolenbroek /* first pbuf q equals given pbuf */
752*5d5fbe79SDavid van Moolenbroek q = p;
753*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp_send: added header in given pbuf %p\n", (void *)p));
754*5d5fbe79SDavid van Moolenbroek }
755*5d5fbe79SDavid van Moolenbroek LWIP_ASSERT("check that first pbuf can hold struct udp_hdr",
756*5d5fbe79SDavid van Moolenbroek (q->len >= sizeof(struct udp_hdr)));
757*5d5fbe79SDavid van Moolenbroek /* q now represents the packet to be sent */
758*5d5fbe79SDavid van Moolenbroek udphdr = (struct udp_hdr *)q->payload;
759*5d5fbe79SDavid van Moolenbroek udphdr->src = lwip_htons(pcb->local_port);
760*5d5fbe79SDavid van Moolenbroek udphdr->dest = lwip_htons(dst_port);
761*5d5fbe79SDavid van Moolenbroek /* in UDP, 0 checksum means 'no checksum' */
762*5d5fbe79SDavid van Moolenbroek udphdr->chksum = 0x0000;
763*5d5fbe79SDavid van Moolenbroek
764*5d5fbe79SDavid van Moolenbroek /* Multicast Loop? */
765*5d5fbe79SDavid van Moolenbroek #if LWIP_MULTICAST_TX_OPTIONS
766*5d5fbe79SDavid van Moolenbroek if (((pcb->flags & UDP_FLAGS_MULTICAST_LOOP) != 0) && ip_addr_ismulticast(dst_ip)) {
767*5d5fbe79SDavid van Moolenbroek q->flags |= PBUF_FLAG_MCASTLOOP;
768*5d5fbe79SDavid van Moolenbroek }
769*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_MULTICAST_TX_OPTIONS */
770*5d5fbe79SDavid van Moolenbroek
771*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp_send: sending datagram of length %"U16_F"\n", q->tot_len));
772*5d5fbe79SDavid van Moolenbroek
773*5d5fbe79SDavid van Moolenbroek #if LWIP_UDPLITE
774*5d5fbe79SDavid van Moolenbroek /* UDP Lite protocol? */
775*5d5fbe79SDavid van Moolenbroek if (pcb->flags & UDP_FLAGS_UDPLITE) {
776*5d5fbe79SDavid van Moolenbroek u16_t chklen, chklen_hdr;
777*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp_send: UDP LITE packet length %"U16_F"\n", q->tot_len));
778*5d5fbe79SDavid van Moolenbroek /* set UDP message length in UDP header */
779*5d5fbe79SDavid van Moolenbroek chklen_hdr = chklen = pcb->chksum_len_tx;
780*5d5fbe79SDavid van Moolenbroek if ((chklen < sizeof(struct udp_hdr)) || (chklen > q->tot_len)) {
781*5d5fbe79SDavid van Moolenbroek if (chklen != 0) {
782*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp_send: UDP LITE pcb->chksum_len is illegal: %"U16_F"\n", chklen));
783*5d5fbe79SDavid van Moolenbroek }
784*5d5fbe79SDavid van Moolenbroek /* For UDP-Lite, checksum length of 0 means checksum
785*5d5fbe79SDavid van Moolenbroek over the complete packet. (See RFC 3828 chap. 3.1)
786*5d5fbe79SDavid van Moolenbroek At least the UDP-Lite header must be covered by the
787*5d5fbe79SDavid van Moolenbroek checksum, therefore, if chksum_len has an illegal
788*5d5fbe79SDavid van Moolenbroek value, we generate the checksum over the complete
789*5d5fbe79SDavid van Moolenbroek packet to be safe. */
790*5d5fbe79SDavid van Moolenbroek chklen_hdr = 0;
791*5d5fbe79SDavid van Moolenbroek chklen = q->tot_len;
792*5d5fbe79SDavid van Moolenbroek }
793*5d5fbe79SDavid van Moolenbroek udphdr->len = lwip_htons(chklen_hdr);
794*5d5fbe79SDavid van Moolenbroek /* calculate checksum */
795*5d5fbe79SDavid van Moolenbroek #if CHECKSUM_GEN_UDP
796*5d5fbe79SDavid van Moolenbroek IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_UDP) {
797*5d5fbe79SDavid van Moolenbroek #if LWIP_CHECKSUM_ON_COPY
798*5d5fbe79SDavid van Moolenbroek if (have_chksum) {
799*5d5fbe79SDavid van Moolenbroek chklen = UDP_HLEN;
800*5d5fbe79SDavid van Moolenbroek }
801*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_CHECKSUM_ON_COPY */
802*5d5fbe79SDavid van Moolenbroek udphdr->chksum = ip_chksum_pseudo_partial(q, IP_PROTO_UDPLITE,
803*5d5fbe79SDavid van Moolenbroek q->tot_len, chklen, src_ip, dst_ip);
804*5d5fbe79SDavid van Moolenbroek #if LWIP_CHECKSUM_ON_COPY
805*5d5fbe79SDavid van Moolenbroek if (have_chksum) {
806*5d5fbe79SDavid van Moolenbroek u32_t acc;
807*5d5fbe79SDavid van Moolenbroek acc = udphdr->chksum + (u16_t)~(chksum);
808*5d5fbe79SDavid van Moolenbroek udphdr->chksum = FOLD_U32T(acc);
809*5d5fbe79SDavid van Moolenbroek }
810*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_CHECKSUM_ON_COPY */
811*5d5fbe79SDavid van Moolenbroek
812*5d5fbe79SDavid van Moolenbroek /* chksum zero must become 0xffff, as zero means 'no checksum' */
813*5d5fbe79SDavid van Moolenbroek if (udphdr->chksum == 0x0000) {
814*5d5fbe79SDavid van Moolenbroek udphdr->chksum = 0xffff;
815*5d5fbe79SDavid van Moolenbroek }
816*5d5fbe79SDavid van Moolenbroek }
817*5d5fbe79SDavid van Moolenbroek #endif /* CHECKSUM_GEN_UDP */
818*5d5fbe79SDavid van Moolenbroek
819*5d5fbe79SDavid van Moolenbroek ip_proto = IP_PROTO_UDPLITE;
820*5d5fbe79SDavid van Moolenbroek } else
821*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_UDPLITE */
822*5d5fbe79SDavid van Moolenbroek { /* UDP */
823*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp_send: UDP packet length %"U16_F"\n", q->tot_len));
824*5d5fbe79SDavid van Moolenbroek udphdr->len = lwip_htons(q->tot_len);
825*5d5fbe79SDavid van Moolenbroek /* calculate checksum */
826*5d5fbe79SDavid van Moolenbroek #if CHECKSUM_GEN_UDP
827*5d5fbe79SDavid van Moolenbroek IF__NETIF_CHECKSUM_ENABLED(netif, NETIF_CHECKSUM_GEN_UDP) {
828*5d5fbe79SDavid van Moolenbroek /* Checksum is mandatory over IPv6. */
829*5d5fbe79SDavid van Moolenbroek if (IP_IS_V6(dst_ip) || (pcb->flags & UDP_FLAGS_NOCHKSUM) == 0) {
830*5d5fbe79SDavid van Moolenbroek u16_t udpchksum;
831*5d5fbe79SDavid van Moolenbroek #if LWIP_CHECKSUM_ON_COPY
832*5d5fbe79SDavid van Moolenbroek if (have_chksum) {
833*5d5fbe79SDavid van Moolenbroek u32_t acc;
834*5d5fbe79SDavid van Moolenbroek udpchksum = ip_chksum_pseudo_partial(q, IP_PROTO_UDP,
835*5d5fbe79SDavid van Moolenbroek q->tot_len, UDP_HLEN, src_ip, dst_ip);
836*5d5fbe79SDavid van Moolenbroek acc = udpchksum + (u16_t)~(chksum);
837*5d5fbe79SDavid van Moolenbroek udpchksum = FOLD_U32T(acc);
838*5d5fbe79SDavid van Moolenbroek } else
839*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_CHECKSUM_ON_COPY */
840*5d5fbe79SDavid van Moolenbroek {
841*5d5fbe79SDavid van Moolenbroek udpchksum = ip_chksum_pseudo(q, IP_PROTO_UDP, q->tot_len,
842*5d5fbe79SDavid van Moolenbroek src_ip, dst_ip);
843*5d5fbe79SDavid van Moolenbroek }
844*5d5fbe79SDavid van Moolenbroek
845*5d5fbe79SDavid van Moolenbroek /* chksum zero must become 0xffff, as zero means 'no checksum' */
846*5d5fbe79SDavid van Moolenbroek if (udpchksum == 0x0000) {
847*5d5fbe79SDavid van Moolenbroek udpchksum = 0xffff;
848*5d5fbe79SDavid van Moolenbroek }
849*5d5fbe79SDavid van Moolenbroek udphdr->chksum = udpchksum;
850*5d5fbe79SDavid van Moolenbroek }
851*5d5fbe79SDavid van Moolenbroek }
852*5d5fbe79SDavid van Moolenbroek #endif /* CHECKSUM_GEN_UDP */
853*5d5fbe79SDavid van Moolenbroek ip_proto = IP_PROTO_UDP;
854*5d5fbe79SDavid van Moolenbroek }
855*5d5fbe79SDavid van Moolenbroek
856*5d5fbe79SDavid van Moolenbroek /* Determine TTL to use */
857*5d5fbe79SDavid van Moolenbroek #if LWIP_MULTICAST_TX_OPTIONS
858*5d5fbe79SDavid van Moolenbroek ttl = (ip_addr_ismulticast(dst_ip) ? udp_get_multicast_ttl(pcb) : pcb->ttl);
859*5d5fbe79SDavid van Moolenbroek #else /* LWIP_MULTICAST_TX_OPTIONS */
860*5d5fbe79SDavid van Moolenbroek ttl = pcb->ttl;
861*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_MULTICAST_TX_OPTIONS */
862*5d5fbe79SDavid van Moolenbroek
863*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp_send: UDP checksum 0x%04"X16_F"\n", udphdr->chksum));
864*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp_send: ip_output_if (,,,,0x%02"X16_F",)\n", (u16_t)ip_proto));
865*5d5fbe79SDavid van Moolenbroek /* output to IP */
866*5d5fbe79SDavid van Moolenbroek NETIF_SET_HWADDRHINT(netif, &(pcb->addr_hint));
867*5d5fbe79SDavid van Moolenbroek err = ip_output_if_src(q, src_ip, dst_ip, ttl, pcb->tos, ip_proto, netif);
868*5d5fbe79SDavid van Moolenbroek NETIF_SET_HWADDRHINT(netif, NULL);
869*5d5fbe79SDavid van Moolenbroek
870*5d5fbe79SDavid van Moolenbroek /* @todo: must this be increased even if error occurred? */
871*5d5fbe79SDavid van Moolenbroek MIB2_STATS_INC(mib2.udpoutdatagrams);
872*5d5fbe79SDavid van Moolenbroek
873*5d5fbe79SDavid van Moolenbroek /* did we chain a separate header pbuf earlier? */
874*5d5fbe79SDavid van Moolenbroek if (q != p) {
875*5d5fbe79SDavid van Moolenbroek /* free the header pbuf */
876*5d5fbe79SDavid van Moolenbroek pbuf_free(q);
877*5d5fbe79SDavid van Moolenbroek q = NULL;
878*5d5fbe79SDavid van Moolenbroek /* p is still referenced by the caller, and will live on */
879*5d5fbe79SDavid van Moolenbroek }
880*5d5fbe79SDavid van Moolenbroek
881*5d5fbe79SDavid van Moolenbroek UDP_STATS_INC(udp.xmit);
882*5d5fbe79SDavid van Moolenbroek return err;
883*5d5fbe79SDavid van Moolenbroek }
884*5d5fbe79SDavid van Moolenbroek
885*5d5fbe79SDavid van Moolenbroek /**
886*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
887*5d5fbe79SDavid van Moolenbroek * Bind an UDP PCB.
888*5d5fbe79SDavid van Moolenbroek *
889*5d5fbe79SDavid van Moolenbroek * @param pcb UDP PCB to be bound with a local address ipaddr and port.
890*5d5fbe79SDavid van Moolenbroek * @param ipaddr local IP address to bind with. Use IP4_ADDR_ANY to
891*5d5fbe79SDavid van Moolenbroek * bind to all local interfaces.
892*5d5fbe79SDavid van Moolenbroek * @param port local UDP port to bind with. Use 0 to automatically bind
893*5d5fbe79SDavid van Moolenbroek * to a random port between UDP_LOCAL_PORT_RANGE_START and
894*5d5fbe79SDavid van Moolenbroek * UDP_LOCAL_PORT_RANGE_END.
895*5d5fbe79SDavid van Moolenbroek *
896*5d5fbe79SDavid van Moolenbroek * ipaddr & port are expected to be in the same byte order as in the pcb.
897*5d5fbe79SDavid van Moolenbroek *
898*5d5fbe79SDavid van Moolenbroek * @return lwIP error code.
899*5d5fbe79SDavid van Moolenbroek * - ERR_OK. Successful. No error occurred.
900*5d5fbe79SDavid van Moolenbroek * - ERR_USE. The specified ipaddr and port are already bound to by
901*5d5fbe79SDavid van Moolenbroek * another UDP PCB.
902*5d5fbe79SDavid van Moolenbroek *
903*5d5fbe79SDavid van Moolenbroek * @see udp_disconnect()
904*5d5fbe79SDavid van Moolenbroek */
905*5d5fbe79SDavid van Moolenbroek err_t
udp_bind(struct udp_pcb * pcb,const ip_addr_t * ipaddr,u16_t port)906*5d5fbe79SDavid van Moolenbroek udp_bind(struct udp_pcb *pcb, const ip_addr_t *ipaddr, u16_t port)
907*5d5fbe79SDavid van Moolenbroek {
908*5d5fbe79SDavid van Moolenbroek struct udp_pcb *ipcb;
909*5d5fbe79SDavid van Moolenbroek u8_t rebind;
910*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV6 && LWIP_IPV6_SCOPES
911*5d5fbe79SDavid van Moolenbroek ip_addr_t zoned_ipaddr;
912*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV6 && LWIP_IPV6_SCOPES */
913*5d5fbe79SDavid van Moolenbroek
914*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4
915*5d5fbe79SDavid van Moolenbroek /* Don't propagate NULL pointer (IPv4 ANY) to subsequent functions */
916*5d5fbe79SDavid van Moolenbroek if (ipaddr == NULL) {
917*5d5fbe79SDavid van Moolenbroek ipaddr = IP4_ADDR_ANY;
918*5d5fbe79SDavid van Moolenbroek }
919*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV4 */
920*5d5fbe79SDavid van Moolenbroek
921*5d5fbe79SDavid van Moolenbroek /* still need to check for ipaddr == NULL in IPv6 only case */
922*5d5fbe79SDavid van Moolenbroek if ((pcb == NULL) || (ipaddr == NULL)) {
923*5d5fbe79SDavid van Moolenbroek return ERR_VAL;
924*5d5fbe79SDavid van Moolenbroek }
925*5d5fbe79SDavid van Moolenbroek
926*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_bind(ipaddr = "));
927*5d5fbe79SDavid van Moolenbroek ip_addr_debug_print(UDP_DEBUG | LWIP_DBG_TRACE, ipaddr);
928*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, (", port = %"U16_F")\n", port));
929*5d5fbe79SDavid van Moolenbroek
930*5d5fbe79SDavid van Moolenbroek rebind = 0;
931*5d5fbe79SDavid van Moolenbroek /* Check for double bind and rebind of the same pcb */
932*5d5fbe79SDavid van Moolenbroek for (ipcb = udp_pcbs; ipcb != NULL; ipcb = ipcb->next) {
933*5d5fbe79SDavid van Moolenbroek /* is this UDP PCB already on active list? */
934*5d5fbe79SDavid van Moolenbroek if (pcb == ipcb) {
935*5d5fbe79SDavid van Moolenbroek rebind = 1;
936*5d5fbe79SDavid van Moolenbroek break;
937*5d5fbe79SDavid van Moolenbroek }
938*5d5fbe79SDavid van Moolenbroek }
939*5d5fbe79SDavid van Moolenbroek
940*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV6 && LWIP_IPV6_SCOPES
941*5d5fbe79SDavid van Moolenbroek /* If the given IP address should have a zone but doesn't, assign one now.
942*5d5fbe79SDavid van Moolenbroek * This is legacy support: scope-aware callers should always provide properly
943*5d5fbe79SDavid van Moolenbroek * zoned source addresses. Do the zone selection before the address-in-use
944*5d5fbe79SDavid van Moolenbroek * check below; as such we have to make a temporary copy of the address. */
945*5d5fbe79SDavid van Moolenbroek if (IP_IS_V6(ipaddr) && ip6_addr_lacks_zone(ip_2_ip6(ipaddr), IP6_UNKNOWN)) {
946*5d5fbe79SDavid van Moolenbroek ip_addr_copy(zoned_ipaddr, *ipaddr);
947*5d5fbe79SDavid van Moolenbroek ip6_addr_select_zone(ip_2_ip6(&zoned_ipaddr), ip_2_ip6(&zoned_ipaddr));
948*5d5fbe79SDavid van Moolenbroek ipaddr = &zoned_ipaddr;
949*5d5fbe79SDavid van Moolenbroek }
950*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV6 && LWIP_IPV6_SCOPES */
951*5d5fbe79SDavid van Moolenbroek
952*5d5fbe79SDavid van Moolenbroek /* no port specified? */
953*5d5fbe79SDavid van Moolenbroek if (port == 0) {
954*5d5fbe79SDavid van Moolenbroek port = udp_new_port();
955*5d5fbe79SDavid van Moolenbroek if (port == 0) {
956*5d5fbe79SDavid van Moolenbroek /* no more ports available in local range */
957*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("udp_bind: out of free UDP ports\n"));
958*5d5fbe79SDavid van Moolenbroek return ERR_USE;
959*5d5fbe79SDavid van Moolenbroek }
960*5d5fbe79SDavid van Moolenbroek } else {
961*5d5fbe79SDavid van Moolenbroek for (ipcb = udp_pcbs; ipcb != NULL; ipcb = ipcb->next) {
962*5d5fbe79SDavid van Moolenbroek if (pcb != ipcb) {
963*5d5fbe79SDavid van Moolenbroek /* By default, we don't allow to bind to a port that any other udp
964*5d5fbe79SDavid van Moolenbroek PCB is already bound to, unless *all* PCBs with that port have tha
965*5d5fbe79SDavid van Moolenbroek REUSEADDR flag set. */
966*5d5fbe79SDavid van Moolenbroek #if SO_REUSE
967*5d5fbe79SDavid van Moolenbroek if (!ip_get_option(pcb, SOF_REUSEADDR) ||
968*5d5fbe79SDavid van Moolenbroek !ip_get_option(ipcb, SOF_REUSEADDR))
969*5d5fbe79SDavid van Moolenbroek #endif /* SO_REUSE */
970*5d5fbe79SDavid van Moolenbroek {
971*5d5fbe79SDavid van Moolenbroek /* port matches that of PCB in list and REUSEADDR not set -> reject */
972*5d5fbe79SDavid van Moolenbroek if ((ipcb->local_port == port) &&
973*5d5fbe79SDavid van Moolenbroek /* IP address matches? */
974*5d5fbe79SDavid van Moolenbroek ip_addr_cmp(&ipcb->local_ip, ipaddr)) {
975*5d5fbe79SDavid van Moolenbroek /* other PCB already binds to this local IP and port */
976*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG,
977*5d5fbe79SDavid van Moolenbroek ("udp_bind: local port %"U16_F" already bound by another pcb\n", port));
978*5d5fbe79SDavid van Moolenbroek return ERR_USE;
979*5d5fbe79SDavid van Moolenbroek }
980*5d5fbe79SDavid van Moolenbroek }
981*5d5fbe79SDavid van Moolenbroek }
982*5d5fbe79SDavid van Moolenbroek }
983*5d5fbe79SDavid van Moolenbroek }
984*5d5fbe79SDavid van Moolenbroek
985*5d5fbe79SDavid van Moolenbroek ip_addr_set_ipaddr(&pcb->local_ip, ipaddr);
986*5d5fbe79SDavid van Moolenbroek
987*5d5fbe79SDavid van Moolenbroek pcb->local_port = port;
988*5d5fbe79SDavid van Moolenbroek mib2_udp_bind(pcb);
989*5d5fbe79SDavid van Moolenbroek /* pcb not active yet? */
990*5d5fbe79SDavid van Moolenbroek if (rebind == 0) {
991*5d5fbe79SDavid van Moolenbroek /* place the PCB on the active list if not already there */
992*5d5fbe79SDavid van Moolenbroek pcb->next = udp_pcbs;
993*5d5fbe79SDavid van Moolenbroek udp_pcbs = pcb;
994*5d5fbe79SDavid van Moolenbroek }
995*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("udp_bind: bound to "));
996*5d5fbe79SDavid van Moolenbroek ip_addr_debug_print(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, &pcb->local_ip);
997*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, (", port %"U16_F")\n", pcb->local_port));
998*5d5fbe79SDavid van Moolenbroek return ERR_OK;
999*5d5fbe79SDavid van Moolenbroek }
1000*5d5fbe79SDavid van Moolenbroek
1001*5d5fbe79SDavid van Moolenbroek /**
1002*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
1003*5d5fbe79SDavid van Moolenbroek * Connect an UDP PCB.
1004*5d5fbe79SDavid van Moolenbroek *
1005*5d5fbe79SDavid van Moolenbroek * This will associate the UDP PCB with the remote address.
1006*5d5fbe79SDavid van Moolenbroek *
1007*5d5fbe79SDavid van Moolenbroek * @param pcb UDP PCB to be connected with remote address ipaddr and port.
1008*5d5fbe79SDavid van Moolenbroek * @param ipaddr remote IP address to connect with.
1009*5d5fbe79SDavid van Moolenbroek * @param port remote UDP port to connect with.
1010*5d5fbe79SDavid van Moolenbroek *
1011*5d5fbe79SDavid van Moolenbroek * @return lwIP error code
1012*5d5fbe79SDavid van Moolenbroek *
1013*5d5fbe79SDavid van Moolenbroek * ipaddr & port are expected to be in the same byte order as in the pcb.
1014*5d5fbe79SDavid van Moolenbroek *
1015*5d5fbe79SDavid van Moolenbroek * The udp pcb is bound to a random local port if not already bound.
1016*5d5fbe79SDavid van Moolenbroek *
1017*5d5fbe79SDavid van Moolenbroek * @see udp_disconnect()
1018*5d5fbe79SDavid van Moolenbroek */
1019*5d5fbe79SDavid van Moolenbroek err_t
udp_connect(struct udp_pcb * pcb,const ip_addr_t * ipaddr,u16_t port)1020*5d5fbe79SDavid van Moolenbroek udp_connect(struct udp_pcb *pcb, const ip_addr_t *ipaddr, u16_t port)
1021*5d5fbe79SDavid van Moolenbroek {
1022*5d5fbe79SDavid van Moolenbroek struct udp_pcb *ipcb;
1023*5d5fbe79SDavid van Moolenbroek
1024*5d5fbe79SDavid van Moolenbroek if ((pcb == NULL) || (ipaddr == NULL)) {
1025*5d5fbe79SDavid van Moolenbroek return ERR_VAL;
1026*5d5fbe79SDavid van Moolenbroek }
1027*5d5fbe79SDavid van Moolenbroek
1028*5d5fbe79SDavid van Moolenbroek if (pcb->local_port == 0) {
1029*5d5fbe79SDavid van Moolenbroek err_t err = udp_bind(pcb, &pcb->local_ip, pcb->local_port);
1030*5d5fbe79SDavid van Moolenbroek if (err != ERR_OK) {
1031*5d5fbe79SDavid van Moolenbroek return err;
1032*5d5fbe79SDavid van Moolenbroek }
1033*5d5fbe79SDavid van Moolenbroek }
1034*5d5fbe79SDavid van Moolenbroek
1035*5d5fbe79SDavid van Moolenbroek ip_addr_set_ipaddr(&pcb->remote_ip, ipaddr);
1036*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV6 && LWIP_IPV6_SCOPES
1037*5d5fbe79SDavid van Moolenbroek /* If the given IP address should have a zone but doesn't, assign one now,
1038*5d5fbe79SDavid van Moolenbroek * using the bound address to make a more informed decision when possible. */
1039*5d5fbe79SDavid van Moolenbroek if (IP_IS_V6(&pcb->remote_ip) &&
1040*5d5fbe79SDavid van Moolenbroek ip6_addr_lacks_zone(ip_2_ip6(&pcb->remote_ip), IP6_UNKNOWN)) {
1041*5d5fbe79SDavid van Moolenbroek ip6_addr_select_zone(ip_2_ip6(&pcb->remote_ip), ip_2_ip6(&pcb->local_ip));
1042*5d5fbe79SDavid van Moolenbroek }
1043*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV6 && LWIP_IPV6_SCOPES */
1044*5d5fbe79SDavid van Moolenbroek
1045*5d5fbe79SDavid van Moolenbroek pcb->remote_port = port;
1046*5d5fbe79SDavid van Moolenbroek pcb->flags |= UDP_FLAGS_CONNECTED;
1047*5d5fbe79SDavid van Moolenbroek
1048*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("udp_connect: connected to "));
1049*5d5fbe79SDavid van Moolenbroek ip_addr_debug_print(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE,
1050*5d5fbe79SDavid van Moolenbroek &pcb->remote_ip);
1051*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, (", port %"U16_F")\n", pcb->remote_port));
1052*5d5fbe79SDavid van Moolenbroek
1053*5d5fbe79SDavid van Moolenbroek /* Insert UDP PCB into the list of active UDP PCBs. */
1054*5d5fbe79SDavid van Moolenbroek for (ipcb = udp_pcbs; ipcb != NULL; ipcb = ipcb->next) {
1055*5d5fbe79SDavid van Moolenbroek if (pcb == ipcb) {
1056*5d5fbe79SDavid van Moolenbroek /* already on the list, just return */
1057*5d5fbe79SDavid van Moolenbroek return ERR_OK;
1058*5d5fbe79SDavid van Moolenbroek }
1059*5d5fbe79SDavid van Moolenbroek }
1060*5d5fbe79SDavid van Moolenbroek /* PCB not yet on the list, add PCB now */
1061*5d5fbe79SDavid van Moolenbroek pcb->next = udp_pcbs;
1062*5d5fbe79SDavid van Moolenbroek udp_pcbs = pcb;
1063*5d5fbe79SDavid van Moolenbroek return ERR_OK;
1064*5d5fbe79SDavid van Moolenbroek }
1065*5d5fbe79SDavid van Moolenbroek
1066*5d5fbe79SDavid van Moolenbroek /**
1067*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
1068*5d5fbe79SDavid van Moolenbroek * Disconnect a UDP PCB
1069*5d5fbe79SDavid van Moolenbroek *
1070*5d5fbe79SDavid van Moolenbroek * @param pcb the udp pcb to disconnect.
1071*5d5fbe79SDavid van Moolenbroek */
1072*5d5fbe79SDavid van Moolenbroek void
udp_disconnect(struct udp_pcb * pcb)1073*5d5fbe79SDavid van Moolenbroek udp_disconnect(struct udp_pcb *pcb)
1074*5d5fbe79SDavid van Moolenbroek {
1075*5d5fbe79SDavid van Moolenbroek /* reset remote address association */
1076*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4 && LWIP_IPV6
1077*5d5fbe79SDavid van Moolenbroek if (IP_IS_ANY_TYPE_VAL(pcb->local_ip)) {
1078*5d5fbe79SDavid van Moolenbroek ip_addr_copy(pcb->remote_ip, *IP_ANY_TYPE);
1079*5d5fbe79SDavid van Moolenbroek } else {
1080*5d5fbe79SDavid van Moolenbroek #endif
1081*5d5fbe79SDavid van Moolenbroek ip_addr_set_any(IP_IS_V6_VAL(pcb->remote_ip), &pcb->remote_ip);
1082*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4 && LWIP_IPV6
1083*5d5fbe79SDavid van Moolenbroek }
1084*5d5fbe79SDavid van Moolenbroek #endif
1085*5d5fbe79SDavid van Moolenbroek pcb->remote_port = 0;
1086*5d5fbe79SDavid van Moolenbroek /* mark PCB as unconnected */
1087*5d5fbe79SDavid van Moolenbroek pcb->flags &= ~UDP_FLAGS_CONNECTED;
1088*5d5fbe79SDavid van Moolenbroek }
1089*5d5fbe79SDavid van Moolenbroek
1090*5d5fbe79SDavid van Moolenbroek /**
1091*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
1092*5d5fbe79SDavid van Moolenbroek * Set a receive callback for a UDP PCB
1093*5d5fbe79SDavid van Moolenbroek *
1094*5d5fbe79SDavid van Moolenbroek * This callback will be called when receiving a datagram for the pcb.
1095*5d5fbe79SDavid van Moolenbroek *
1096*5d5fbe79SDavid van Moolenbroek * @param pcb the pcb for which to set the recv callback
1097*5d5fbe79SDavid van Moolenbroek * @param recv function pointer of the callback function
1098*5d5fbe79SDavid van Moolenbroek * @param recv_arg additional argument to pass to the callback function
1099*5d5fbe79SDavid van Moolenbroek */
1100*5d5fbe79SDavid van Moolenbroek void
udp_recv(struct udp_pcb * pcb,udp_recv_fn recv,void * recv_arg)1101*5d5fbe79SDavid van Moolenbroek udp_recv(struct udp_pcb *pcb, udp_recv_fn recv, void *recv_arg)
1102*5d5fbe79SDavid van Moolenbroek {
1103*5d5fbe79SDavid van Moolenbroek /* remember recv() callback and user data */
1104*5d5fbe79SDavid van Moolenbroek pcb->recv = recv;
1105*5d5fbe79SDavid van Moolenbroek pcb->recv_arg = recv_arg;
1106*5d5fbe79SDavid van Moolenbroek }
1107*5d5fbe79SDavid van Moolenbroek
1108*5d5fbe79SDavid van Moolenbroek /**
1109*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
1110*5d5fbe79SDavid van Moolenbroek * Remove an UDP PCB.
1111*5d5fbe79SDavid van Moolenbroek *
1112*5d5fbe79SDavid van Moolenbroek * @param pcb UDP PCB to be removed. The PCB is removed from the list of
1113*5d5fbe79SDavid van Moolenbroek * UDP PCB's and the data structure is freed from memory.
1114*5d5fbe79SDavid van Moolenbroek *
1115*5d5fbe79SDavid van Moolenbroek * @see udp_new()
1116*5d5fbe79SDavid van Moolenbroek */
1117*5d5fbe79SDavid van Moolenbroek void
udp_remove(struct udp_pcb * pcb)1118*5d5fbe79SDavid van Moolenbroek udp_remove(struct udp_pcb *pcb)
1119*5d5fbe79SDavid van Moolenbroek {
1120*5d5fbe79SDavid van Moolenbroek struct udp_pcb *pcb2;
1121*5d5fbe79SDavid van Moolenbroek
1122*5d5fbe79SDavid van Moolenbroek mib2_udp_unbind(pcb);
1123*5d5fbe79SDavid van Moolenbroek /* pcb to be removed is first in list? */
1124*5d5fbe79SDavid van Moolenbroek if (udp_pcbs == pcb) {
1125*5d5fbe79SDavid van Moolenbroek /* make list start at 2nd pcb */
1126*5d5fbe79SDavid van Moolenbroek udp_pcbs = udp_pcbs->next;
1127*5d5fbe79SDavid van Moolenbroek /* pcb not 1st in list */
1128*5d5fbe79SDavid van Moolenbroek } else {
1129*5d5fbe79SDavid van Moolenbroek for (pcb2 = udp_pcbs; pcb2 != NULL; pcb2 = pcb2->next) {
1130*5d5fbe79SDavid van Moolenbroek /* find pcb in udp_pcbs list */
1131*5d5fbe79SDavid van Moolenbroek if (pcb2->next != NULL && pcb2->next == pcb) {
1132*5d5fbe79SDavid van Moolenbroek /* remove pcb from list */
1133*5d5fbe79SDavid van Moolenbroek pcb2->next = pcb->next;
1134*5d5fbe79SDavid van Moolenbroek break;
1135*5d5fbe79SDavid van Moolenbroek }
1136*5d5fbe79SDavid van Moolenbroek }
1137*5d5fbe79SDavid van Moolenbroek }
1138*5d5fbe79SDavid van Moolenbroek memp_free(MEMP_UDP_PCB, pcb);
1139*5d5fbe79SDavid van Moolenbroek }
1140*5d5fbe79SDavid van Moolenbroek
1141*5d5fbe79SDavid van Moolenbroek /**
1142*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
1143*5d5fbe79SDavid van Moolenbroek * Create a UDP PCB.
1144*5d5fbe79SDavid van Moolenbroek *
1145*5d5fbe79SDavid van Moolenbroek * @return The UDP PCB which was created. NULL if the PCB data structure
1146*5d5fbe79SDavid van Moolenbroek * could not be allocated.
1147*5d5fbe79SDavid van Moolenbroek *
1148*5d5fbe79SDavid van Moolenbroek * @see udp_remove()
1149*5d5fbe79SDavid van Moolenbroek */
1150*5d5fbe79SDavid van Moolenbroek struct udp_pcb *
udp_new(void)1151*5d5fbe79SDavid van Moolenbroek udp_new(void)
1152*5d5fbe79SDavid van Moolenbroek {
1153*5d5fbe79SDavid van Moolenbroek struct udp_pcb *pcb;
1154*5d5fbe79SDavid van Moolenbroek pcb = (struct udp_pcb *)memp_malloc(MEMP_UDP_PCB);
1155*5d5fbe79SDavid van Moolenbroek /* could allocate UDP PCB? */
1156*5d5fbe79SDavid van Moolenbroek if (pcb != NULL) {
1157*5d5fbe79SDavid van Moolenbroek /* UDP Lite: by initializing to all zeroes, chksum_len is set to 0
1158*5d5fbe79SDavid van Moolenbroek * which means checksum is generated over the whole datagram per default
1159*5d5fbe79SDavid van Moolenbroek * (recommended as default by RFC 3828). */
1160*5d5fbe79SDavid van Moolenbroek /* initialize PCB to all zeroes */
1161*5d5fbe79SDavid van Moolenbroek memset(pcb, 0, sizeof(struct udp_pcb));
1162*5d5fbe79SDavid van Moolenbroek pcb->ttl = UDP_TTL;
1163*5d5fbe79SDavid van Moolenbroek #if LWIP_MULTICAST_TX_OPTIONS
1164*5d5fbe79SDavid van Moolenbroek udp_set_multicast_ttl(pcb, UDP_TTL);
1165*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_MULTICAST_TX_OPTIONS */
1166*5d5fbe79SDavid van Moolenbroek }
1167*5d5fbe79SDavid van Moolenbroek return pcb;
1168*5d5fbe79SDavid van Moolenbroek }
1169*5d5fbe79SDavid van Moolenbroek
1170*5d5fbe79SDavid van Moolenbroek /**
1171*5d5fbe79SDavid van Moolenbroek * @ingroup udp_raw
1172*5d5fbe79SDavid van Moolenbroek * Create a UDP PCB for specific IP type.
1173*5d5fbe79SDavid van Moolenbroek *
1174*5d5fbe79SDavid van Moolenbroek * @param type IP address type, see @ref lwip_ip_addr_type definitions.
1175*5d5fbe79SDavid van Moolenbroek * If you want to listen to IPv4 and IPv6 (dual-stack) packets,
1176*5d5fbe79SDavid van Moolenbroek * supply @ref IPADDR_TYPE_ANY as argument and bind to @ref IP_ANY_TYPE.
1177*5d5fbe79SDavid van Moolenbroek * @return The UDP PCB which was created. NULL if the PCB data structure
1178*5d5fbe79SDavid van Moolenbroek * could not be allocated.
1179*5d5fbe79SDavid van Moolenbroek *
1180*5d5fbe79SDavid van Moolenbroek * @see udp_remove()
1181*5d5fbe79SDavid van Moolenbroek */
1182*5d5fbe79SDavid van Moolenbroek struct udp_pcb *
udp_new_ip_type(u8_t type)1183*5d5fbe79SDavid van Moolenbroek udp_new_ip_type(u8_t type)
1184*5d5fbe79SDavid van Moolenbroek {
1185*5d5fbe79SDavid van Moolenbroek struct udp_pcb *pcb;
1186*5d5fbe79SDavid van Moolenbroek pcb = udp_new();
1187*5d5fbe79SDavid van Moolenbroek #if LWIP_IPV4 && LWIP_IPV6
1188*5d5fbe79SDavid van Moolenbroek if (pcb != NULL) {
1189*5d5fbe79SDavid van Moolenbroek IP_SET_TYPE_VAL(pcb->local_ip, type);
1190*5d5fbe79SDavid van Moolenbroek IP_SET_TYPE_VAL(pcb->remote_ip, type);
1191*5d5fbe79SDavid van Moolenbroek }
1192*5d5fbe79SDavid van Moolenbroek #else
1193*5d5fbe79SDavid van Moolenbroek LWIP_UNUSED_ARG(type);
1194*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_IPV4 && LWIP_IPV6 */
1195*5d5fbe79SDavid van Moolenbroek return pcb;
1196*5d5fbe79SDavid van Moolenbroek }
1197*5d5fbe79SDavid van Moolenbroek
1198*5d5fbe79SDavid van Moolenbroek /** This function is called from netif.c when address is changed
1199*5d5fbe79SDavid van Moolenbroek *
1200*5d5fbe79SDavid van Moolenbroek * @param old_addr IP address of the netif before change
1201*5d5fbe79SDavid van Moolenbroek * @param new_addr IP address of the netif after change
1202*5d5fbe79SDavid van Moolenbroek */
udp_netif_ip_addr_changed(const ip_addr_t * old_addr,const ip_addr_t * new_addr)1203*5d5fbe79SDavid van Moolenbroek void udp_netif_ip_addr_changed(const ip_addr_t* old_addr, const ip_addr_t* new_addr)
1204*5d5fbe79SDavid van Moolenbroek {
1205*5d5fbe79SDavid van Moolenbroek struct udp_pcb* upcb;
1206*5d5fbe79SDavid van Moolenbroek
1207*5d5fbe79SDavid van Moolenbroek if (!ip_addr_isany(old_addr) && !ip_addr_isany(new_addr)) {
1208*5d5fbe79SDavid van Moolenbroek for (upcb = udp_pcbs; upcb != NULL; upcb = upcb->next) {
1209*5d5fbe79SDavid van Moolenbroek /* PCB bound to current local interface address? */
1210*5d5fbe79SDavid van Moolenbroek if (ip_addr_cmp(&upcb->local_ip, old_addr)) {
1211*5d5fbe79SDavid van Moolenbroek /* The PCB is bound to the old ipaddr and
1212*5d5fbe79SDavid van Moolenbroek * is set to bound to the new one instead */
1213*5d5fbe79SDavid van Moolenbroek ip_addr_copy(upcb->local_ip, *new_addr);
1214*5d5fbe79SDavid van Moolenbroek }
1215*5d5fbe79SDavid van Moolenbroek }
1216*5d5fbe79SDavid van Moolenbroek }
1217*5d5fbe79SDavid van Moolenbroek }
1218*5d5fbe79SDavid van Moolenbroek
1219*5d5fbe79SDavid van Moolenbroek #if UDP_DEBUG
1220*5d5fbe79SDavid van Moolenbroek /**
1221*5d5fbe79SDavid van Moolenbroek * Print UDP header information for debug purposes.
1222*5d5fbe79SDavid van Moolenbroek *
1223*5d5fbe79SDavid van Moolenbroek * @param udphdr pointer to the udp header in memory.
1224*5d5fbe79SDavid van Moolenbroek */
1225*5d5fbe79SDavid van Moolenbroek void
udp_debug_print(struct udp_hdr * udphdr)1226*5d5fbe79SDavid van Moolenbroek udp_debug_print(struct udp_hdr *udphdr)
1227*5d5fbe79SDavid van Moolenbroek {
1228*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("UDP header:\n"));
1229*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("+-------------------------------+\n"));
1230*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("| %5"U16_F" | %5"U16_F" | (src port, dest port)\n",
1231*5d5fbe79SDavid van Moolenbroek lwip_ntohs(udphdr->src), lwip_ntohs(udphdr->dest)));
1232*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("+-------------------------------+\n"));
1233*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("| %5"U16_F" | 0x%04"X16_F" | (len, chksum)\n",
1234*5d5fbe79SDavid van Moolenbroek lwip_ntohs(udphdr->len), lwip_ntohs(udphdr->chksum)));
1235*5d5fbe79SDavid van Moolenbroek LWIP_DEBUGF(UDP_DEBUG, ("+-------------------------------+\n"));
1236*5d5fbe79SDavid van Moolenbroek }
1237*5d5fbe79SDavid van Moolenbroek #endif /* UDP_DEBUG */
1238*5d5fbe79SDavid van Moolenbroek
1239*5d5fbe79SDavid van Moolenbroek #endif /* LWIP_UDP */
1240