ipv4_frag.h File Reference

IPv4 fragmentation and reassembly. More...

#include "core/net.h"
#include "ipv4/ipv4.h"

Go to the source code of this file.

Data Structures

struct  Ipv4ReassemblyBuffer
 Reassembly buffer. More...
 
struct  Ipv4FragDesc
 Fragmented packet descriptor. More...
 

Macros

#define IPV4_FRAG_SUPPORT   ENABLED
 
#define IPV4_FRAG_TICK_INTERVAL   1000
 
#define IPV4_MAX_FRAG_DATAGRAMS   4
 
#define IPV4_MAX_FRAG_DATAGRAM_SIZE   8192
 
#define IPV4_FRAG_TIME_TO_LIVE   15000
 
#define IPV4_INFINITY   0xFFFF
 

Typedefs

struct {
   uint16_t   first
 
   uint16_t   last
 
   uint16_t   next
 
Ipv4HoleDesc
 Hole descriptor. More...
 

Functions

error_t ipv4FragmentDatagram (NetInterface *interface, Ipv4PseudoHeader *pseudoHeader, uint16_t id, const NetBuffer *payload, size_t payloadOffset, uint8_t timeToLive)
 Fragment an IPv4 datagram into smaller packets. More...
 
void ipv4ReassembleDatagram (NetInterface *interface, const Ipv4Header *packet, size_t length)
 IPv4 datagram reassembly algorithm. More...
 
void ipv4FragTick (NetInterface *interface)
 Fragment reassembly timeout handler. More...
 
Ipv4FragDescipv4SearchFragQueue (NetInterface *interface, const Ipv4Header *packet)
 Search for a matching datagram in the reassembly queue. More...
 
void ipv4FlushFragQueue (NetInterface *interface)
 Flush IPv4 reassembly queue. More...
 
Ipv4HoleDescipv4FindHole (Ipv4FragDesc *frag, uint16_t offset)
 Retrieve hole descriptor. More...
 
void ipv4DumpHoleList (Ipv4FragDesc *frag)
 Dump hole descriptor list. More...
 

Variables

systime_t ipv4FragTickCounter
 

Detailed Description

IPv4 fragmentation and reassembly.

License

Copyright (C) 2010-2018 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneTCP Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author
Oryx Embedded SARL (www.oryx-embedded.com)
Version
1.9.0

Definition in file ipv4_frag.h.

Macro Definition Documentation

◆ IPV4_FRAG_SUPPORT

#define IPV4_FRAG_SUPPORT   ENABLED

Definition at line 38 of file ipv4_frag.h.

◆ IPV4_FRAG_TICK_INTERVAL

#define IPV4_FRAG_TICK_INTERVAL   1000

Definition at line 45 of file ipv4_frag.h.

◆ IPV4_FRAG_TIME_TO_LIVE

#define IPV4_FRAG_TIME_TO_LIVE   15000

Definition at line 67 of file ipv4_frag.h.

◆ IPV4_INFINITY

#define IPV4_INFINITY   0xFFFF

Definition at line 73 of file ipv4_frag.h.

◆ IPV4_MAX_FRAG_DATAGRAM_SIZE

#define IPV4_MAX_FRAG_DATAGRAM_SIZE   8192

Definition at line 60 of file ipv4_frag.h.

◆ IPV4_MAX_FRAG_DATAGRAMS

#define IPV4_MAX_FRAG_DATAGRAMS   4

Definition at line 53 of file ipv4_frag.h.

Typedef Documentation

◆ Ipv4HoleDesc

typedef { ... } Ipv4HoleDesc

Hole descriptor.

Function Documentation

◆ ipv4DumpHoleList()

void ipv4DumpHoleList ( Ipv4FragDesc frag)

Dump hole descriptor list.

Parameters
[in]fragIPv4 fragment descriptor

Definition at line 649 of file ipv4_frag.c.

◆ ipv4FindHole()

Ipv4HoleDesc* ipv4FindHole ( Ipv4FragDesc frag,
uint16_t  offset 
)

Retrieve hole descriptor.

Parameters
[in]fragIPv4 fragment descriptor
[in]offsetOffset of the hole
Returns
A pointer to the hole descriptor is returned if the specified offset is valid. Otherwise NULL is returned

Definition at line 637 of file ipv4_frag.c.

◆ ipv4FlushFragQueue()

void ipv4FlushFragQueue ( NetInterface interface)

Flush IPv4 reassembly queue.

Parameters
[in]interfaceUnderlying network interface

Definition at line 616 of file ipv4_frag.c.

◆ ipv4FragmentDatagram()

error_t ipv4FragmentDatagram ( NetInterface interface,
Ipv4PseudoHeader pseudoHeader,
uint16_t  id,
const NetBuffer payload,
size_t  payloadOffset,
uint8_t  timeToLive 
)

Fragment an IPv4 datagram into smaller packets.

Parameters
[in]interfaceUnderlying network interface
[in]pseudoHeaderIPv4 pseudo header
[in]idFragment identification
[in]payloadMulti-part buffer containing the payload
[in]payloadOffsetOffset to the first payload byte
[in]timeToLiveTTL value
Returns
Error code

Definition at line 69 of file ipv4_frag.c.

◆ ipv4FragTick()

void ipv4FragTick ( NetInterface interface)

Fragment reassembly timeout handler.

This routine must be periodically called by the TCP/IP stack to handle IPv4 fragment reassembly timeout

Parameters
[in]interfaceUnderlying network interface

Definition at line 446 of file ipv4_frag.c.

◆ ipv4ReassembleDatagram()

void ipv4ReassembleDatagram ( NetInterface interface,
const Ipv4Header packet,
size_t  length 
)

IPv4 datagram reassembly algorithm.

Parameters
[in]interfaceUnderlying network interface
[in]packetPointer to the IPv4 fragmented packet
[in]lengthPacket length including header and payload

Definition at line 176 of file ipv4_frag.c.

◆ ipv4SearchFragQueue()

Ipv4FragDesc* ipv4SearchFragQueue ( NetInterface interface,
const Ipv4Header packet 
)

Search for a matching datagram in the reassembly queue.

Parameters
[in]interfaceUnderlying network interface
[in]packetIncoming IPv4 packet
Returns
Matching fragment descriptor

Definition at line 514 of file ipv4_frag.c.

Variable Documentation

◆ first

uint16_t first

Definition at line 93 of file ipv4_frag.h.

◆ ipv4FragTickCounter

systime_t ipv4FragTickCounter

Definition at line 55 of file ipv4_frag.c.

◆ last

uint16_t last

Definition at line 94 of file ipv4_frag.h.

◆ next

uint16_t next

Definition at line 95 of file ipv4_frag.h.