1 /* 2 * This file is part of the openHiTLS project. 3 * 4 * openHiTLS is licensed under the Mulan PSL v2. 5 * You can use this software according to the terms and conditions of the Mulan PSL v2. 6 * You may obtain a copy of Mulan PSL v2 at: 7 * 8 * http://license.coscl.org.cn/MulanPSL2 9 * 10 * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, 11 * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, 12 * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE. 13 * See the Mulan PSL v2 for more details. 14 */ 15 16 #ifndef HS_REASS_H 17 #define HS_REASS_H 18 19 #include <stdint.h> 20 #include "tls.h" 21 #include "hs_msg.h" 22 23 #ifdef __cplusplus 24 extern "C" { 25 #endif 26 27 #ifdef HITLS_TLS_PROTO_DTLS12 28 29 /** 30 * @brief Create a message reassembly queue. 31 * 32 * @return Return the header of the linked list. If NULL is returned, memory application fails. 33 */ 34 HS_ReassQueue *HS_ReassNew(void); 35 36 /** 37 * @brief Release the reassembly message queue. 38 * 39 * @param reass [IN] Reassemble the message queue. 40 */ 41 void HS_ReassFree(HS_ReassQueue *reassQueue); 42 43 /** 44 * @brief Reassemble a fragmented handshake message. 45 * 46 * @param ctx [IN] TLS object 47 * @param msgInfo [IN] Message structure to be reassembled 48 * 49 * @retval HITLS_SUCCESS succeeded. 50 * @retval HITLS_REASS_INVALID_FRAGMENT An invalid fragment message is received. 51 * @retval HITLS_MEMALLOC_FAIL Memory application failed. 52 * @retval HITLS_MEMCPY_FAIL Memory Copy Failure 53 */ 54 int32_t HS_ReassAppend(TLS_Ctx *ctx, HS_MsgInfo *msgInfo); 55 56 /** 57 * @brief Read the complete message of the expected sequence number. 58 * 59 * @param ctx [IN] TLS object 60 * @param msgInfo [OUT] Message structure 61 * @param len [OUT] Message length 62 * 63 * @retval HITLS_SUCCESS succeeded. 64 * @retval HITLS_MEMCPY_FAIL Memory Copy Failure 65 */ 66 int32_t HS_GetReassMsg(TLS_Ctx *ctx, HS_MsgInfo *msgInfo, uint32_t *len); 67 68 #endif /* end #ifdef HITLS_TLS_PROTO_DTLS12 */ 69 70 #ifdef __cplusplus 71 } 72 #endif 73 74 #endif // HS_REASS_H 75