llvm/openmp/runtime/src/kmp_global.cpp

/*
 * kmp_global.cpp -- KPTS global variables for runtime support library
 */

//===----------------------------------------------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//

#include "kmp.h"
#include "kmp_affinity.h"
#if KMP_USE_HIER_SCHED
#include "kmp_dispatch_hier.h"
#endif

kmp_key_t __kmp_gtid_threadprivate_key;

#if KMP_ARCH_X86 || KMP_ARCH_X86_64
kmp_cpuinfo_t __kmp_cpuinfo =; // Not initialized
#endif

#if KMP_STATS_ENABLED
#include "kmp_stats.h"
// lock for modifying the global __kmp_stats_list
kmp_tas_lock_t __kmp_stats_lock;

// global list of per thread stats, the head is a sentinel node which
// accumulates all stats produced before __kmp_create_worker is called.
kmp_stats_list *__kmp_stats_list;

// thread local pointer to stats node within list
KMP_THREAD_LOCAL kmp_stats_list *__kmp_stats_thread_ptr = NULL;

// gives reference tick for all events (considered the 0 tick)
tsc_tick_count __kmp_stats_start_time;
#endif

/* ----------------------------------------------------- */
/* INITIALIZATION VARIABLES */
/* they are syncronized to write during init, but read anytime */
volatile int __kmp_init_serial =;
volatile int __kmp_init_gtid =;
volatile int __kmp_init_common =;
volatile int __kmp_need_register_serial =;
volatile int __kmp_init_middle =;
volatile int __kmp_init_parallel =;
volatile int __kmp_init_hidden_helper =;
volatile int __kmp_init_hidden_helper_threads =;
volatile int __kmp_hidden_helper_team_done =;
#if KMP_USE_MONITOR
volatile int __kmp_init_monitor =
    0; /* 1 - launched, 2 - actually started (Windows* OS only) */
#endif
volatile int __kmp_init_user_locks =;

/* list of address of allocated caches for commons */
kmp_cached_addr_t *__kmp_threadpriv_cache_list =;

int __kmp_init_counter =;
int __kmp_root_counter =;
int __kmp_version =;

std::atomic<kmp_int32> __kmp_team_counter =;
std::atomic<kmp_int32> __kmp_task_counter =;

size_t __kmp_stksize =;
#if KMP_USE_MONITOR
size_t __kmp_monitor_stksize = 0; // auto adjust
#endif
size_t __kmp_stkoffset =;
int __kmp_stkpadding =;

size_t __kmp_malloc_pool_incr =;

// Barrier method defaults, settings, and strings.
// branch factor = 2^branch_bits (only relevant for tree & hyper barrier types)
kmp_uint32 __kmp_barrier_gather_bb_dflt =;
/* branch_factor = 4 */ /* hyper2: C78980 */
kmp_uint32 __kmp_barrier_release_bb_dflt =;
/* branch_factor = 4 */ /* hyper2: C78980 */

kmp_bar_pat_e __kmp_barrier_gather_pat_dflt =;
/* hyper2: C78980 */
kmp_bar_pat_e __kmp_barrier_release_pat_dflt =;
/* hyper2: C78980 */

kmp_uint32 __kmp_barrier_gather_branch_bits[bs_last_barrier] =;
kmp_uint32 __kmp_barrier_release_branch_bits[bs_last_barrier] =;
kmp_bar_pat_e __kmp_barrier_gather_pattern[bs_last_barrier] =;
kmp_bar_pat_e __kmp_barrier_release_pattern[bs_last_barrier] =;
char const *__kmp_barrier_branch_bit_env_name[bs_last_barrier] =;
char const *__kmp_barrier_pattern_env_name[bs_last_barrier] =;
char const *__kmp_barrier_type_name[bs_last_barrier] =;
char const *__kmp_barrier_pattern_name[bp_last_bar] =;

int __kmp_allThreadsSpecified =;
size_t __kmp_align_alloc =;

