mono/metadata/threads-types.h

   1 /**
   2  * \file
   3  * Generic thread typedef support (includes system-specific files)
   4  *
   5  * Author:
   6  *      Dick Porter (dick@ximian.com)
   7  *
   8  * (C) 2001 Ximian, Inc
   9  * (C) Copyright 2002-2006 Novell, Inc
  10  * Licensed under the MIT license. See LICENSE file in the project root for full license information.
  11  */
  12
  13 #ifndef _MONO_METADATA_THREADS_TYPES_H_
  14 #define _MONO_METADATA_THREADS_TYPES_H_
  15
  16 #include <glib.h>
  17
  18 #include <mono/utils/mono-forward-internal.h>
  19 #include <mono/metadata/object.h>
  20 #include "mono/metadata/handle.h"
  21 #include "mono/utils/mono-compiler.h"
  22 #include "mono/utils/mono-membar.h"
  23 #include "mono/utils/mono-threads.h"
  24 #include "mono/metadata/class-internals.h"
  25 #include <mono/metadata/icalls.h>
  26
  27 /* This is a copy of System.Threading.ThreadState */
  28 typedef enum {
  29         ThreadState_Running = 0x00000000,
  30         ThreadState_SuspendRequested = 0x00000002,
  31         ThreadState_Background = 0x00000004,
  32         ThreadState_Unstarted = 0x00000008,
  33         ThreadState_Stopped = 0x00000010,
  34         ThreadState_WaitSleepJoin = 0x00000020,
  35         ThreadState_Suspended = 0x00000040,
  36         ThreadState_AbortRequested = 0x00000080,
  37         ThreadState_Aborted = 0x00000100
  38 } MonoThreadState;
  39
  40 G_ENUM_FUNCTIONS (MonoThreadState)
  41
  42 /* This is a copy of System.Threading.ApartmentState */
  43 typedef enum {
  44         ThreadApartmentState_STA = 0x00000000,
  45         ThreadApartmentState_MTA = 0x00000001,
  46         ThreadApartmentState_Unknown = 0x00000002
  47 } MonoThreadApartmentState;
  48
  49 typedef enum {
  50 // These values match System.Threading.ThreadPriority.
  51 // These values match System.Diagnostics.ThreadPriorityLevel and Windows, but are offset by 2.
  52         MONO_THREAD_PRIORITY_LOWEST       = 0,
  53         MONO_THREAD_PRIORITY_BELOW_NORMAL = 1,
  54         MONO_THREAD_PRIORITY_NORMAL       = 2,
  55         MONO_THREAD_PRIORITY_ABOVE_NORMAL = 3,
  56         MONO_THREAD_PRIORITY_HIGHEST      = 4,
  57 } MonoThreadPriority;
  58
  59 #define SPECIAL_STATIC_NONE 0
  60 #define SPECIAL_STATIC_THREAD 1
  61 #define SPECIAL_STATIC_CONTEXT 2
  62
  63 /* It's safe to access System.Threading.InternalThread from native code via a
  64  * raw pointer because all instances should be pinned.  But for uniformity of
  65  * icall wrapping, let's declare a MonoInternalThreadHandle anyway.
  66  */
  67 TYPED_HANDLE_DECL (MonoInternalThread);
  68
  69 typedef void (*MonoThreadCleanupFunc) (MonoNativeThreadId tid);
  70 /* INFO has type MonoThreadInfo* */
  71 typedef void (*MonoThreadNotifyPendingExcFunc) (gpointer info);
  72
  73 void
  74 mono_thread_callbacks_init (void);
  75
  76 typedef enum {
  77         MONO_THREAD_CREATE_FLAGS_NONE         = 0x0,
  78         MONO_THREAD_CREATE_FLAGS_THREADPOOL   = 0x1,
  79         MONO_THREAD_CREATE_FLAGS_DEBUGGER     = 0x2,
  80         MONO_THREAD_CREATE_FLAGS_FORCE_CREATE = 0x4,
  81         MONO_THREAD_CREATE_FLAGS_SMALL_STACK  = 0x8,
  82 } MonoThreadCreateFlags;
  83
  84 // FIXME func should be MonoThreadStart and remove the template
  85 MonoInternalThread*
  86 mono_thread_create_internal (MonoDomain *domain, gpointer func, gpointer arg, MonoThreadCreateFlags flags, MonoError *error);
  87
  88 #ifdef __cplusplus
  89 template <typename T>
  90 inline MonoInternalThread*
  91 mono_thread_create_internal (MonoDomain *domain, T func, gpointer arg, MonoThreadCreateFlags flags, MonoError *error)
  92 {
  93         return mono_thread_create_internal(domain, (gpointer)func, arg, flags, error);
  94 }
  95 #endif
  96
  97 MonoInternalThreadHandle
  98 mono_thread_create_internal_handle (MonoDomain *domain, gpointer func, gpointer arg, MonoThreadCreateFlags flags, MonoError *error);
  99
 100 #ifdef __cplusplus
 101 template <typename T>
 102 inline MonoInternalThreadHandle
 103 mono_thread_create_internal_handle (MonoDomain *domain, T func, gpointer arg, MonoThreadCreateFlags flags, MonoError *error)
 104 {
 105         return mono_thread_create_internal_handle(domain, (gpointer)func, arg, flags, error);
 106 }
 107 #endif
 108
 109 /* Data owned by a MonoInternalThread that must live until both the finalizer
 110  * for MonoInternalThread has run, and the underlying machine thread has
 111  * detached.
 112  *
 113  * Normally a thread is first detached and then the InternalThread object is
 114  * finalized and collected.  However during shutdown, when the root domain is
 115  * finalized, all the InternalThread objects are finalized first and the
 116  * machine threads are detached later.
 117  */
 118 typedef struct {
 119   MonoRefCount ref;
 120   MonoCoopMutex *synch_cs;
 121 } MonoLongLivedThreadData;
 122
 123 void mono_threads_install_cleanup (MonoThreadCleanupFunc func);
 124
 125 ICALL_EXPORT
 126 void ves_icall_System_Threading_Thread_SetName_internal (MonoInternalThread *this_obj, MonoString *name);
 127
 128 ICALL_EXPORT
 129 MonoObject* ves_icall_System_Threading_Thread_GetCachedCurrentCulture (MonoInternalThread *this_obj);
 130
 131 ICALL_EXPORT
 132 void ves_icall_System_Threading_Thread_SetCachedCurrentCulture (MonoThread *this_obj, MonoObject *culture);
 133
 134 ICALL_EXPORT
 135 MonoObject* ves_icall_System_Threading_Thread_GetCachedCurrentUICulture (MonoInternalThread *this_obj);
 136
 137 ICALL_EXPORT
 138 void ves_icall_System_Threading_Thread_SetCachedCurrentUICulture (MonoThread *this_obj, MonoObject *culture);
 139
 140 ICALL_EXPORT
 141 gint32 ves_icall_System_Threading_Interlocked_Increment_Int(gint32 *location);
 142
 143 ICALL_EXPORT
 144 gint64 ves_icall_System_Threading_Interlocked_Increment_Long(gint64 *location);
 145
 146 ICALL_EXPORT
 147 gint32 ves_icall_System_Threading_Interlocked_Decrement_Int(gint32 *location);
 148
 149 ICALL_EXPORT
 150 gint64 ves_icall_System_Threading_Interlocked_Decrement_Long(gint64 * location);
 151
 152 ICALL_EXPORT
 153 gint32 ves_icall_System_Threading_Interlocked_Exchange_Int(gint32 *location, gint32 value);
 154
 155 ICALL_EXPORT
 156 gint64 ves_icall_System_Threading_Interlocked_Exchange_Long(gint64 *location, gint64 value);
 157
 158 ICALL_EXPORT
 159 MonoObject *ves_icall_System_Threading_Interlocked_Exchange_Object(MonoObject **location, MonoObject *value);
 160
 161 ICALL_EXPORT
 162 gpointer ves_icall_System_Threading_Interlocked_Exchange_IntPtr(gpointer *location, gpointer value);
 163
 164 ICALL_EXPORT
 165 gfloat ves_icall_System_Threading_Interlocked_Exchange_Single(gfloat *location, gfloat value);
 166
 167 ICALL_EXPORT
 168 gdouble ves_icall_System_Threading_Interlocked_Exchange_Double(gdouble *location, gdouble value);
 169
 170 ICALL_EXPORT
 171 gint32 ves_icall_System_Threading_Interlocked_CompareExchange_Int(gint32 *location, gint32 value, gint32 comparand);
 172
 173 ICALL_EXPORT
 174 gint32 ves_icall_System_Threading_Interlocked_CompareExchange_Int_Success(gint32 *location, gint32 value, gint32 comparand, MonoBoolean *success);
 175
 176 ICALL_EXPORT
 177 gint64 ves_icall_System_Threading_Interlocked_CompareExchange_Long(gint64 *location, gint64 value, gint64 comparand);
 178
 179 ICALL_EXPORT
 180 MonoObject *ves_icall_System_Threading_Interlocked_CompareExchange_Object(MonoObject **location, MonoObject *value, MonoObject *comparand);
 181
 182 ICALL_EXPORT
 183 gpointer ves_icall_System_Threading_Interlocked_CompareExchange_IntPtr(gpointer *location, gpointer value, gpointer comparand);
 184
 185 ICALL_EXPORT
 186 gfloat ves_icall_System_Threading_Interlocked_CompareExchange_Single(gfloat *location, gfloat value, gfloat comparand);
 187
 188 ICALL_EXPORT
 189 gdouble ves_icall_System_Threading_Interlocked_CompareExchange_Double(gdouble *location, gdouble value, gdouble comparand);
 190
 191 ICALL_EXPORT
 192 MonoObject* ves_icall_System_Threading_Interlocked_CompareExchange_T(MonoObject **location, MonoObject *value, MonoObject *comparand);
 193
 194 ICALL_EXPORT
 195 MonoObject* ves_icall_System_Threading_Interlocked_Exchange_T(MonoObject **location, MonoObject *value);
 196
 197 ICALL_EXPORT
 198 gint32 ves_icall_System_Threading_Interlocked_Add_Int(gint32 *location, gint32 value);
 199
 200 ICALL_EXPORT
 201 gint64 ves_icall_System_Threading_Interlocked_Add_Long(gint64 *location, gint64 value);
 202
 203 ICALL_EXPORT
 204 gint64 ves_icall_System_Threading_Interlocked_Read_Long(gint64 *location);
 205
 206 ICALL_EXPORT
 207 gint32 ves_icall_System_Threading_Interlocked_Increment_Int(gint32 *location);
 208
 209 ICALL_EXPORT
 210 gint64 ves_icall_System_Threading_Interlocked_Increment_Long(gint64 *location);
 211
 212 ICALL_EXPORT
 213 gint32 ves_icall_System_Threading_Interlocked_Decrement_Int(gint32 *location);
 214
 215 ICALL_EXPORT
 216 gint64 ves_icall_System_Threading_Interlocked_Decrement_Long(gint64 * location);
 217
 218 ICALL_EXPORT
 219 void ves_icall_System_Threading_Interlocked_MemoryBarrierProcessWide (void);
 220
 221 ICALL_EXPORT
 222 gint8 ves_icall_System_Threading_Thread_VolatileRead1 (void *ptr);
 223
 224 ICALL_EXPORT
 225 gint16 ves_icall_System_Threading_Thread_VolatileRead2 (void *ptr);
 226
 227 ICALL_EXPORT
 228 gint32 ves_icall_System_Threading_Thread_VolatileRead4 (void *ptr);
 229
 230 ICALL_EXPORT
 231 gint64 ves_icall_System_Threading_Thread_VolatileRead8 (void *ptr);
 232
 233 ICALL_EXPORT
 234 void * ves_icall_System_Threading_Thread_VolatileReadIntPtr (void *ptr);
 235
 236 ICALL_EXPORT
 237 void * ves_icall_System_Threading_Thread_VolatileReadObject (void *ptr);
 238
 239 ICALL_EXPORT
 240 double ves_icall_System_Threading_Thread_VolatileReadDouble (void *ptr);
 241
 242 ICALL_EXPORT
 243 float ves_icall_System_Threading_Thread_VolatileReadFloat (void *ptr);
 244
 245 ICALL_EXPORT
 246 void ves_icall_System_Threading_Thread_VolatileWrite1 (void *ptr, gint8);
 247
 248 ICALL_EXPORT
 249 void ves_icall_System_Threading_Thread_VolatileWrite2 (void *ptr, gint16);
 250
 251 ICALL_EXPORT
 252 void ves_icall_System_Threading_Thread_VolatileWrite4 (void *ptr, gint32);
 253
 254 ICALL_EXPORT
 255 void ves_icall_System_Threading_Thread_VolatileWrite8 (void *ptr, gint64);
 256
 257 ICALL_EXPORT
 258 void ves_icall_System_Threading_Thread_VolatileWriteIntPtr (void *ptr, void *);
 259
 260 ICALL_EXPORT
 261 void ves_icall_System_Threading_Thread_VolatileWriteObject (void *ptr, MonoObject *);
 262
 263 ICALL_EXPORT
 264 void ves_icall_System_Threading_Thread_VolatileWriteFloat (void *ptr, float);
 265
 266 ICALL_EXPORT
 267 void ves_icall_System_Threading_Thread_VolatileWriteDouble (void *ptr, double);
 268
 269 ICALL_EXPORT
 270 gint64 ves_icall_System_Threading_Volatile_Read8 (void *ptr);
 271
 272 ICALL_EXPORT
 273 guint64 ves_icall_System_Threading_Volatile_ReadU8 (void *ptr);
 274
 275 ICALL_EXPORT
 276 double ves_icall_System_Threading_Volatile_ReadDouble (void *ptr);
 277
 278 ICALL_EXPORT
 279 void ves_icall_System_Threading_Volatile_Write8 (void *ptr, gint64);
 280
 281 ICALL_EXPORT
 282 void ves_icall_System_Threading_Volatile_WriteU8 (void *ptr, guint64);
 283
 284 ICALL_EXPORT
 285 void ves_icall_System_Threading_Volatile_WriteDouble (void *ptr, double);
 286
 287 ICALL_EXPORT
 288 void ves_icall_System_Threading_Thread_MemoryBarrier (void);
 289
 290 void
 291 mono_threads_register_app_context (MonoAppContextHandle ctx, MonoError *error);
 292 void
 293 mono_threads_release_app_context (MonoAppContext* ctx, MonoError *error);
 294
 295 MONO_PROFILER_API MonoInternalThread *mono_thread_internal_current (void);
 296
 297 MonoInternalThreadHandle
 298 mono_thread_internal_current_handle (void);
 299
 300 void mono_thread_internal_abort (MonoInternalThread *thread, gboolean appdomain_unload);
 301 void mono_thread_internal_suspend_for_shutdown (MonoInternalThread *thread);
 302
 303 gboolean mono_thread_internal_has_appdomain_ref (MonoInternalThread *thread, MonoDomain *domain);
 304
 305 void mono_thread_internal_reset_abort (MonoInternalThread *thread);
 306
 307 void mono_thread_internal_unhandled_exception (MonoObject* exc);
 308
 309 void mono_alloc_special_static_data_free (GHashTable *special_static_fields);
 310 gboolean mono_thread_current_check_pending_interrupt (void);
 311
 312 void mono_thread_set_state (MonoInternalThread *thread, MonoThreadState state);
 313 void mono_thread_clr_state (MonoInternalThread *thread, MonoThreadState state);
 314 gboolean mono_thread_test_state (MonoInternalThread *thread, MonoThreadState test);
 315 gboolean mono_thread_test_and_set_state (MonoInternalThread *thread, MonoThreadState test, MonoThreadState set);
 316 void mono_thread_clear_and_set_state (MonoInternalThread *thread, MonoThreadState clear, MonoThreadState set);
 317
 318 void mono_thread_init_apartment_state (void);
 319 void mono_thread_cleanup_apartment_state (void);
 320
 321 void mono_threads_set_shutting_down (void);
 322
 323 MONO_API MonoException* mono_thread_get_undeniable_exception (void);
 324
 325 ICALL_EXPORT
 326 void ves_icall_thread_finish_async_abort (void);
 327
 328 #if HOST_WIN32
 329
 330 void
 331 mono_thread_set_name_windows (HANDLE thread_handle, PCWSTR thread_name);
 332
 333 #define MONO_THREAD_NAME_WINDOWS_CONSTANT(x) L ## x
 334
 335 #else
 336
 337 #define mono_thread_set_name_windows(thread_handle, thread_name) /* nothing */
 338
 339 #define MONO_THREAD_NAME_WINDOWS_CONSTANT(x) NULL
 340
 341 #endif
 342
 343 typedef enum {
 344     MonoSetThreadNameFlag_None      = 0x0000,
 345     MonoSetThreadNameFlag_Permanent = 0x0001,
 346     MonoSetThreadNameFlag_Reset     = 0x0002,
 347     //MonoSetThreadNameFlag_Constant  = 0x0004,
 348 } MonoSetThreadNameFlags;
 349
 350 G_ENUM_FUNCTIONS (MonoSetThreadNameFlags)
 351
 352 MONO_PROFILER_API
 353 void
 354 mono_thread_set_name_internal (MonoInternalThread *thread,
 355                                MonoString *name,
 356                                MonoSetThreadNameFlags flags, MonoError *error);
 357
 358 void mono_thread_suspend_all_other_threads (void);
 359 gboolean mono_threads_abort_appdomain_threads (MonoDomain *domain, int timeout);
 360
 361 void mono_thread_push_appdomain_ref (MonoDomain *domain);
 362 void mono_thread_pop_appdomain_ref (void);
 363 gboolean mono_thread_has_appdomain_ref (MonoThread *thread, MonoDomain *domain);
 364
 365 gboolean mono_thread_interruption_requested (void);
 366
 367 MonoException*
 368 mono_thread_interruption_checkpoint (void);
 369
 370 gboolean
 371 mono_thread_interruption_checkpoint_bool (void);
 372
 373 void
 374 mono_thread_interruption_checkpoint_void (void);
 375
 376 MonoExceptionHandle
 377 mono_thread_interruption_checkpoint_handle (void);
 378
 379 MonoException* mono_thread_force_interruption_checkpoint_noraise (void);
 380 gint32* mono_thread_interruption_request_flag (void);
 381
 382 uint32_t mono_alloc_special_static_data (uint32_t static_type, uint32_t size, uint32_t align, uintptr_t *bitmap, int numbits);
 383 void*    mono_get_special_static_data   (uint32_t offset);
 384 gpointer mono_get_special_static_data_for_thread (MonoInternalThread *thread, guint32 offset);
 385
 386 void
 387 mono_thread_resume_interruption (gboolean exec);
 388 void mono_threads_perform_thread_dump (void);
 389
 390 // FIXME Correct the type of func and remove the template.
 391 gboolean
 392 mono_thread_create_checked (MonoDomain *domain, gpointer func, gpointer arg, MonoError *error);
 393
 394 #ifdef __cplusplus
 395 template <typename T>
 396 inline gboolean
 397 mono_thread_create_checked (MonoDomain *domain, T func, gpointer arg, MonoError *error)
 398 {
 399         return mono_thread_create_checked (domain, (gpointer)func, arg, error);
 400 }
 401 #endif
 402
 403 void mono_threads_add_joinable_runtime_thread (MonoThreadInfo *thread_info);
 404 void mono_threads_add_joinable_thread (gpointer tid);
 405 void mono_threads_join_threads (void);
 406 void mono_thread_join (gpointer tid);
 407
 408 ICALL_EXPORT
 409 void ves_icall_System_Threading_Thread_GetStackTraces (MonoArray **out_threads, MonoArray **out_stack_traces);
 410
 411 MONO_API gpointer
 412 mono_threads_attach_coop (MonoDomain *domain, gpointer *dummy);
 413
 414 MONO_API void
 415 mono_threads_detach_coop (gpointer cookie, gpointer *dummy);
 416
 417 MonoDomain*
 418 mono_threads_attach_coop_internal (MonoDomain *domain, gpointer *cookie, MonoStackData *stackdata);
 419
 420 void
 421 mono_threads_detach_coop_internal (MonoDomain *orig_domain, gpointer cookie, MonoStackData *stackdata);
 422
 423 void mono_threads_begin_abort_protected_block (void);
 424 gboolean mono_threads_end_abort_protected_block (void);
 425
 426 gboolean
 427 mono_thread_internal_current_is_attached (void);
 428
 429 void
 430 mono_thread_internal_describe (MonoInternalThread *internal, GString *str);
 431
 432 gboolean
 433 mono_thread_internal_is_current (MonoInternalThread *internal);
 434
 435 gboolean
 436 mono_threads_is_current_thread_in_protected_block (void);
 437
 438 gboolean
 439 mono_threads_is_critical_method (MonoMethod *method);
 440
 441 gpointer
 442 mono_threads_enter_gc_unsafe_region_unbalanced_internal (MonoStackData *stackdata);
 443
 444 void
 445 mono_threads_exit_gc_unsafe_region_unbalanced_internal (gpointer cookie, MonoStackData *stackdata);
 446
 447 gpointer
 448 mono_threads_enter_gc_safe_region_unbalanced_internal (MonoStackData *stackdata);
 449
 450 void
 451 mono_threads_exit_gc_safe_region_unbalanced_internal (gpointer cookie, MonoStackData *stackdata);
 452
 453 // Set directory to store thread dumps captured by SIGQUIT
 454 void
 455 mono_set_thread_dump_dir(gchar* dir);
 456
 457 MONO_COLD void
 458 mono_set_pending_exception_handle (MonoExceptionHandle exc);
 459
 460 #define MONO_MAX_SUMMARY_NAME_LEN 140
 461 #define MONO_MAX_THREAD_NAME_LEN 140
 462 #define MONO_MAX_SUMMARY_THREADS 32
 463 #define MONO_MAX_SUMMARY_FRAMES 80
 464 #define MONO_MAX_SUMMARY_EXCEPTIONS 15
 465
 466 typedef struct {
 467         gboolean is_managed;
 468         char str_descr [MONO_MAX_SUMMARY_NAME_LEN];
 469         struct {
 470                 int token;
 471                 int il_offset;
 472                 int native_offset;
 473                 const char *guid;
 474
 475 #ifndef MONO_PRIVATE_CRASHES
 476                 // We use ifdef to make it a compile-time error to store this
 477                 // symbolicated string on release builds
 478                 const char *name;
 479 #endif
 480                 const char *filename;
 481                 guint32 image_size;
 482                 guint32 time_date_stamp;
 483         } managed_data;
 484         struct {
 485                 intptr_t ip;
 486                 gint32 offset;
 487                 const char *module;
 488                 gboolean is_trampoline;
 489                 gboolean has_name;
 490         } unmanaged_data;
 491 } MonoFrameSummary;
 492
 493 typedef struct {
 494         MonoClass *managed_exc_type;
 495
 496         int num_managed_frames;
 497         MonoFrameSummary managed_frames [MONO_MAX_SUMMARY_FRAMES];
 498 } MonoExcSummary;
 499
 500 typedef struct {
 501         guint64 offset_free_hash;
 502         guint64 offset_rich_hash;
 503 } MonoStackHash;
 504
 505 typedef struct {
 506         gboolean done; // Needed because cond wait can have spurious wakeups
 507         MonoSemType done_wait; // Readers are finished with this
 508
 509         // For managed stack walking
 510
 511         MonoDomain *domain;
 512         MonoJitTlsData *jit_tls;
 513         MonoLMF *lmf;
 514
 515         // Emitted attributes
 516
 517         gboolean is_managed;
 518
 519         char name [MONO_MAX_THREAD_NAME_LEN];
 520
 521         intptr_t info_addr;
 522         intptr_t native_thread_id;
 523
 524         // Print reason we don't have a complete
 525         // managed trace
 526         const char *error_msg;
 527
 528         int num_managed_frames;
 529         MonoFrameSummary managed_frames [MONO_MAX_SUMMARY_FRAMES];
 530
 531         int num_unmanaged_frames;
 532         MonoFrameSummary unmanaged_frames [MONO_MAX_SUMMARY_FRAMES];
 533
 534         int num_exceptions;
 535         MonoExcSummary exceptions [MONO_MAX_SUMMARY_EXCEPTIONS];
 536
 537         MonoStackHash hashes;
 538
 539         MonoContext *ctx;
 540         MonoContext ctx_mem;
 541 } MonoThreadSummary;
 542
 543 gboolean
 544 mono_threads_summarize (MonoContext *ctx, gchar **out, MonoStackHash *hashes, gboolean silent, gboolean signal_handler_controller, gchar *mem, size_t provided_size);
 545
 546 gboolean
 547 mono_threads_summarize_execute (MonoContext *ctx, gchar **out, MonoStackHash *hashes, gboolean silent, gchar *mem, size_t provided_size);
 548
 549 gboolean
 550 mono_threads_summarize_one (MonoThreadSummary *out, MonoContext *ctx);
 551
 552 #endif /* _MONO_METADATA_THREADS_TYPES_H_ */