d_tcp_defines.h

Go to the documentation of this file.

/*
 * Copyright 2012,2013,2014 Didier Barvaux
 * Copyright 2013,2014 Viveris Technologies
 * Copyright 2012 WBX
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

/**
 * @file   d_tcp_defines.h
 * @brief  Main definitions for the TCP decompression profile
 * @author FWX <rohc_team@dialine.fr>
 * @author Didier Barvaux <didier@barvaux.org>
 * @author Didier Barvaux <didier.barvaux@toulouse.viveris.com>
 */

#ifndef ROHC_DECOMP_TCP_DEFINES_H
#define ROHC_DECOMP_TCP_DEFINES_H

#include "ip.h"
#include "interval.h"
#include "protocols/ip.h"
#include "protocols/tcp.h"
#include "protocols/rfc6846.h"
#include "schemes/ip_ctxt.h"
#include "schemes/decomp_wlsb.h"
#include "schemes/tcp_ts.h"
#include "schemes/tcp_sack.h"

#include <stdint.h>


/** The decompression context for one TCP option */
struct d_tcp_opt_ctxt /* TODO: doxygen */
{
        bool used;
        uint8_t type;
        union
        {
                struct
                {
                        bool is_static;
                        uint8_t len;
                } eol;
                struct
                {
                        bool is_static;
                        uint16_t value;
                } mss;
                struct
                {
                        bool is_static;
                        uint8_t value;
                } ws;
                struct
                {
                        struct rohc_lsb_field32 req;  /**< The context for the TS request field */
                        struct rohc_lsb_field32 rep;  /**< The context for the TS reply field */
                } ts;
                struct d_tcp_opt_sack sack; /* TODO: ptr inside is not needed */
                struct
                {
                        enum
                        {
                                TCP_GENERIC_OPT_STATIC,
                                TCP_GENERIC_OPT_STABLE,
                                TCP_GENERIC_OPT_FULL,
                        } type;
                        uint8_t load_len;
#define ROHC_TCP_OPT_HDR_LEN 2U
#define ROHC_TCP_OPT_MAX_LEN 0xffU
#define ROHC_TCP_OPT_GENERIC_DATA_MAX_LEN \
        (ROHC_TCP_OPT_MAX_LEN - ROHC_TCP_OPT_HDR_LEN)
                        uint8_t load[ROHC_TCP_OPT_GENERIC_DATA_MAX_LEN];
                } generic;
        } data;
};


/** The decompression context for TCP options */
struct d_tcp_opts_ctxt
{
        /** The number of options in the list of TCP options */
        size_t nr;

        /** The structure of the list of TCP options */
        uint8_t structure[ROHC_TCP_OPTS_MAX];
        /** Whether the TCP options are expected in the dynamic part? */
        bool expected_dynamic[ROHC_TCP_OPTS_MAX];
        /** The TCP options that were found or not */
        bool found[ROHC_TCP_OPTS_MAX];

        /** The bits of TCP options extracted from the dynamic chain, the tail of
         * co_common/seq_8/rnd_8 packets, or the irregular chain */
        struct d_tcp_opt_ctxt bits[MAX_TCP_OPTION_INDEX + 1];
};


/** Define the TCP part of the decompression profile context */
struct d_tcp_context
{
        /** The LSB decoding context of MSN */
        struct rohc_lsb_decode msn_lsb_ctxt;

        /** The LSB decoding context of innermost IP-ID */
        struct rohc_lsb_decode ip_id_lsb_ctxt;
        /** The LSB decoding context of innermost TTL/HL */
        struct rohc_lsb_decode ttl_hl_lsb_ctxt;

        /* TCP static part */
        uint16_t tcp_src_port; /**< The TCP source port */
        uint16_t tcp_dst_port; /**< The TCP dest port */

        uint32_t seq_num_residue;
        struct rohc_lsb_decode seq_lsb_ctxt;
        struct rohc_lsb_decode seq_scaled_lsb_ctxt;

        uint16_t ack_stride;
        uint16_t ack_num_residue;
        struct rohc_lsb_decode ack_lsb_ctxt;
        struct rohc_lsb_decode ack_scaled_lsb_ctxt;

        /* TCP flags */
        uint8_t res_flags:4;  /**< The TCP reserved flags */
        bool ecn_used;        /**< Whether ECN flag is used */
        uint8_t ecn_flags:2;  /**< The TCP ECN flags */
        bool urg_flag;        /**< The TCP URG flag */
        bool ack_flag;        /**< The TCP ACK flag */
        uint8_t rsf_flags:3;  /**< The TCP RSF flag */

        /** The LSB decoding context of TCP window */
        struct rohc_lsb_decode window_lsb_ctxt;

        /** The URG pointer */
        uint16_t urg_ptr;