int __kmp_generate_warnings =;
int __kmp_reserve_warn =;
int __kmp_xproc =;
int __kmp_avail_proc =;
size_t __kmp_sys_min_stksize =;
int __kmp_sys_max_nth =;
int __kmp_max_nth =;
int __kmp_cg_max_nth =;
int __kmp_task_max_nth =;
int __kmp_teams_max_nth =;
int __kmp_threads_capacity =;
int __kmp_dflt_team_nth =;
int __kmp_dflt_team_nth_ub =;
int __kmp_tp_capacity =;
int __kmp_tp_cached =;
int __kmp_dispatch_num_buffers =;
int __kmp_dflt_max_active_levels =; // Nesting off by default
bool __kmp_dflt_max_active_levels_set =; // Don't override set value
#if KMP_NESTED_HOT_TEAMS
int __kmp_hot_teams_mode =; /* 0 - free extra threads when reduced */
/* 1 - keep extra threads when reduced */
int __kmp_hot_teams_max_level =; /* nesting level of hot teams */
#endif
enum library_type __kmp_library =;
enum sched_type __kmp_sched =; /* scheduling method for runtime scheduling */
enum sched_type __kmp_static =; /* default static scheduling method */
enum sched_type __kmp_guided =; /* default guided scheduling method */
enum sched_type __kmp_auto =; /* default auto scheduling method */
#if KMP_USE_HIER_SCHED
int __kmp_dispatch_hand_threading = 0;
int __kmp_hier_max_units[kmp_hier_layer_e::LAYER_LAST + 1];
int __kmp_hier_threads_per[kmp_hier_layer_e::LAYER_LAST + 1];
kmp_hier_sched_env_t __kmp_hier_scheds = {0, 0, NULL, NULL, NULL};
#endif
int __kmp_dflt_blocktime =; // in microseconds
char __kmp_blocktime_units =; // Units specified in KMP_BLOCKTIME
bool __kmp_wpolicy_passive =;
#if KMP_USE_MONITOR
int __kmp_monitor_wakeups = KMP_MIN_MONITOR_WAKEUPS;
int __kmp_bt_intervals = KMP_INTERVALS_FROM_BLOCKTIME(KMP_DEFAULT_BLOCKTIME,
                                                      KMP_MIN_MONITOR_WAKEUPS);
#endif
#ifdef KMP_ADJUST_BLOCKTIME
int __kmp_zero_bt =;
#endif /* KMP_ADJUST_BLOCKTIME */
#ifdef KMP_DFLT_NTH_CORES
int __kmp_ncores = 0;
#endif
int __kmp_chunk =;
int __kmp_force_monotonic =;
int __kmp_abort_delay =;
#if (KMP_OS_LINUX || KMP_OS_AIX) && defined(KMP_TDATA_GTID)
int __kmp_gtid_mode =; /* use __declspec(thread) TLS to store gtid */
int __kmp_adjust_gtid_mode =;
#elif KMP_OS_WINDOWS
int __kmp_gtid_mode = 2; /* use TLS functions to store gtid */
int __kmp_adjust_gtid_mode = FALSE;
#else
int __kmp_gtid_mode = 0; /* select method to get gtid based on #threads */
int __kmp_adjust_gtid_mode = TRUE;
#endif /* KMP_OS_LINUX && defined(KMP_TDATA_GTID) */
#ifdef KMP_TDATA_GTID
KMP_THREAD_LOCAL int __kmp_gtid =;
#endif /* KMP_TDATA_GTID */
int __kmp_tls_gtid_min =;
int __kmp_foreign_tp =;
#if KMP_ARCH_X86 || KMP_ARCH_X86_64
int __kmp_inherit_fp_control =;
kmp_int16 __kmp_init_x87_fpu_control_word =;
kmp_uint32 __kmp_init_mxcsr =;
#endif /* KMP_ARCH_X86 || KMP_ARCH_X86_64 */

#ifdef USE_LOAD_BALANCE
double __kmp_load_balance_interval =;
#endif /* USE_LOAD_BALANCE */

kmp_nested_nthreads_t __kmp_nested_nth =;

#if KMP_USE_ADAPTIVE_LOCKS

kmp_adaptive_backoff_params_t __kmp_adaptive_backoff_params =; // TODO: tune it!

#if KMP_DEBUG_ADAPTIVE_LOCKS
const char *__kmp_speculative_statsfile = "-";
#endif

#endif // KMP_USE_ADAPTIVE_LOCKS

int __kmp_display_env =;
int __kmp_display_env_verbose =;
int __kmp_omp_cancellation =;
int __kmp_nteams =;
int __kmp_teams_thread_limit =;

#if KMP_HAVE_MWAIT || KMP_HAVE_UMWAIT
int __kmp_user_level_mwait =;
int __kmp_umwait_enabled =;
int __kmp_mwait_enabled =;
int __kmp_mwait_hints =;
#endif

#if KMP_HAVE_UMWAIT
int __kmp_waitpkg_enabled =;
int __kmp_tpause_state =;
int __kmp_tpause_hint =;
int __kmp_tpause_enabled =;
#endif

/* map OMP 3.0 schedule types with our internal schedule types */
enum sched_type __kmp_sch_map[kmp_sched_upper - kmp_sched_lower_ext +
                              kmp_sched_upper_std - kmp_sched_lower - 2] =;

