socketflags.h

Go to the documentation of this file.

/* 2020-2026 Quantum Resistant Cryptographic Solutions Corporation
 * All Rights Reserved.
 *
 * NOTICE:
 * This software and all accompanying materials are the exclusive property of
 * Quantum Resistant Cryptographic Solutions Corporation (QRCS). The intellectual
 * and technical concepts contained herein are proprietary to QRCS and are
 * protected under applicable Canadian, U.S., and international copyright,
 * patent, and trade secret laws.
 *
 * CRYPTOGRAPHIC ALGORITHMS AND IMPLEMENTATIONS:
 * - This software includes implementations of cryptographic primitives and
 *   algorithms that are standardized or in the public domain, such as AES
 *   and SHA-3, which are not proprietary to QRCS.
 * - This software also includes cryptographic primitives, constructions, and
 *   algorithms designed by QRCS, including but not limited to RCS, SCB, CSX, QMAC, and
 *   related components, which are proprietary to QRCS.
 * - All source code, implementations, protocol compositions, optimizations,
 *   parameter selections, and engineering work contained in this software are
 *   original works of QRCS and are protected under this license.
 *
 * LICENSE AND USE RESTRICTIONS:
 * - This software is licensed under the Quantum Resistant Cryptographic Solutions
 *   Public Research and Evaluation License (QRCS-PREL), 2025-2026.
 * - Permission is granted solely for non-commercial evaluation, academic research,
 *   cryptographic analysis, interoperability testing, and feasibility assessment.
 * - Commercial use, production deployment, commercial redistribution, or
 *   integration into products or services is strictly prohibited without a
 *   separate written license agreement executed with QRCS.
 * - Licensing and authorized distribution are solely at the discretion of QRCS.
 *
 * EXPERIMENTAL CRYPTOGRAPHY NOTICE:
 * Portions of this software may include experimental, novel, or evolving
 * cryptographic designs. Use of this software is entirely at the user's risk.
 *
 * DISCLAIMER:
 * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS
 * FOR A PARTICULAR PURPOSE, SECURITY, OR NON-INFRINGEMENT. QRCS DISCLAIMS ALL
 * LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
 * ARISING FROM THE USE OR MISUSE OF THIS SOFTWARE.
 *
 * FULL LICENSE:
 * This software is subject to the Quantum Resistant Cryptographic Solutions
 * Public Research and Evaluation License (QRCS-PREL), 2025-2026. The complete license terms
 * are provided in the accompanying LICENSE file or at https://www.qrcscorp.ca.
 *
 * Written by: John G. Underhill
 * Contact: contact@qrcscorp.ca
 */
 
#ifndef QSC_SOCKFLAGS_H
#define QSC_SOCKFLAGS_H
 
#include "qsccommon.h"
 
QSC_CPLUSPLUS_ENABLED_START


typedef enum
{
    qsc_ipv6_prefix_none = 0x00U,                       
    qsc_ipv6_prefix_link_local = 0x01U,                   
    qsc_ipv6_prefix_multicast = 0x02U,                 
    qsc_ipv6_prefix_global = 0x03U,                       
    qsc_ipv6_prefix_unique_local = 0x04U                
} qsc_ipv6_address_prefix_types;

typedef enum
{
    qsc_socket_address_family_none = 0x00000000L,     
    qsc_socket_address_family_unix = 0x00000001L,     
    qsc_socket_address_family_ipv4 = 0x00000002L,     
#if defined(QSC_SYSTEM_OS_WINDOWS)
    qsc_socket_address_family_ipv6 = 23,              
#elif defined(QSC_SYSTEM_OS_LINUX)
    qsc_socket_address_family_ipv6 = 10,              
#elif defined(QSC_SYSTEM_OS_MAC)
    qsc_socket_address_family_ipv6 = 30,              
#elif defined(QSC_SYSTEM_OS_FREEBSD)
    qsc_socket_address_family_ipv6 = 28,              
#else   /* OpenBSD, NetBSD, and other POSIX */
    qsc_socket_address_family_ipv6 = 24,              
#endif
} qsc_socket_address_families;

typedef enum
{
    qsc_socket_state_none = 0x00U,                     
    qsc_socket_state_connected = 0x01U,                   
    qsc_socket_state_listening = 0x02U,                   
    qsc_socket_state_connectionless = 0x03U              
} qsc_socket_states;

