pqscommon.h

/* 2025-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 PQS_MASTER_COMMON_H
#define PQS_MASTER_COMMON_H
 
#include "qsccommon.h"
#include <assert.h>
#include <errno.h>
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include <string.h>



#if defined(_DLL)
#   define PQS_DLL_API
#endif
#if defined(PQS_DLL_API)
#   if defined(QSC_SYSTEM_COMPILER_MSC)
#       if defined(PQS_DLL_IMPORT)
#           define PQS_EXPORT_API __declspec(dllimport)
#       else
#           define PQS_EXPORT_API __declspec(dllexport)
#       endif
#   elif defined(QSC_SYSTEM_COMPILER_GCC)
#       if defined(PQS_DLL_IMPORT)
#       define PQS_EXPORT_API __attribute__((dllimport))
#       else
#       define PQS_EXPORT_API __attribute__((dllexport))
#       endif
#   else
#       if defined(__SUNPRO_C)
#           if !defined(__GNU_C__)
#               define PQS_EXPORT_API __attribute__ (visibility(__global))
#           else
#               define PQS_EXPORT_API __attribute__ __global
#           endif
#       elif defined(_MSG_VER)
#           define PQS_EXPORT_API extern __declspec(dllexport)
#       else
#           define PQS_EXPORT_API __attribute__ ((visibility ("default")))
#       endif
#   endif
#else
#   define PQS_EXPORT_API
#endif
 
#if defined(DEBUG) || defined(_DEBUG) || defined(__DEBUG__) || (defined(__GNUC__) && !defined(__OPTIMIZE__))
#   define PQS_DEBUG_MODE
#endif
 
#ifdef PQS_DEBUG_MODE
#  define PQS_ASSERT(expr) assert(expr)
#else
#  define PQS_ASSERT(expr) ((void)0)
#endif


#define PQS_STRING_TERMINATOR_SIZE 1U

#define PQS_MINIMUM_MESSAGE_SIZE 1U

#define PQS_APPLICATION_MESSAGE_TYPE_SIZE 1U

#define PQS_APPLICATION_MESSAGE_HEADER_SIZE PQS_APPLICATION_MESSAGE_TYPE_SIZE
 
#ifndef PQS_SERVER_COMMAND_MAX
#   define PQS_SERVER_COMMAND_MAX 1280U
#endif
 
#ifndef PQS_SERVER_COMMAND_TEXT_MAX
#   define PQS_SERVER_COMMAND_TEXT_MAX (PQS_SERVER_COMMAND_MAX - PQS_STRING_TERMINATOR_SIZE)
#endif
 
#ifndef PQS_INTERPRETER_COMMAND_BUFFER_SIZE
#   define PQS_INTERPRETER_COMMAND_BUFFER_SIZE 128U
#endif

#define PQS_XFER_PATH_MAX 256U

#define PQS_XFER_CHUNK_SIZE 512U

#define PQS_XFER_LIST_BUFFER_SIZE 4096U

#define PQS_XFER_HASH_SIZE 32U

#define PQS_XFER_HASH_TEXT_SIZE ((PQS_XFER_HASH_SIZE * 2U) + PQS_STRING_TERMINATOR_SIZE)

#define PQS_XFER_METADATA_MAX 512U

#define PQS_XFER_USERS_ROOT_NAME "users"

#define PQS_XFER_RECURSIVE_PREFIX "-r"

#define PQS_XFER_RECURSION_MAX 64U

#define PQS_USERNAME_MAX 64U

#define PQS_USERNAME_TEXT_MAX (PQS_USERNAME_MAX - PQS_STRING_TERMINATOR_SIZE)

#define PQS_SHELL_PROFILE_NAME_MAX 64U

#define PQS_SHELL_PROFILE_TEXT_MAX (PQS_SHELL_PROFILE_NAME_MAX - PQS_STRING_TERMINATOR_SIZE)

#define PQS_PASSPHRASE_MIN 8U

#define PQS_PASSPHRASE_MAX 128U

#define PQS_PASSPHRASE_TEXT_MAX (PQS_PASSPHRASE_MAX - PQS_STRING_TERMINATOR_SIZE)

#define PQS_LOGIN_REQUEST_PAYLOAD_SIZE (PQS_USERNAME_MAX + PQS_PASSPHRASE_MAX)

#define PQS_LOGIN_REQUEST_MESSAGE_SIZE (PQS_APPLICATION_MESSAGE_HEADER_SIZE + PQS_LOGIN_REQUEST_PAYLOAD_SIZE)

#define PQS_USER_SALT_SIZE 32U

#define PQS_USER_VERIFIER_SIZE 32U

#define PQS_USER_DATABASE_MAX 128U

#define PQS_USER_DATABASE_VERSION 2U

#define PQS_SHELL_PROFILE_DATABASE_MAX 32U

#define PQS_SHELL_PROFILE_PATH_MAX QSC_SYSTEM_MAX_PATH

#define PQS_SHELL_PROFILE_TYPE_MAX 24U

#define PQS_SHELL_PROFILE_TYPE_TEXT_MAX (PQS_SHELL_PROFILE_TYPE_MAX - PQS_STRING_TERMINATOR_SIZE)

#define PQS_POLICY_DATABASE_MAX 64U

#define PQS_POLICY_NAME_MAX 64U

#define PQS_POLICY_NAME_TEXT_MAX (PQS_POLICY_NAME_MAX - PQS_STRING_TERMINATOR_SIZE)

#define PQS_POLICY_COMMAND_MAX 64U

#define PQS_POLICY_COMMAND_TEXT_MAX (PQS_POLICY_COMMAND_MAX - PQS_STRING_TERMINATOR_SIZE)

#define PQS_POLICY_COMMAND_LIST_MAX 768U
 
#endif