[mono-threads] Assert that we do not try to signal the handle multiple times
[mono.git] / mono / utils / mono-counters.h
index f18212f90bfdc535588ad8cf1ec5d455fe04f60f..20be122e58288ccbd62cdcb25ab464080e9604d1 100644 (file)
@@ -5,6 +5,7 @@
 #include <mono/utils/mono-publib.h>
 
 enum {
+       /* Counter type, bits 0-7. */
        MONO_COUNTER_INT,    /* 32 bit int */
        MONO_COUNTER_UINT,    /* 32 bit uint */
        MONO_COUNTER_WORD,   /* pointer-sized int */
@@ -15,17 +16,40 @@ enum {
        MONO_COUNTER_TIME_INTERVAL, /* 64 bits signed int holding usecs. */
        MONO_COUNTER_TYPE_MASK = 0xf,
        MONO_COUNTER_CALLBACK = 128, /* ORed with the other values */
-       MONO_COUNTER_SECTION_MASK = 0xffffff00,
-       /* sections */
+       MONO_COUNTER_SECTION_MASK = 0x00ffff00,
+       /* Sections, bits 8-23 (16 bits) */
        MONO_COUNTER_JIT      = 1 << 8,
        MONO_COUNTER_GC       = 1 << 9,
        MONO_COUNTER_METADATA = 1 << 10,
        MONO_COUNTER_GENERICS = 1 << 11,
        MONO_COUNTER_SECURITY = 1 << 12,
-       MONO_COUNTER_LAST_SECTION
+       MONO_COUNTER_RUNTIME  = 1 << 13,
+       MONO_COUNTER_SYSTEM   = 1 << 14,
+       MONO_COUNTER_PERFCOUNTERS = 1 << 15,
+       MONO_COUNTER_PROFILER = 1 << 16,
+       MONO_COUNTER_LAST_SECTION,
+
+       /* Unit, bits 24-27 (4 bits) */
+       MONO_COUNTER_UNIT_SHIFT = 24,
+       MONO_COUNTER_UNIT_MASK = 0xFu << MONO_COUNTER_UNIT_SHIFT,
+       MONO_COUNTER_RAW        = 0 << 24,  /* Raw value */
+       MONO_COUNTER_BYTES      = 1 << 24, /* Quantity of bytes. RSS, active heap, etc */
+       MONO_COUNTER_TIME       = 2 << 24,  /* Time interval in 100ns units. Minor pause, JIT compilation*/
+       MONO_COUNTER_COUNT      = 3 << 24, /*  Number of things (threads, queued jobs) or Number of events triggered (Major collections, Compiled methods).*/
+       MONO_COUNTER_PERCENTAGE = 4 << 24, /* [0-1] Fraction Percentage of something. Load average. */
+
+       /* Monotonicity, bits 28-31 (4 bits) */
+       MONO_COUNTER_VARIANCE_SHIFT = 28,
+       MONO_COUNTER_VARIANCE_MASK = 0xFu << MONO_COUNTER_VARIANCE_SHIFT,
+       MONO_COUNTER_MONOTONIC      = 1 << 28, /* This counter value always increase/decreases over time. Reported by --stat. */
+       MONO_COUNTER_CONSTANT       = 1 << 29, /* Fixed value. Used by configuration data. */
+       MONO_COUNTER_VARIABLE       = 1 << 30, /* This counter value can be anything on each sampling. Only interesting when sampling. */
 };
 
+typedef struct _MonoCounter MonoCounter;
+
 MONO_API void mono_counters_enable (int section_mask);
+MONO_API void mono_counters_init (void);
 
 /* 
  * register addr as the address of a counter of type type.
@@ -33,6 +57,10 @@ MONO_API void mono_counters_enable (int section_mask);
  * the function should return the value and take no arguments.
  */
 MONO_API void mono_counters_register (const char* descr, int type, void *addr);
+MONO_API void mono_counters_register_with_size (const char *name, int type, void *addr, int size);
+
+typedef void (*MonoCounterRegisterCallback) (MonoCounter*);
+MONO_API void mono_counters_on_register (MonoCounterRegisterCallback callback);
 
 /* 
  * Create a readable dump of the counters for section_mask sections (ORed section values)
@@ -41,6 +69,19 @@ MONO_API void mono_counters_dump (int section_mask, FILE *outfile);
 
 MONO_API void mono_counters_cleanup (void);
 
+typedef mono_bool (*CountersEnumCallback) (MonoCounter *counter, void *user_data);
+
+MONO_API void mono_counters_foreach (CountersEnumCallback cb, void *user_data);
+
+MONO_API int mono_counters_sample (MonoCounter *counter, void *buffer, int buffer_size);
+
+MONO_API const char* mono_counter_get_name (MonoCounter *name);
+MONO_API int mono_counter_get_type (MonoCounter *counter);
+MONO_API int mono_counter_get_section (MonoCounter *counter);
+MONO_API int mono_counter_get_unit (MonoCounter *counter);
+MONO_API int mono_counter_get_variance (MonoCounter *counter);
+MONO_API size_t mono_counter_get_size (MonoCounter *counter);
+
 typedef enum {
        MONO_RESOURCE_JIT_CODE, /* bytes */
        MONO_RESOURCE_METADATA, /* bytes */