        /** The decoded values of TCP options */
        struct d_tcp_opts_ctxt tcp_opts;
        /* TCP TS option */
        struct rohc_lsb_decode opt_ts_req_lsb_ctxt;
        struct rohc_lsb_decode opt_ts_rep_lsb_ctxt;
        /* TCP SACK option */
        struct d_tcp_opt_sack opt_sack_blocks;  /**< The TCP SACK blocks */

        size_t ip_contexts_nr;
        ip_context_t ip_contexts[ROHC_MAX_IP_HDRS];
};


/** The outer or inner IP bits extracted from ROHC headers */
struct rohc_tcp_extr_ip_bits
{
        uint8_t version:4;  /**< The version bits found in static chain of IR header */

        uint8_t dscp_bits:6;         /**< The IP DSCP bits */
        size_t dscp_bits_nr;         /**< The number of IP DSCP bits */
        uint8_t ecn_flags_bits:2;    /**< The IP ECN flag bits */
        size_t ecn_flags_bits_nr;    /**< The number of IP ECN flag bits */

        uint8_t id_behavior:2;       /**< The IP-ID behavior bits */
        size_t id_behavior_nr;       /**< The number of IP-ID behavior bits */
        struct rohc_lsb_field16 id;  /**< The IP-ID bits */

        uint8_t df:1;    /**< The DF bits found in dynamic chain of IR/IR-DYN
                              header or in extension header */
        size_t df_nr;    /**< The number of DF bits found */

        struct rohc_lsb_field8 ttl_hl;  /**< The IP TTL/HL bits */
        uint8_t proto;   /**< The protocol/next header bits found static chain
                              of IR header or in extension header */
        size_t proto_nr; /**< The number of protocol/next header bits */

        uint32_t flowid:20;  /**< The IPv6 flow ID bits found in static chain of
                                  IR header */
        size_t flowid_nr;    /**< The number of flow label bits */

        uint8_t saddr[16];   /**< The source address bits found in static chain of
                                  IR header */
        size_t saddr_nr;     /**< The number of source address bits */

        uint8_t daddr[16];   /**< The destination address bits found in static
                                  chain of IR header */
        size_t daddr_nr;     /**< The number of source address bits */

        /** The parsed IP extension headers */
        ip_option_context_t opts[ROHC_MAX_IP_EXT_HDRS];
        size_t opts_nr;  /**< The number of parsed IP extension headers */
        size_t opts_len; /**< The length of the parsed IP extension headers */
};


/** The bits extracted from ROHC TCP header */
struct rohc_tcp_extr_bits
{
        /** Whether Context Replication (CR) is used */
        bool do_ctxt_replication;
        /** The base context for Context Replication (CR) */
        rohc_cid_t cr_base_cid;

        /** The extracted bits related to the IP headers */
        struct rohc_tcp_extr_ip_bits ip[ROHC_MAX_IP_HDRS];
        size_t ip_nr;   /**< The number of parsed IP headers */

        /** The extracted bits of the Master Sequence Number (MSN) of the packet */
        struct rohc_lsb_field16 msn;

        /** Whether TTL/HL of outer IP headers is included in the dynamic chain */
        bool ttl_dyn_chain_flag;
        /** Whether TTL/HL of outer IP headers is included in the irregular chain */
        bool ttl_irreg_chain_flag;

        /* TCP header */
        uint16_t src_port;    /**< The TCP source port bits found in static chain */
        size_t src_port_nr;   /**< The number of TCP source port bits */
        uint16_t dst_port;    /**< The TCP destination port bits in static chain */
        size_t dst_port_nr;   /**< The number of TCP destination port bits */
        struct rohc_lsb_field32 seq;         /**< The TCP sequence number bits */
        struct rohc_lsb_field32 seq_scaled;  /**< The TCP scaled sequence number bits */
        struct rohc_lsb_field32 ack;         /**< The TCP acknowledgment number bits */
        struct rohc_lsb_field16 ack_stride;  /**< The TCP ACK stride bits */
        struct rohc_lsb_field32 ack_scaled;  /**< The TCP scaled ACK number bits */
        uint8_t ecn_used_bits;               /**< The TCP ECN used flag bits */
        size_t ecn_used_bits_nr;             /**< The number of ECN used flag bits */
        uint8_t res_flags_bits;              /**< The TCP reserved flag bits */
        size_t res_flags_bits_nr;            /**< The number of TCP reserved flag bits */
        uint8_t ecn_flags_bits;              /**< The TCP ECN flag bits */
        size_t ecn_flags_bits_nr;            /**< The number of TCP ECN flag bits */
        uint8_t urg_flag_bits;               /**< The TCP URG flag bits */
        size_t urg_flag_bits_nr;             /**< The number of TCP URG flag bits */
        uint8_t ack_flag_bits;               /**< The TCP ACK flag bits */
        size_t ack_flag_bits_nr;             /**< The number of TCP ACK flag bits */
        uint8_t psh_flag_bits;               /**< The TCP PSH flag bits */
        size_t psh_flag_bits_nr;             /**< The number of TCP PSG flag bits */
        uint8_t rsf_flags_bits;              /**< The TCP RSF flag bits */
        size_t rsf_flags_bits_nr;            /**< The number of TCP RSF flag bits */
        struct rohc_lsb_field16 window;      /**< The TCP window bits */
        uint16_t tcp_check;   /**< The TCP checksum bits found in dynamic chain of
                                   IR/IR-DYN header or in irregular chain of CO header */
        struct rohc_lsb_field16 urg_ptr;     /**< The TCP Urgent pointer bits */