#if KMP_OS_LINUX
enum clock_function_type __kmp_clock_function;
int __kmp_clock_function_param;
#endif /* KMP_OS_LINUX */

#if KMP_MIC_SUPPORTED
enum mic_type __kmp_mic_type =;
#endif

#if KMP_AFFINITY_SUPPORTED

KMPAffinity *__kmp_affinity_dispatch =;

#if KMP_USE_HWLOC
int __kmp_hwloc_error = FALSE;
hwloc_topology_t __kmp_hwloc_topology = NULL;
#endif

#if KMP_OS_WINDOWS
#if KMP_GROUP_AFFINITY
int __kmp_num_proc_groups = 1;
#endif /* KMP_GROUP_AFFINITY */
kmp_GetActiveProcessorCount_t __kmp_GetActiveProcessorCount = NULL;
kmp_GetActiveProcessorGroupCount_t __kmp_GetActiveProcessorGroupCount = NULL;
kmp_GetThreadGroupAffinity_t __kmp_GetThreadGroupAffinity = NULL;
kmp_SetThreadGroupAffinity_t __kmp_SetThreadGroupAffinity = NULL;
#endif /* KMP_OS_WINDOWS */

size_t __kmp_affin_mask_size =;
enum affinity_top_method __kmp_affinity_top_method =;

// Regular thread affinity settings from KMP_AFFINITY
kmp_affinity_t __kmp_affinity =;
// Hidden helper thread affinity settings from KMP_HIDDEN_HELPER_AFFINITY
kmp_affinity_t __kmp_hh_affinity =;
kmp_affinity_t *__kmp_affinities[] =;

char *__kmp_cpuinfo_file =;
#if KMP_WEIGHTED_ITERATIONS_SUPPORTED
int __kmp_first_osid_with_ecore =;
#endif

#endif /* KMP_AFFINITY_SUPPORTED */

kmp_nested_proc_bind_t __kmp_nested_proc_bind =;
kmp_proc_bind_t __kmp_teams_proc_bind =;
int __kmp_affinity_num_places =;
int __kmp_display_affinity =;
char *__kmp_affinity_format =;

kmp_int32 __kmp_default_device =;

kmp_tasking_mode_t __kmp_tasking_mode =;
kmp_int32 __kmp_max_task_priority =;
kmp_uint64 __kmp_taskloop_min_tasks =;

int __kmp_memkind_available =;
omp_allocator_handle_t const omp_null_allocator =;
omp_allocator_handle_t const omp_default_mem_alloc =;
omp_allocator_handle_t const omp_large_cap_mem_alloc =;
omp_allocator_handle_t const omp_const_mem_alloc =;
omp_allocator_handle_t const omp_high_bw_mem_alloc =;
omp_allocator_handle_t const omp_low_lat_mem_alloc =;
omp_allocator_handle_t const omp_cgroup_mem_alloc =;
omp_allocator_handle_t const omp_pteam_mem_alloc =;
omp_allocator_handle_t const omp_thread_mem_alloc =;
omp_allocator_handle_t const llvm_omp_target_host_mem_alloc =;
omp_allocator_handle_t const llvm_omp_target_shared_mem_alloc =;
omp_allocator_handle_t const llvm_omp_target_device_mem_alloc =;
omp_allocator_handle_t const kmp_max_mem_alloc =;
omp_allocator_handle_t __kmp_def_allocator =;

omp_memspace_handle_t const omp_default_mem_space =;
omp_memspace_handle_t const omp_large_cap_mem_space =;
omp_memspace_handle_t const omp_const_mem_space =;
omp_memspace_handle_t const omp_high_bw_mem_space =;
omp_memspace_handle_t const omp_low_lat_mem_space =;
omp_memspace_handle_t const llvm_omp_target_host_mem_space =;
omp_memspace_handle_t const llvm_omp_target_shared_mem_space =;
omp_memspace_handle_t const llvm_omp_target_device_mem_space =;

/* This check ensures that the compiler is passing the correct data type for the
   flags formal parameter of the function kmpc_omp_task_alloc(). If the type is
   not a 4-byte type, then give an error message about a non-positive length
   array pointing here.  If that happens, the kmp_tasking_flags_t structure must
   be redefined to have exactly 32 bits. */
KMP_BUILD_ASSERT();

int __kmp_task_stealing_constraint =; /* Constrain task stealing by default */
int __kmp_enable_task_throttling =;

#ifdef DEBUG_SUSPEND
int __kmp_suspend_count = 0;
#endif

