/*
 * Copyright (C) 2006-2026 Intel Corporation.
 * SPDX-License-Identifier: MIT
 */

// <COMPONENT>: os-apis
// <FILE-TYPE>: component private header

/*!
 * @file
 * This header was copied as is from OS-APIS without checking what is actually still needed for the transition time to Pin4
 * and what is not needed. (Only did minor changes)
 */

/*! @file
 * this headerfile contains defines the types that are the foundation of
 * other code
 */
/*!
 * @defgroup OS_APIS_TYPES Data types
 * @brief Contains data-type definitions
 */

#ifndef OS_TYPES_H
#define OS_TYPES_H

#ifndef ASM_ONLY

#include <stdint.h>

/*! @ingroup OS_APIS_TYPES
 * Data type for boolean
 */
#ifdef __cplusplus
typedef bool BOOL_T;
#else
typedef unsigned char BOOL_T;
#endif

#if !defined(TRUE)
#define TRUE 1
#endif
#if !defined(FALSE)
#define FALSE 0
#endif

#if !defined(VOID)
typedef void VOID;
#endif

#if !defined(NULL) && !defined(__ICL)
#define NULL ((void*)0)
#endif

typedef char CHAR;
typedef unsigned int UINT;
typedef int INT;
typedef double FLT64;
typedef float FLT32;
/*! @ingroup OS_APIS_TYPES
 * Generic type for three-state logic.
 */
enum TRI
{
    TRI_YES,
    TRI_NO,
    TRI_MAYBE
};

typedef uint8_t UINT8;
typedef uint16_t UINT16;
typedef uint32_t UINT32;
typedef uint64_t UINT64;
typedef int8_t INT8;
typedef int16_t INT16;
typedef int32_t INT32;
typedef int64_t INT64;

typedef UINT64 ANYADDR;

/*
 * Unsigned integer of the same size as a pointer on the TARGET architecture.
 * This quantity can be converted to and from an OADDR/IADDR
 *
 * There is an option of overflow and underflow when using ADDRDELTA.
 * For example, let's look at a 32 bit address.
 * 32 bit address is 32 bit unsigned int number.
 * This means that the maximum delta between two addresses is (2^32 - 1),
 * which means that the ADDRDELTA which is signed may overflow.
 */
#if defined(TARGET_IA32)

typedef UINT32 ADDRINT;
typedef INT32 ADDRDELTA;
#define ADDRINT_SIZE_IN_BITS 32
#define STACK_WORD_SIZE 4

#elif defined(TARGET_IA32E)

typedef UINT64 ADDRINT;
typedef INT64 ADDRDELTA;
#define ADDRINT_SIZE_IN_BITS 64
#define STACK_WORD_SIZE 8

#else
#error "Unsupported target architecture"
#endif

typedef ADDRINT USIZE;

#if defined(HOST_IA32)
typedef UINT32 VOIDINT;
typedef UINT32 PTRINT;
#define PTRINT_SIZE 32
#elif defined(HOST_IA32E)
typedef UINT64 VOIDINT;
typedef UINT64 PTRINT;
#define PTRINT_SIZE 64
#else
typedef ADDRINT VOIDINT;
typedef ADDRINT PTRINT;
#define PTRINT_SIZE ADDRINT_SIZE_IN_BITS
#endif

typedef UINT64 REG_CLASS_BITS;
typedef UINT32 REG_SUBCLASS_BITS;

/*
 * Generic macro definitions
 */

#if defined(_MSC_VER)
#define ALIGNMENT_OF(t) __alignof(t)
#else
#define ALIGNMENT_OF(t) __alignof__(t)
#endif

/*! @ingroup OS_APIS_TYPES
 * Generic data type to refer to a kernel file object.
 * This is actually an HANDLE in Windows, and a file descriptor
 * (int) on Unix systems.
 */
typedef ADDRINT NATIVE_FD;

/*! @ingroup OS_APIS_TYPES
 * Data type that can hold a process ID returned by the OS.
 */
typedef INT32 NATIVE_PID;

/*! @ingroup OS_APIS_TYPES
 * Data type to hold a native thread ID returned by the underlying OS.
 */
typedef INT32 NATIVE_TID;

typedef ADDRINT NATIVE_UID;

#if defined(TARGET_WINDOWS) && defined(MUTEX_USE_WINDOWS_EVENTS)
typedef VOID* OS_EVENT;
#else
typedef uint32_t OS_EVENT;
#endif

#define INVALID_NATIVE_FD (-1)
// We use a thread ID inside a reentrant lock to mark the thread that owns the lock.
// If the owner is 0, the implementation treats the lock as unlocked.
// Here we want to align to that implementation and use 0 as INVALID_NATIVE_TID.
#define INVALID_NATIVE_TID ((NATIVE_TID)0)
#define INVALID_NATIVE_PID ((NATIVE_PID)0)
#define NATIVE_PID_CURRENT ((NATIVE_PID)-1LL)
#define NATIVE_TID_CURRENT ((NATIVE_TID)-1LL)
#define OS_EVENT_INITIALIZER ((OS_EVENT)0)

/*! @ingroup OS_APIS_TYPES
 * The size of the memory cache line in a single core.
 */
#define CPU_MEMORY_CACHELINE_SIZE 64

/*! @ingroup OS_APIS_TYPES
 * The size of the file name buffer.
 */
#define FILENAME_BUF_SIZE 1024

#endif // ASM_ONLY

#endif