        /** The bits of TCP options extracted from the dynamic chain, the tail of
         * co_common/seq_8/rnd_8 packets, or the irregular chain */
        struct d_tcp_opts_ctxt tcp_opts;
};


/** The IP values decoded from the extracted ROHC bits */
struct rohc_tcp_decoded_ip_values
{
        uint8_t version:4;   /**< The decoded version field */
        uint8_t ecn_flags:2; /**< The decoded ECN flags */
        uint8_t dscp:6;      /**< The decoded DSCP field */
        rohc_ip_id_behavior_t id_behavior; /**< The decoded IP-ID behavior (IPv4 only) */
        uint16_t id;         /**< The decoded IP-ID field (IPv4 only) */
        uint8_t df:1;        /**< The decoded DF field (IPv4 only) */
        uint8_t ttl;         /**< The decoded TTL/HL field */
        uint8_t proto;       /**< The decoded protocol/NH field */
        uint8_t nbo:1;       /**< The decoded NBO field (IPv4 only) */
        uint8_t rnd:1;       /**< The decoded RND field (IPv4 only) */
        uint32_t flowid:20;  /**< The decoded flow ID field (IPv6 only) */
        uint8_t saddr[16];   /**< The decoded source address field */
        uint8_t daddr[16];   /**< The decoded destination address field */

        /** The decoded IP extension headers */
        ip_option_context_t opts[ROHC_MAX_IP_EXT_HDRS];
        size_t opts_nr;  /**< The number of decoded IP extension headers */
        size_t opts_len; /**< The length of the decoded IP extension headers */
};


/** The values decoded from the bits extracted from ROHC TCP header */
struct rohc_tcp_decoded_values
{
        /** Whether Context Replication (CR) is used */
        bool do_ctxt_replication;
        /** The base context for Context Replication (CR) */
        rohc_cid_t cr_base_cid;

        /** The decoded values related to the IP headers */
        struct rohc_tcp_decoded_ip_values ip[ROHC_MAX_IP_HDRS];
        size_t ip_nr;  /**< The number of the decoded IP headers */

        /** The Master Sequence Number (MSN) of the packet */
        uint16_t msn;

        /** Whether TTL/HL of outer IP headers is included in the dynamic chain */
        bool ttl_dyn_chain_flag;
        /** Whether TTL/HL of outer IP headers is included in the irregular chain */
        bool ttl_irreg_chain_flag;

        /* TCP source & destination ports */
        uint16_t src_port;        /**< The TCP source port */
        uint16_t dst_port;        /**< The TCP destination port */

        /* TCP sequence & acknowledgment numbers */
        uint32_t seq_num;          /**< The TCP sequence number */
        uint32_t seq_num_scaled;   /**< The scaled TCP sequence number */
        uint32_t seq_num_residue;  /**< The residue of the scaled TCP sequence number */
        uint32_t ack_num;          /**< The TCP acknowledgment number */
        uint32_t ack_num_scaled;   /**< The scaled TCP acknowledgment number */
        uint16_t ack_num_residue;  /**< The residue of the scaled TCP ACK number */
        uint16_t ack_stride;       /**< The ACK stride */

        /* TCP flags */
        bool ecn_used;        /**< Whether the TCP ECN flags are used */
        uint8_t res_flags:4;  /**< The TCP reserved flags */
        uint8_t ecn_flags:2;  /**< The TCP ECN flags */
        bool urg_flag;        /**< The TCP URG flag */
        bool ack_flag;        /**< The TCP ACK flag */
        bool psh_flag;        /**< The TCP PSH flag */
        uint8_t rsf_flags:3;  /**< The TCP RSF flags */

        /* TCP window, checksum and Urgent pointer */
        uint16_t window;     /**< The TCP window */
        uint16_t tcp_check;  /**< The TCP checksum */
        uint16_t urg_ptr;    /**< The TCP Urgent pointer */

        /** The decoded values of TCP options */
        struct d_tcp_opts_ctxt tcp_opts;
        /* TCP TS option */
        uint32_t opt_ts_req;  /**< The echo request value of the TCP TS option */
        uint32_t opt_ts_rep;  /**< The echo reply value of the TCP TS option */
        /* TCP SACK option */
        struct d_tcp_opt_sack opt_sack_blocks;  /**< The TCP SACK blocks */
};

#endif /* ROHC_DECOMP_TCP_DEFINES_H */