int __kmp_settings =;
int __kmp_duplicate_library_ok =;
#if USE_ITT_BUILD
int __kmp_forkjoin_frames =;
int __kmp_forkjoin_frames_mode =;
#endif
PACKED_REDUCTION_METHOD_T __kmp_force_reduction_method =;
int __kmp_determ_red =;

#ifdef KMP_DEBUG
int kmp_a_debug = 0;
int kmp_b_debug = 0;
int kmp_c_debug = 0;
int kmp_d_debug = 0;
int kmp_e_debug = 0;
int kmp_f_debug = 0;
int kmp_diag = 0;
#endif

/* For debug information logging using rotating buffer */
int __kmp_debug_buf =; /* TRUE means use buffer, FALSE means print to stderr */
int __kmp_debug_buf_lines =; /* Lines of debug stored in buffer */
int __kmp_debug_buf_chars =; /* Characters allowed per line in buffer */
int __kmp_debug_buf_atomic =; /* TRUE means use atomic update of buffer entry pointer */

char *__kmp_debug_buffer =; /* Debug buffer itself */
std::atomic<int> __kmp_debug_count =; /* number of lines printed in buffer so far */
int __kmp_debug_buf_warn_chars =; /* Keep track of char increase recommended in warnings */
/* end rotating debug buffer */

#ifdef KMP_DEBUG
int __kmp_par_range; /* +1 => only go par for constructs in range */
/* -1 => only go par for constructs outside range */
char __kmp_par_range_routine[KMP_PAR_RANGE_ROUTINE_LEN] = {'\0'};
char __kmp_par_range_filename[KMP_PAR_RANGE_FILENAME_LEN] = {'\0'};
int __kmp_par_range_lb = 0;
int __kmp_par_range_ub = INT_MAX;
#endif /* KMP_DEBUG */

/* For printing out dynamic storage map for threads and teams */
int __kmp_storage_map =; /* True means print storage map for threads and teams */
int __kmp_storage_map_verbose =; /* True means storage map includes placement info */
int __kmp_storage_map_verbose_specified =;
/* Initialize the library data structures when we fork a child process, defaults
 * to TRUE */
int __kmp_need_register_atfork =; /* At initialization, call pthread_atfork to install fork handler */
int __kmp_need_register_atfork_specified =;

int __kmp_env_stksize =; /* KMP_STACKSIZE specified? */
int __kmp_env_blocktime =; /* KMP_BLOCKTIME specified? */
int __kmp_env_checks =; /* KMP_CHECKS specified?    */
int __kmp_env_consistency_check =; /* KMP_CONSISTENCY_CHECK specified? */

// From KMP_USE_YIELD:
// 0 = never yield;
// 1 = always yield (default);
// 2 = yield only if oversubscribed
#if KMP_OS_DARWIN && KMP_ARCH_AARCH64
// Set to 0 for environments where yield is slower
kmp_int32 __kmp_use_yield = 0;
#else
kmp_int32 __kmp_use_yield =;
#endif

// This will be 1 if KMP_USE_YIELD environment variable was set explicitly
kmp_int32 __kmp_use_yield_exp_set =;

kmp_uint32 __kmp_yield_init =;
kmp_uint32 __kmp_yield_next =;
kmp_uint64 __kmp_pause_init =; // for tpause

/* ------------------------------------------------------ */
/* STATE mostly syncronized with global lock */
/* data written to rarely by primary threads, read often by workers */
/* TODO: None of this global padding stuff works consistently because the order
   of declaration is not necessarily correlated to storage order. To fix this,
   all the important globals must be put in a big structure instead. */
KMP_ALIGN_CACHE
kmp_info_t **__kmp_threads =;
kmp_root_t **__kmp_root =;
kmp_old_threads_list_t *__kmp_old_threads_list =;

/* data read/written to often by primary threads */
KMP_ALIGN_CACHE
volatile int __kmp_nth =;
volatile int __kmp_all_nth =;
volatile kmp_info_t *__kmp_thread_pool =;
volatile kmp_team_t *__kmp_team_pool =;

KMP_ALIGN_CACHE
std::atomic<int> __kmp_thread_pool_active_nth =;

/* -------------------------------------------------
 * GLOBAL/ROOT STATE */
KMP_ALIGN_CACHE
kmp_global_t __kmp_global;

/* ----------------------------------------------- */
/* GLOBAL SYNCHRONIZATION LOCKS */
/* TODO verify the need for these locks and if they need to be global */

#if KMP_USE_INTERNODE_ALIGNMENT
/* Multinode systems have larger cache line granularity which can cause
 * false sharing if the alignment is not large enough for these locks */
KMP_ALIGN_CACHE_INTERNODE