typedef enum
{
    qsc_socket_option_none = 0x00000000L,             
#if defined(QSC_SYSTEM_OS_LINUX)
    qsc_socket_option_broadcast = 6,                 
    qsc_socket_option_ipv6_only = 26,                    
    qsc_socket_option_keepalive = 9,                 
    qsc_socket_option_linger = 13,                      
    qsc_socket_option_no_route = 5,                       
    qsc_socket_option_out_of_band = 10,                    
    qsc_socket_option_reuse_address = 2,             
    qsc_socket_option_receive_time_out = 20,          
    qsc_socket_option_send_time_out = 21,                
    qsc_socket_option_receive_buffer_size = 8,     
    qsc_socket_option_send_buffer_size = 7,           
#else   /* Windows, macOS, BSD */
    qsc_socket_option_broadcast = 0x00000020L,           
    qsc_socket_option_ipv6_only = 0x0000001BL,           
    qsc_socket_option_keepalive = 0x00000008L,           
    qsc_socket_option_linger = 0x00000080L,             
    qsc_socket_option_no_route = 0x00000010L,         
    qsc_socket_option_out_of_band = 0x00000100L,       
    qsc_socket_option_reuse_address = 0x00000004L,       
    qsc_socket_option_receive_time_out = 0x00001006L, 
    qsc_socket_option_send_time_out = 0x00001005L,       
    qsc_socket_option_receive_buffer_size = 0x00001002L, 
    qsc_socket_option_send_buffer_size = 0x00001001L, 
#endif
    qsc_socket_option_tcp_no_delay = 0x00000001L,     
} qsc_socket_options;

typedef enum
{
    qsc_socket_protocol_none = 0x00000000L,             
    qsc_socket_protocol_ipv4 = 0x00000004L,             
#if defined(QSC_SYSTEM_OS_LINUX)
    qsc_socket_protocol_socket = 1,                       
#else   /* Windows, macOS, BSD */
    qsc_socket_protocol_socket = 0x0000FFFFL,         
#endif
    qsc_socket_protocol_tcp = 0x00000006L,               
    qsc_socket_protocol_udp = 0x00000011L,               
    qsc_socket_protocol_ipv6 = 0x00000029L,             
    qsc_socket_protocol_ipv6_routing = 0x0000002BL,     
    qsc_socket_protocol_ipv6_fragment = 0x0000002CL,   
    qsc_socket_protocol_icmpv6 = 0x0000003AL,         
    qsc_socket_protocol_ipv6_no_header = 0x0000003BL, 
    qsc_socket_protocol_dstopts = 0x0000003CL,           
    qsc_socket_protocol_raw = 0x000000FFL                
} qsc_socket_protocols;

typedef enum
{
    qsc_socket_receive_flag_none = 0x00000000L,         
    qsc_socket_receive_flag_out_of_band = 0x00000001L,   
    qsc_socket_receive_flag_peek = 0x00000002L,         
#if defined(QSC_SYSTEM_OS_WINDOWS)
    qsc_socket_receive_flag_wait_all = 0x00000008L      
#elif defined(QSC_SYSTEM_OS_MAC)
    qsc_socket_receive_flag_wait_all = 0x00000040L      
#else   /* Linux, BSD */
    qsc_socket_receive_flag_wait_all = 0x00000100L      
#endif
} qsc_socket_receive_flags;

typedef enum
{
    qsc_socket_send_flag_none = 0x00000000L,           
    qsc_socket_send_flag_send_oob = 0x00000001L,       
    qsc_socket_send_flag_peek_message = 0x00000002L,   
    qsc_socket_send_flag_no_routing = 0x00000004L,       
} qsc_socket_send_flags;

typedef enum
{
    qsc_socket_shut_down_flag_receive = 0x00000000L,   
    qsc_socket_shut_down_flag_send = 0x00000001L,     
    qsc_socket_shut_down_flag_both = 0x00000002L      
} qsc_socket_shut_down_flags;

typedef enum
{
    qsc_socket_transport_none = 0x00000000L,           
    qsc_socket_transport_stream = 0x00000001L,           
    qsc_socket_transport_datagram = 0x00000002L,       
    qsc_socket_transport_raw = 0x00000003L,             
    qsc_socket_transport_reliable = 0x00000004L,       
    qsc_socket_transport_sequenced = 0x00000005L      
} qsc_socket_transports;
 
QSC_CPLUSPLUS_ENABLED_END
 
#endif