mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
8c3dc66ad8
The name `fragment_msg` or `frag_msg`/`msg_frag` always to me was a bit misplaced, as it basically implements an asynchronous fragmentation buffer and doesn't necessarily have anything to do with messages. This change 1. changes the name to `fb` (for fragmentation buffer) 2. factors its code out to its own sub-module so it can be re-used by other 6LoWPAN fragmentation schemes like [Selective Fragment Recovery] [Selective Fragment Recovery]: https://tools.ietf.org/html/draft-ietf-6lo-fragment-recovery-05
101 lines
3.1 KiB
C
101 lines
3.1 KiB
C
/*
|
|
* Copyright (C) 2015 Martine Lenders <mlenders@inf.fu-berlin.de>
|
|
* Copyright (C) 2015 Hamburg University of Applied Sciences
|
|
*
|
|
* This file is subject to the terms and conditions of the GNU Lesser
|
|
* General Public License v2.1. See the file LICENSE in the top level
|
|
* directory for more details.
|
|
*/
|
|
|
|
/**
|
|
* @defgroup net_gnrc_sixlowpan_frag 6LoWPAN Fragmentation
|
|
* @ingroup net_gnrc_sixlowpan
|
|
* @brief 6LoWPAN Fragmentation headers and functionality
|
|
* @see <a href="https://tools.ietf.org/html/rfc4944#section-5.3">
|
|
* RFC 4944, section 5.3
|
|
* </a>
|
|
* @{
|
|
*
|
|
* @file
|
|
* @brief 6LoWPAN Fragmentation definitions
|
|
*
|
|
* @author Martine Lenders <mlenders@inf.fu-berlin.de>
|
|
* @author Peter Kietzmann <peter.kietzmann@haw-hamburg.de>
|
|
*/
|
|
#ifndef NET_GNRC_SIXLOWPAN_FRAG_H
|
|
#define NET_GNRC_SIXLOWPAN_FRAG_H
|
|
|
|
#include <inttypes.h>
|
|
|
|
#include "byteorder.h"
|
|
#include "net/gnrc/pkt.h"
|
|
#include "net/gnrc/netif/hdr.h"
|
|
#ifdef MODULE_GNRC_SIXLOWPAN_FRAG_HINT
|
|
#include "net/gnrc/sixlowpan/frag/hint.h"
|
|
#endif /* MODULE_GNRC_SIXLOWPAN_FRAG_HINT */
|
|
#include "net/gnrc/sixlowpan/frag/fb.h"
|
|
#include "net/gnrc/sixlowpan/internal.h"
|
|
#include "net/ieee802154.h"
|
|
#include "net/sixlowpan.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#if defined(MODULE_GNRC_SIXLOWPAN_FRAG_STATS) || DOXYGEN
|
|
/**
|
|
* @brief Statistics on fragmentation and reassembly
|
|
*
|
|
* @note Only available with the `gnrc_sixlowpan_frag_stats` module
|
|
*/
|
|
typedef struct {
|
|
unsigned rbuf_full; /**< counts the number of events where the
|
|
* reassembly buffer is full */
|
|
unsigned frag_full; /**< counts the number of events that there where
|
|
* no @ref gnrc_sixlowpan_frag_fb_t available */
|
|
#if defined(MODULE_GNRC_SIXLOWPAN_FRAG_VRB) || DOXYGEN
|
|
unsigned vrb_full; /**< counts the number of events where the virtual
|
|
* reassembly buffer is full */
|
|
#endif
|
|
} gnrc_sixlowpan_frag_stats_t;
|
|
|
|
/**
|
|
* @brief Get the current statistics on fragmentation and reassembly
|
|
*
|
|
* @return The current statistics on fragmentation and reassembly
|
|
*/
|
|
gnrc_sixlowpan_frag_stats_t *gnrc_sixlowpan_frag_stats_get(void);
|
|
#endif
|
|
|
|
/**
|
|
* @brief Sends a packet fragmented
|
|
*
|
|
* @pre `ctx != NULL`
|
|
* @pre gnrc_sixlowpan_frag_fb_t::pkt of @p ctx is equal to @p pkt or
|
|
* `pkt == NULL`.
|
|
*
|
|
* @param[in] pkt A packet. May be NULL.
|
|
* @param[in] ctx A fragmentation buffer entry. Expected to be of type
|
|
* @ref gnrc_sixlowpan_frag_fb_t, with
|
|
* gnrc_sixlowpan_frag_fb_t set to @p pkt. Must not be
|
|
* NULL.
|
|
* @param[in] page Current 6Lo dispatch parsing page.
|
|
*/
|
|
void gnrc_sixlowpan_frag_send(gnrc_pktsnip_t *pkt, void *ctx, unsigned page);
|
|
|
|
/**
|
|
* @brief Handles a packet containing a fragment header
|
|
*
|
|
* @param[in] pkt The packet to handle
|
|
* @param[in] ctx Context for the packet. May be NULL.
|
|
* @param[in] page Current 6Lo dispatch parsing page.
|
|
*/
|
|
void gnrc_sixlowpan_frag_recv(gnrc_pktsnip_t *pkt, void *ctx, unsigned page);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* NET_GNRC_SIXLOWPAN_FRAG_H */
|
|
/** @} */
|