KMP_BOOTSTRAP_LOCK_INIT(__kmp_initz_lock); /* Control initializations */
KMP_ALIGN_CACHE_INTERNODE
KMP_BOOTSTRAP_LOCK_INIT(__kmp_forkjoin_lock); /* control fork/join access */
KMP_ALIGN_CACHE_INTERNODE
KMP_BOOTSTRAP_LOCK_INIT(__kmp_exit_lock); /* exit() is not always thread-safe */
#if KMP_USE_MONITOR
/* control monitor thread creation */
KMP_ALIGN_CACHE_INTERNODE
KMP_BOOTSTRAP_LOCK_INIT(__kmp_monitor_lock);
#endif
/* used for the hack to allow threadprivate cache and __kmp_threads expansion
   to co-exist */
KMP_ALIGN_CACHE_INTERNODE
KMP_BOOTSTRAP_LOCK_INIT(__kmp_tp_cached_lock);

KMP_ALIGN_CACHE_INTERNODE
KMP_LOCK_INIT(__kmp_global_lock); /* Control OS/global access */
KMP_ALIGN_CACHE_INTERNODE
kmp_queuing_lock_t __kmp_dispatch_lock; /* Control dispatch access  */
KMP_ALIGN_CACHE_INTERNODE
KMP_LOCK_INIT(__kmp_debug_lock); /* Control I/O access for KMP_DEBUG */
#else
KMP_ALIGN_CACHE

KMP_BOOTSTRAP_LOCK_INIT(); /* Control initializations */
KMP_BOOTSTRAP_LOCK_INIT(); /* control fork/join access */
KMP_BOOTSTRAP_LOCK_INIT(); /* exit() is not always thread-safe */
#if KMP_USE_MONITOR
/* control monitor thread creation */
KMP_BOOTSTRAP_LOCK_INIT(__kmp_monitor_lock);
#endif
/* used for the hack to allow threadprivate cache and __kmp_threads expansion
   to co-exist */
KMP_BOOTSTRAP_LOCK_INIT();

KMP_ALIGN()
KMP_LOCK_INIT(); /* Control OS/global access */
KMP_ALIGN(128)
kmp_queuing_lock_t __kmp_dispatch_lock; /* Control dispatch access  */
KMP_ALIGN()
KMP_LOCK_INIT(); /* Control I/O access for KMP_DEBUG */
#endif

/* ----------------------------------------------- */

#if KMP_HANDLE_SIGNALS
/* Signal handling is disabled by default, because it confuses users: In case of
   sigsegv (or other trouble) in user code signal handler catches the signal,
   which then "appears" in the monitor thread (when the monitor executes raise()
   function). Users see signal in the monitor thread and blame OpenMP RTL.

   Grant said signal handling required on some older OSes (Irix?) supported by
   KAI, because bad applications hung but not aborted. Currently it is not a
   problem for Linux* OS, OS X* and Windows* OS.

   Grant: Found new hangs for EL4, EL5, and a Fedora Core machine.  So I'm
   putting the default back for now to see if that fixes hangs on those
   machines.

   2010-04013 Lev: It was a bug in Fortran RTL. Fortran RTL prints a kind of
   stack backtrace when program is aborting, but the code is not signal-safe.
   When multiple signals raised at the same time (which occurs in dynamic
   negative tests because all the worker threads detects the same error),
   Fortran RTL may hang. The bug finally fixed in Fortran RTL library provided
   by Steve R., and will be available soon. */
int __kmp_handle_signals =;
#endif

#ifdef DEBUG_SUSPEND
int get_suspend_count_(void) {
  int count = __kmp_suspend_count;
  __kmp_suspend_count = 0;
  return count;
}
void set_suspend_count_(int *value) { __kmp_suspend_count = *value; }
#endif

kmp_target_offload_kind_t __kmp_target_offload =;

// OMP Pause Resources
kmp_pause_status_t __kmp_pause_status =;

// Nesting mode
int __kmp_nesting_mode =;
int __kmp_nesting_mode_nlevels =;
int *__kmp_nesting_nth_level;

#if OMPX_TASKGRAPH
// TDG record & replay
int __kmp_tdg_dot = 0;
kmp_int32 __kmp_max_tdgs = 100;
kmp_tdg_info_t **__kmp_global_tdgs = NULL;
kmp_int32 __kmp_curr_tdg_idx =
    0; // Id of the current TDG being recorded or executed
kmp_int32 __kmp_num_tdg = 0;
kmp_int32 __kmp_successors_size = 10; // Initial succesor size list for
                                      // recording
std::atomic<kmp_int32> __kmp_tdg_task_id = 0;
#endif
// end of file //