4 * Implementation of raw protocol PCBs for low-level handling of
5 * different types of protocols besides (or overriding) those
6 * already available in lwIP.
10 * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
11 * All rights reserved.
13 * Redistribution and use in source and binary forms, with or without modification,
14 * are permitted provided that the following conditions are met:
16 * 1. Redistributions of source code must retain the above copyright notice,
17 * this list of conditions and the following disclaimer.
18 * 2. Redistributions in binary form must reproduce the above copyright notice,
19 * this list of conditions and the following disclaimer in the documentation
20 * and/or other materials provided with the distribution.
21 * 3. The name of the author may not be used to endorse or promote products
22 * derived from this software without specific prior written permission.
24 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
25 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
26 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
27 * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
28 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
29 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
30 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
31 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
32 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
35 * This file is part of the lwIP TCP/IP stack.
37 * Author: Adam Dunkels <adam@sics.se>
46 #include "lwip/memp.h"
47 #include "lwip/inet.h"
48 #include "lwip/ip_addr.h"
49 #include "lwip/netif.h"
52 #include "lwip/stats.h"
54 #include "arch/perf.h"
55 #include "lwip/snmp.h"
59 /** The list of RAW PCBs */
60 static struct raw_pcb
*raw_pcbs
= NULL
;
69 * Determine if in incoming IP packet is covered by a RAW PCB
70 * and if so, pass it to a user-provided receive callback function.
72 * Given an incoming IP datagram (as a chain of pbufs) this function
73 * finds a corresponding RAW PCB and calls the corresponding receive
76 * @param pbuf pbuf to be demultiplexed to a RAW PCB.
77 * @param netif network interface on which the datagram was received.
78 * @Return - 1 if the packet has been eaten by a RAW PCB receive
79 * callback function. The caller MAY NOT not reference the
80 * packet any longer, and MAY NOT call pbuf_free().
81 * @return - 0 if packet is not eaten (pbuf is still referenced by the
86 raw_input(struct pbuf
*p
, struct netif
*inp
)
94 proto
= IPH_PROTO(iphdr
);
97 /* loop through all raw pcbs until the packet is eaten by one */
98 /* this allows multiple pcbs to match against the packet by design */
99 while ((eaten
== 0) && (pcb
!= NULL
)) {
100 if (pcb
->protocol
== proto
) {
101 /* receive callback function available? */
102 if (pcb
->recv
!= NULL
) {
103 /* the receive callback function did not eat the packet? */
104 if (pcb
->recv(pcb
->recv_arg
, pcb
, p
, &(iphdr
->src
)) != 0)
106 /* receive function ate the packet */
111 /* no receive callback function was set for this raw PCB */
112 /* drop the packet */
122 * @param pcb RAW PCB to be bound with a local address ipaddr.
123 * @param ipaddr local IP address to bind with. Use IP_ADDR_ANY to
124 * bind to all local interfaces.
126 * @return lwIP error code.
127 * - ERR_OK. Successful. No error occured.
128 * - ERR_USE. The specified IP address is already bound to by
131 * @see raw_disconnect()
134 raw_bind(struct raw_pcb
*pcb
, struct ip_addr
*ipaddr
)
136 ip_addr_set(&pcb
->local_ip
, ipaddr
);
141 * Connect an RAW PCB. This function is required by upper layers
142 * of lwip. Using the raw api you could use raw_sendto() instead
144 * This will associate the RAW PCB with the remote address.
146 * @param pcb RAW PCB to be connected with remote address ipaddr and port.
147 * @param ipaddr remote IP address to connect with.
149 * @return lwIP error code
151 * @see raw_disconnect() and raw_sendto()
154 raw_connect(struct raw_pcb
*pcb
, struct ip_addr
*ipaddr
)
156 ip_addr_set(&pcb
->remote_ip
, ipaddr
);
162 * Set the callback function for received packets that match the
163 * raw PCB's protocol and binding.
165 * The callback function MUST either
166 * - eat the packet by calling pbuf_free() and returning non-zero. The
167 * packet will not be passed to other raw PCBs or other protocol layers.
168 * - not free the packet, and return zero. The packet will be matched
169 * against further PCBs and/or forwarded to another protocol layers.
171 * @return non-zero if the packet was free()d, zero if the packet remains
172 * available for others.
175 raw_recv(struct raw_pcb
*pcb
,
176 u8_t (* recv
)(void *arg
, struct raw_pcb
*upcb
, struct pbuf
*p
,
177 struct ip_addr
*addr
),
180 /* remember recv() callback and user data */
182 pcb
->recv_arg
= recv_arg
;
186 * Send the raw IP packet to the given address. Note that actually you cannot
187 * modify the IP headers (this is inconsistent with the receive callback where
188 * you actually get the IP headers), you can only specify the IP payload here.
189 * It requires some more changes in lwIP. (there will be a raw_send() function
192 * @param pcb the raw pcb which to send
193 * @param p the IP payload to send
194 * @param ipaddr the destination address of the IP packet
198 raw_sendto(struct raw_pcb
*pcb
, struct pbuf
*p
, struct ip_addr
*ipaddr
)
202 struct ip_addr
*src_ip
;
203 struct pbuf
*q
; /* q will be sent down the stack */
205 LWIP_DEBUGF(RAW_DEBUG
| DBG_TRACE
| 3, ("raw_sendto\n"));
207 /* not enough space to add an IP header to first pbuf in given p chain? */
208 if (pbuf_header(p
, IP_HLEN
)) {
209 /* allocate header in new pbuf */
210 q
= pbuf_alloc(PBUF_IP
, 0, PBUF_RAM
);
211 /* new header pbuf could not be allocated? */
213 LWIP_DEBUGF(RAW_DEBUG
| DBG_TRACE
| 2, ("raw_sendto: could not allocate header\n"));
216 /* chain header q in front of given pbuf p */
218 /* { first pbuf q points to header pbuf } */
219 LWIP_DEBUGF(RAW_DEBUG
, ("raw_sendto: added header pbuf %p before given pbuf %p\n", (void *)q
, (void *)p
));
221 /* first pbuf q equals given pbuf */
223 pbuf_header(q
, -IP_HLEN
);
226 if ((netif
= ip_route(ipaddr
)) == NULL
) {
227 LWIP_DEBUGF(RAW_DEBUG
| 1, ("raw_sendto: No route to 0x%"X32_F
"\n", ipaddr
->addr
));
229 /* ++lwip_stats.raw.rterr;*/
230 #endif /* RAW_STATS */
231 /* free any temporary header pbuf allocated by pbuf_header() */
238 if (ip_addr_isany(&pcb
->local_ip
)) {
239 /* use outgoing network interface IP address as source address */
240 src_ip
= &(netif
->ip_addr
);
242 /* use RAW PCB local IP address as source address */
243 src_ip
= &(pcb
->local_ip
);
246 err
= ip_output_if (q
, src_ip
, ipaddr
, pcb
->ttl
, pcb
->tos
, pcb
->protocol
, netif
);
248 /* did we chain a header earlier? */
250 /* free the header */
257 * Send the raw IP packet to the address given by raw_connect()
259 * @param pcb the raw pcb which to send
260 * @param p the IP payload to send
261 * @param ipaddr the destination address of the IP packet
265 raw_send(struct raw_pcb
*pcb
, struct pbuf
*p
)
267 return raw_sendto(pcb
, p
, &pcb
->remote_ip
);
273 * @param pcb RAW PCB to be removed. The PCB is removed from the list of
274 * RAW PCB's and the data structure is freed from memory.
279 raw_remove(struct raw_pcb
*pcb
)
281 struct raw_pcb
*pcb2
;
282 /* pcb to be removed is first in list? */
283 if (raw_pcbs
== pcb
) {
284 /* make list start at 2nd pcb */
285 raw_pcbs
= raw_pcbs
->next
;
286 /* pcb not 1st in list */
287 } else for(pcb2
= raw_pcbs
; pcb2
!= NULL
; pcb2
= pcb2
->next
) {
288 /* find pcb in raw_pcbs list */
289 if (pcb2
->next
!= NULL
&& pcb2
->next
== pcb
) {
290 /* remove pcb from list */
291 pcb2
->next
= pcb
->next
;
294 memp_free(MEMP_RAW_PCB
, pcb
);
300 * @return The RAW PCB which was created. NULL if the PCB data structure
301 * could not be allocated.
303 * @param proto the protocol number of the IPs payload (e.g. IP_PROTO_ICMP)
308 raw_new(u16_t proto
) {
311 LWIP_DEBUGF(RAW_DEBUG
| DBG_TRACE
| 3, ("raw_new\n"));
313 pcb
= memp_malloc(MEMP_RAW_PCB
);
314 /* could allocate RAW PCB? */
316 /* initialize PCB to all zeroes */
317 memset(pcb
, 0, sizeof(struct raw_pcb
));
318 pcb
->protocol
= proto
;
320 pcb
->next
= raw_pcbs
;
326 #endif /* LWIP_RAW */