2 * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
5 * Redistribution and use in source and binary forms, with or without modification,
6 * are permitted provided that the following conditions are met:
8 * 1. Redistributions of source code must retain the above copyright notice,
9 * this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright notice,
11 * this list of conditions and the following disclaimer in the documentation
12 * and/or other materials provided with the distribution.
13 * 3. The name of the author may not be used to endorse or promote products
14 * derived from this software without specific prior written permission.
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
18 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
19 * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
20 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
21 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
24 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
27 * This file is part of the lwIP TCP/IP stack.
29 * Author: Adam Dunkels <adam@sics.se>
32 #ifndef __LWIP_UDP_H__
33 #define __LWIP_UDP_H__
37 #if LWIP_UDP /* don't build if not configured for use in lwipopts.h */
39 #include "lwip/pbuf.h"
40 #include "lwip/netif.h"
41 #include "lwip/ip_addr.h"
50 /* Fields are (of course) in network byte order. */
51 #ifdef PACK_STRUCT_USE_INCLUDES
52 # include "arch/bpstruct.h"
55 #if (defined(__MWERKS__) || defined(__CWCC__))
56 #pragma options align= packed
59 PACK_STRUCT_FIELD(u16_t src
);
60 PACK_STRUCT_FIELD(u16_t dest
); /* src/dest UDP ports */
61 PACK_STRUCT_FIELD(u16_t len
);
62 PACK_STRUCT_FIELD(u16_t chksum
);
65 #ifdef PACK_STRUCT_USE_INCLUDES
66 # include "arch/epstruct.h"
69 #define UDP_FLAGS_NOCHKSUM 0x01U
70 #define UDP_FLAGS_UDPLITE 0x02U
71 #define UDP_FLAGS_CONNECTED 0x04U
74 /* Common members of all PCB types */
77 /* Protocol specific PCB members */
82 /* ports are in host byte order */
83 u16_t local_port
, remote_port
;
86 /* outgoing network interface for multicast packets */
87 struct ip_addr multicast_ip
;
88 #endif /* LWIP_IGMP */
91 /* used for UDP_LITE only */
92 u16_t chksum_len_rx
, chksum_len_tx
;
93 #endif /* LWIP_UDPLITE */
95 /* receive callback function
96 * addr and port are in same byte order as in the pcb
97 * The callback is responsible for freeing the pbuf
98 * if it's not used any more.
100 * @param arg user supplied argument (udp_pcb.recv_arg)
101 * @param pcb the udp_pcb which received data
102 * @param p the packet buffer that was received
103 * @param addr the remote IP address from which the packet was received
104 * @param port the remote port from which the packet was received
106 void (* recv
)(void *arg
, struct udp_pcb
*pcb
, struct pbuf
*p
,
107 struct ip_addr
*addr
, u16_t port
);
108 /* user-supplied argument for the recv callback */
111 /* udp_pcbs export for exernal reference (e.g. SNMP agent) */
112 extern struct udp_pcb
*udp_pcbs
;
114 /* The following functions is the application layer interface to the
116 struct udp_pcb
* udp_new (void);
117 void udp_remove (struct udp_pcb
*pcb
);
118 err_t
udp_bind (struct udp_pcb
*pcb
, struct ip_addr
*ipaddr
,
120 err_t
udp_connect (struct udp_pcb
*pcb
, struct ip_addr
*ipaddr
,
122 void udp_disconnect (struct udp_pcb
*pcb
);
123 void udp_recv (struct udp_pcb
*pcb
,
124 void (* recv
)(void *arg
, struct udp_pcb
*upcb
,
126 struct ip_addr
*addr
,
129 err_t
udp_sendto_if (struct udp_pcb
*pcb
, struct pbuf
*p
, struct ip_addr
*dst_ip
, u16_t dst_port
, struct netif
*netif
);
130 err_t
udp_sendto (struct udp_pcb
*pcb
, struct pbuf
*p
, struct ip_addr
*dst_ip
, u16_t dst_port
);
131 err_t
udp_send (struct udp_pcb
*pcb
, struct pbuf
*p
);
133 #define udp_flags(pcb) ((pcb)->flags)
134 #define udp_setflags(pcb, f) ((pcb)->flags = (f))
136 /* The following functions are the lower layer interface to UDP. */
137 void udp_input (struct pbuf
*p
, struct netif
*inp
);
139 #define udp_init() /* Compatibility define, not init needed. */
142 void udp_debug_print(struct udp_hdr
*udphdr
);
144 #define udp_debug_print(udphdr)
151 #endif /* LWIP_UDP */
153 #endif /* __LWIP_UDP_H__ */