#pragma once
#ifdef __cplusplus
extern "C" {
#endif
#include <stddef.h>
int fu_version_major(void);
int fu_version_minor(void);
int fu_version_patch(void);
#pragma region Types
typedef int fu_bool_t;
typedef void *fu_topology_t;
typedef void *fu_pool_t;
typedef void *fu_fabric_t;
typedef void *fu_lambda_context_t;
typedef int fu_memory_domain_id_t;
typedef void (*fu_for_threads_t)(fu_lambda_context_t context, size_t thread, size_t compute_domain);
typedef void (*fu_for_prongs_t)(fu_lambda_context_t context, size_t task, size_t thread, size_t compute_domain);
typedef void (*fu_for_slices_t)(fu_lambda_context_t context, size_t first, size_t count, size_t thread,
size_t compute_domain);
typedef enum fu_caller_exclusivity_t {
fu_caller_inclusive_k,
fu_caller_exclusive_k,
} fu_caller_exclusivity_t;
#pragma endregion Types
#pragma region Metadata
typedef enum fu_capabilities_t {
fu_capabilities_unknown_k = 0,
fu_capability_x86_pause_k = 1 << 0,
fu_capability_x86_tpause_k = 1 << 1,
fu_capability_arm64_yield_k = 1 << 2,
fu_capability_arm64_wfet_k = 1 << 3,
fu_capability_risc5_pause_k = 1 << 4,
fu_capability_risc5_wrs_k = 1 << 5,
fu_capability_os_threads_k = 1 << 6,
fu_capability_topology_k = 1 << 7,
fu_capability_place_threads_by_affinity_k = 1 << 8,
fu_capability_place_threads_by_core_class_k = 1 << 9,
fu_capability_reschedule_threads_by_class_k = 1 << 10,
fu_capability_place_memory_on_domain_k = 1 << 11,
fu_capability_place_huge_pages_on_domain_k = 1 << 12,
fu_capability_huge_transparent_pages_k = 1 << 13,
fu_capability_colocate_pools_on_domain_k = 1 << 14,
fu_capability_x86_cldemote_k = 1 << 15,
fu_capability_arm64_dc_cvac_k = 1 << 16,
fu_capability_risc5_zicbom_k = 1 << 17,
fu_capability_any_yield_k = fu_capability_x86_pause_k | fu_capability_x86_tpause_k | fu_capability_arm64_yield_k |
fu_capability_arm64_wfet_k | fu_capability_risc5_pause_k | fu_capability_risc5_wrs_k,
fu_capabilities_all_k = ~0,
} fu_capabilities_t;
fu_capabilities_t fu_comptime_capabilities(void);
fu_capabilities_t fu_runtime_capabilities(void);
size_t fu_name_capabilities(fu_capabilities_t capabilities, char *name_buffer, size_t name_buffer_length);
fu_topology_t fu_topology_new(void);
void fu_topology_delete(fu_topology_t topology);
size_t fu_logical_cores_count_in(fu_topology_t, size_t compute_domain_index);
size_t fu_logical_cores_count(fu_topology_t);
size_t fu_compute_domains_count(fu_topology_t);
size_t fu_compute_level_in(fu_topology_t, size_t compute_domain_index);
size_t fu_compute_levels_count(fu_topology_t);
size_t fu_compute_capacity_in(fu_topology_t, size_t compute_domain_index);
size_t fu_compute_cache_bytes_in(fu_topology_t, size_t compute_domain_index);
size_t fu_memory_domains_count(fu_topology_t);
size_t fu_local_memory_of(fu_topology_t, size_t compute_domain_index);
size_t fu_volume_ram_in(fu_topology_t, size_t memory_domain_index);
size_t fu_volume_ram(fu_topology_t);
size_t fu_volume_huge_pages_in(fu_topology_t, size_t memory_domain_index);
size_t fu_volume_huge_pages(fu_topology_t);
size_t fu_huge_pages_count_in(fu_topology_t, size_t memory_domain_index);
size_t fu_huge_pages_count(fu_topology_t);
#pragma endregion Metadata
#pragma region Memory
fu_memory_domain_id_t fu_memory_domain_id_at_index(fu_topology_t topology, size_t memory_domain_index);
void *fu_allocate_at_least_on_domain_id(fu_memory_domain_id_t memory_domain_id, size_t minimum_bytes,
size_t *allocated_bytes, size_t *bytes_per_page);
void *fu_allocate_on_domain_id(fu_memory_domain_id_t memory_domain_id, size_t bytes);
void fu_free_on_domain_id(fu_memory_domain_id_t memory_domain_id, void *pointer, size_t bytes);
void *fu_allocate_symmetric(fu_topology_t topology, size_t bytes_per_domain, size_t *stride_bytes,
size_t *memory_domains_count, size_t *total_bytes, size_t *bytes_per_page);
void fu_free_symmetric(void *base, size_t total_bytes);
#pragma endregion Memory
#pragma region Lifetime
fu_pool_t fu_pool_new(char const *name, fu_capabilities_t allowed);
void fu_pool_delete(fu_pool_t pool);
fu_capabilities_t fu_pool_capabilities(fu_pool_t pool);
fu_bool_t fu_pool_spawn(fu_topology_t topology, fu_pool_t pool, size_t threads, fu_caller_exclusivity_t exclusivity);
fu_bool_t fu_pool_spawn_on(fu_topology_t topology, fu_pool_t pool, size_t compute_domain_index, size_t threads,
fu_caller_exclusivity_t exclusivity);
fu_caller_exclusivity_t fu_pool_caller_exclusivity(fu_pool_t pool);
size_t fu_pool_compute_domains_count(fu_pool_t pool);
size_t fu_pool_threads_count_in(fu_pool_t pool, size_t compute_domain_index);
size_t fu_pool_threads_count(fu_pool_t pool);
size_t fu_pool_locate_thread_in(fu_pool_t pool, size_t global_thread_index, size_t compute_domain_index);
void fu_pool_sleep(fu_pool_t pool, size_t micros);
void fu_pool_terminate(fu_pool_t pool);
#pragma endregion Lifetime
#pragma region Fabric
fu_fabric_t fu_fabric_new(void);
void fu_fabric_delete(fu_fabric_t fabric);
fu_bool_t fu_fabric_harvest(fu_topology_t topology, fu_pool_t pool, fu_fabric_t fabric);
size_t fu_fabric_memory_latency(fu_fabric_t, size_t compute_domain_index, size_t memory_domain_index);
size_t fu_fabric_memory_bandwidth(fu_fabric_t, size_t compute_domain_index, size_t memory_domain_index);
size_t fu_fabric_memory_distance(fu_fabric_t, size_t compute_domain_index, size_t memory_domain_index);
size_t fu_fabric_memory_level_in(fu_fabric_t, size_t memory_domain_index);
size_t fu_fabric_memory_levels_count(fu_fabric_t);
#pragma endregion Fabric
#pragma region Primary API
void fu_pool_for_threads(fu_pool_t pool, fu_for_threads_t callback, fu_lambda_context_t context);
void fu_pool_for_slices(fu_pool_t pool, size_t n, fu_for_slices_t callback, fu_lambda_context_t context);
void fu_pool_for_n(fu_pool_t pool, size_t n, fu_for_prongs_t callback, fu_lambda_context_t context);
void fu_pool_for_n_dynamic(fu_pool_t pool, size_t n, fu_for_prongs_t callback, fu_lambda_context_t context);
#pragma endregion Primary API
#pragma region Flexible API
typedef size_t fu_generation_t;
fu_generation_t fu_pool_unsafe_for_threads(fu_pool_t pool, fu_for_threads_t callback, fu_lambda_context_t context);
fu_bool_t fu_pool_is_complete(fu_pool_t pool, fu_generation_t generation);
void fu_pool_unsafe_join(fu_pool_t pool, fu_generation_t generation);
#pragma endregion Flexible API
#ifdef __cplusplus
} #endif