QSMP: Quantum Secure Messaging Protocol 1.3.0.0a (A3)
A quantum secure encrypted tunneling protocol
connections.h
Go to the documentation of this file.
1/* 2025 Quantum Resistant Cryptographic Solutions Corporation
2 * All Rights Reserved.
3 *
4 * NOTICE: This software and all accompanying materials are the exclusive
5 * property of Quantum Resistant Cryptographic Solutions Corporation (QRCS).
6 * The intellectual and technical concepts contained within this implementation
7 * are proprietary to QRCS and its authorized licensors and are protected under
8 * applicable U.S. and international copyright, patent, and trade secret laws.
9 *
10 * CRYPTOGRAPHIC STANDARDS:
11 * - This software includes implementations of cryptographic algorithms such as
12 * SHA3, AES, and others. These algorithms are public domain or standardized
13 * by organizations such as NIST and are NOT the property of QRCS.
14 * - However, all source code, optimizations, and implementations in this library
15 * are original works of QRCS and are protected under this license.
16 *
17 * RESTRICTIONS:
18 * - Redistribution, modification, or unauthorized distribution of this software,
19 * in whole or in part, is strictly prohibited.
20 * - This software is provided for non-commercial, educational, and research
21 * purposes only. Commercial use in any form is expressly forbidden.
22 * - Licensing and authorized distribution are solely at the discretion of QRCS.
23 * - Any use of this software implies acceptance of these restrictions.
24 *
25 * DISCLAIMER:
26 * This software is provided "as is," without warranty of any kind, express or
27 * implied, including but not limited to warranties of merchantability or fitness
28 * for a particular purpose. QRCS disclaims all liability for any direct, indirect,
29 * incidental, or consequential damages resulting from the use or misuse of this software.
30 *
31 * FULL LICENSE:
32 * This software is subject to the **Quantum Resistant Cryptographic Solutions
33 * Proprietary License (QRCS-PL)**. The complete license terms are included
34 * in the LICENSE.txt file distributed with this software.
35 *
36 * Written by: John G. Underhill
37 * Contact: john.underhill@protonmail.com
38 */
39
40#ifndef QSMP_CONNECTIONS_H
41#define QSMP_CONNECTIONS_H
42
43#include "common.h"
44#include "qsmp.h"
45
66
78bool qsmp_connections_active(size_t index);
79
90qsmp_connection_state* qsmp_connections_add(void);
91
101size_t qsmp_connections_available(void);
102
114qsmp_connection_state* qsmp_connections_get(uint32_t instance);
115
127void qsmp_connections_initialize(size_t count, size_t maximum);
128
136void qsmp_connections_clear(void);
137
145void qsmp_connections_dispose(void);
146
158qsmp_connection_state* qsmp_connections_index(size_t index);
159
169bool qsmp_connections_full(void);
170
180qsmp_connection_state* qsmp_connections_next(void);
181
191void qsmp_connections_reset(uint32_t instance);
192
202size_t qsmp_connections_size(void);
203
219void qsmp_connections_self_test(void);
220
221
222#endif
qsmp_connections_clear
void qsmp_connections_clear(void)
Clear all connection states in the collection.
Definition connections.c:72
qsmp_connections_dispose
void qsmp_connections_dispose(void)
Dispose of the QSMP connections collection.
Definition connections.c:83
qsmp_connections_add
qsmp_connection_state * qsmp_connections_add(void)
Add a new connection state to the collection and mark it as active.
Definition connections.c:31
qsmp_connections_reset
void qsmp_connections_reset(uint32_t instance)
Reset a specific connection state in the collection.
Definition connections.c:207
qsmp_connections_full
bool qsmp_connections_full(void)
Check if the connections collection is full.
Definition connections.c:120
qsmp_connections_active
bool qsmp_connections_active(size_t index)
Determine if a connection state at the specified index is active.
Definition connections.c:17
qsmp_connections_available
size_t qsmp_connections_available(void)
Get the number of available (inactive) connection states in the collection.
Definition connections.c:55
qsmp_connections_initialize
void qsmp_connections_initialize(size_t count, size_t maximum)
Initialize the QSMP connections collection.
Definition connections.c:155
qsmp_connections_next
qsmp_connection_state * qsmp_connections_next(void)
Retrieve the next available (inactive) connection state from the collection.
Definition connections.c:181
qsmp_connections_self_test
void qsmp_connections_self_test(void)
Run the self-test routine for the connections collection.
Definition connections.c:226
qsmp_connections_get
qsmp_connection_state * qsmp_connections_get(uint32_t instance)
Retrieve a connection state by its unique instance number.
Definition connections.c:138
qsmp_connections_size
size_t qsmp_connections_size(void)
Get the total number of connection state items in the collection.
Definition connections.c:221
qsmp_connections_index
qsmp_connection_state * qsmp_connections_index(size_t index)
Retrieve a connection state pointer by its collection index.
Definition connections.c:106
qsmp.h
QSMP support header Common defined parameters and functions of the qsmp client and server implementat...
qsmp_connection_state
The QSMP socket connection state structure.
Definition qsmp.h:1002