src/rrd.c

   1 #include "common.h"
   2
   3 #define RRD_DEFAULT_GAP_INTERPOLATIONS 1
   4
   5 // ----------------------------------------------------------------------------
   6 // globals
   7
   8 /*
   9 // if not zero it gives the time (in seconds) to remove un-updated dimensions
  10 // DO NOT ENABLE
  11 // if dimensions are removed, the chart generation will have to run again
  12 int rrd_delete_unupdated_dimensions = 0;
  13 */
  14
  15 int rrd_update_every = UPDATE_EVERY;
  16 int rrd_default_history_entries = RRD_DEFAULT_HISTORY_ENTRIES;
  17 int rrd_memory_mode = RRD_MEMORY_MODE_SAVE;
  18
  19 static int rrdset_compare(void* a, void* b);
  20 static int rrdset_compare_name(void* a, void* b);
  21 static int rrdfamily_compare(void *a, void *b);
  22
  23 // ----------------------------------------------------------------------------
  24 // RRDHOST
  25
  26 RRDHOST localhost = {
  27         .hostname = "localhost",
  28         .rrdset_root = NULL,
  29         .rrdset_root_rwlock = PTHREAD_RWLOCK_INITIALIZER,
  30         .rrdset_root_index = {
  31             { NULL, rrdset_compare },
  32             AVL_LOCK_INITIALIZER
  33         },
  34         .rrdset_root_index_name = {
  35             { NULL, rrdset_compare_name },
  36             AVL_LOCK_INITIALIZER
  37         },
  38         .rrdfamily_root_index = {
  39             { NULL, rrdfamily_compare },
  40             AVL_LOCK_INITIALIZER
  41         },
  42         .variables_root_index = {
  43             { NULL, rrdvar_compare },
  44             AVL_LOCK_INITIALIZER
  45         },
  46         .health_log = {
  47             .next_log_id = 1,
  48             .next_alarm_id = 1,
  49             .count = 0,
  50             .max = 1000,
  51             .alarms = NULL,
  52             .alarm_log_rwlock = PTHREAD_RWLOCK_INITIALIZER
  53         }
  54 };
  55
  56 void rrdhost_init(char *hostname) {
  57     localhost.hostname = hostname;
  58     localhost.health_log.next_log_id =
  59         localhost.health_log.next_alarm_id = now_realtime_sec();
  60 }
  61
  62 void rrdhost_rwlock(RRDHOST *host) {
  63     pthread_rwlock_wrlock(&host->rrdset_root_rwlock);
  64 }
  65
  66 void rrdhost_rdlock(RRDHOST *host) {
  67     pthread_rwlock_rdlock(&host->rrdset_root_rwlock);
  68 }
  69
  70 void rrdhost_unlock(RRDHOST *host) {
  71     pthread_rwlock_unlock(&host->rrdset_root_rwlock);
  72 }
  73
  74 void rrdhost_check_rdlock_int(RRDHOST *host, const char *file, const char *function, const unsigned long line) {
  75     int ret = pthread_rwlock_trywrlock(&host->rrdset_root_rwlock);
  76
  77     if(ret == 0)
  78         fatal("RRDHOST '%s' should be read-locked, but it is not, at function %s() at line %lu of file '%s'", host->hostname, function, line, file);
  79 }
  80
  81 void rrdhost_check_wrlock_int(RRDHOST *host, const char *file, const char *function, const unsigned long line) {
  82     int ret = pthread_rwlock_tryrdlock(&host->rrdset_root_rwlock);
  83
  84     if(ret == 0)
  85         fatal("RRDHOST '%s' should be write-locked, but it is not, at function %s() at line %lu of file '%s'", host->hostname, function, line, file);
  86 }
  87
  88 // ----------------------------------------------------------------------------
  89 // RRDFAMILY index
  90
  91 static int rrdfamily_compare(void *a, void *b) {
  92     if(((RRDFAMILY *)a)->hash_family < ((RRDFAMILY *)b)->hash_family) return -1;
  93     else if(((RRDFAMILY *)a)->hash_family > ((RRDFAMILY *)b)->hash_family) return 1;
  94     else return strcmp(((RRDFAMILY *)a)->family, ((RRDFAMILY *)b)->family);
  95 }
  96
  97 #define rrdfamily_index_add(host, rc) (RRDFAMILY *)avl_insert_lock(&((host)->rrdfamily_root_index), (avl *)(rc))
  98 #define rrdfamily_index_del(host, rc) (RRDFAMILY *)avl_remove_lock(&((host)->rrdfamily_root_index), (avl *)(rc))
  99
 100 static RRDFAMILY *rrdfamily_index_find(RRDHOST *host, const char *id, uint32_t hash) {
 101     RRDFAMILY tmp;
 102     tmp.family = id;
 103     tmp.hash_family = (hash)?hash:simple_hash(tmp.family);
 104
 105     return (RRDFAMILY *)avl_search_lock(&(host->rrdfamily_root_index), (avl *) &tmp);
 106 }
 107
 108 RRDFAMILY *rrdfamily_create(const char *id) {
 109     RRDFAMILY *rc = rrdfamily_index_find(&localhost, id, 0);
 110     if(!rc) {
 111         rc = callocz(1, sizeof(RRDFAMILY));
 112
 113         rc->family = strdupz(id);
 114         rc->hash_family = simple_hash(rc->family);
 115
 116         // initialize the variables index
 117         avl_init_lock(&rc->variables_root_index, rrdvar_compare);
 118
 119         RRDFAMILY *ret = rrdfamily_index_add(&localhost, rc);
 120         if(ret != rc)
 121             fatal("INTERNAL ERROR: Expected to INSERT RRDFAMILY '%s' into index, but inserted '%s'.", rc->family, (ret)?ret->family:"NONE");
 122     }
 123
 124     rc->use_count++;
 125     return rc;
 126 }
 127
 128 void rrdfamily_free(RRDFAMILY *rc) {
 129     rc->use_count--;
 130     if(!rc->use_count) {
 131         RRDFAMILY *ret = rrdfamily_index_del(&localhost, rc);
 132         if(ret != rc)
 133             fatal("INTERNAL ERROR: Expected to DELETE RRDFAMILY '%s' from index, but deleted '%s'.", rc->family, (ret)?ret->family:"NONE");
 134
 135         if(rc->variables_root_index.avl_tree.root != NULL)
 136             fatal("INTERNAL ERROR: Variables index of RRDFAMILY '%s' that is freed, is not empty.", rc->family);
 137
 138         freez((void *)rc->family);
 139         freez(rc);
 140     }
 141 }
 142
 143 // ----------------------------------------------------------------------------
 144 // RRDSET index
 145
 146 static int rrdset_compare(void* a, void* b) {
 147     if(((RRDSET *)a)->hash < ((RRDSET *)b)->hash) return -1;
 148     else if(((RRDSET *)a)->hash > ((RRDSET *)b)->hash) return 1;
 149     else return strcmp(((RRDSET *)a)->id, ((RRDSET *)b)->id);
 150 }
 151
 152 #define rrdset_index_add(host, st) (RRDSET *)avl_insert_lock(&((host)->rrdset_root_index), (avl *)(st))
 153 #define rrdset_index_del(host, st) (RRDSET *)avl_remove_lock(&((host)->rrdset_root_index), (avl *)(st))
 154
 155 static RRDSET *rrdset_index_find(RRDHOST *host, const char *id, uint32_t hash) {
 156     RRDSET tmp;
 157     strncpyz(tmp.id, id, RRD_ID_LENGTH_MAX);
 158     tmp.hash = (hash)?hash:simple_hash(tmp.id);
 159
 160     return (RRDSET *)avl_search_lock(&(host->rrdset_root_index), (avl *) &tmp);
 161 }
 162
 163 // ----------------------------------------------------------------------------
 164 // RRDSET name index
 165
 166 #define rrdset_from_avlname(avlname_ptr) ((RRDSET *)((avlname_ptr) - offsetof(RRDSET, avlname)))
 167
 168 static int rrdset_compare_name(void* a, void* b) {
 169     RRDSET *A = rrdset_from_avlname(a);
 170     RRDSET *B = rrdset_from_avlname(b);
 171
 172     // fprintf(stderr, "COMPARING: %s with %s\n", A->name, B->name);
 173
 174     if(A->hash_name < B->hash_name) return -1;
 175     else if(A->hash_name > B->hash_name) return 1;
 176     else return strcmp(A->name, B->name);
 177 }
 178
 179 RRDSET *rrdset_index_add_name(RRDHOST *host, RRDSET *st) {
 180     void *result;
 181     // fprintf(stderr, "ADDING: %s (name: %s)\n", st->id, st->name);
 182     result = avl_insert_lock(&host->rrdset_root_index_name, (avl *) (&st->avlname));
 183     if(result) return rrdset_from_avlname(result);
 184     return NULL;
 185 }
 186
 187 RRDSET *rrdset_index_del_name(RRDHOST *host, RRDSET *st) {
 188     void *result;
 189     // fprintf(stderr, "DELETING: %s (name: %s)\n", st->id, st->name);
 190     result = (RRDSET *)avl_remove_lock(&((host)->rrdset_root_index_name), (avl *)(&st->avlname));
 191     if(result) return rrdset_from_avlname(result);
 192     return NULL;
 193 }
 194
 195 static RRDSET *rrdset_index_find_name(RRDHOST *host, const char *name, uint32_t hash) {
 196     void *result = NULL;
 197     RRDSET tmp;
 198     tmp.name = name;
 199     tmp.hash_name = (hash)?hash:simple_hash(tmp.name);
 200
 201     // fprintf(stderr, "SEARCHING: %s\n", name);
 202     result = avl_search_lock(&host->rrdset_root_index_name, (avl *) (&(tmp.avlname)));
 203     if(result) {
 204         RRDSET *st = rrdset_from_avlname(result);
 205         if(strcmp(st->magic, RRDSET_MAGIC))
 206             error("Search for RRDSET %s returned an invalid RRDSET %s (name %s)", name, st->id, st->name);
 207
 208         // fprintf(stderr, "FOUND: %s\n", name);
 209         return rrdset_from_avlname(result);
 210     }
 211     // fprintf(stderr, "NOT FOUND: %s\n", name);
 212     return NULL;
 213 }
 214
 215
 216 // ----------------------------------------------------------------------------
 217 // RRDDIM index
 218
 219 static int rrddim_compare(void* a, void* b) {
 220     if(((RRDDIM *)a)->hash < ((RRDDIM *)b)->hash) return -1;
 221     else if(((RRDDIM *)a)->hash > ((RRDDIM *)b)->hash) return 1;
 222     else return strcmp(((RRDDIM *)a)->id, ((RRDDIM *)b)->id);
 223 }
 224
 225 #define rrddim_index_add(st, rd) avl_insert_lock(&((st)->dimensions_index), (avl *)(rd))
 226 #define rrddim_index_del(st,rd ) avl_remove_lock(&((st)->dimensions_index), (avl *)(rd))
 227
 228 static RRDDIM *rrddim_index_find(RRDSET *st, const char *id, uint32_t hash) {
 229     RRDDIM tmp;
 230     strncpyz(tmp.id, id, RRD_ID_LENGTH_MAX);
 231     tmp.hash = (hash)?hash:simple_hash(tmp.id);
 232
 233     return (RRDDIM *)avl_search_lock(&(st->dimensions_index), (avl *) &tmp);
 234 }
 235
 236 // ----------------------------------------------------------------------------
 237 // chart types
 238
 239 int rrdset_type_id(const char *name)
 240 {
 241     if(unlikely(strcmp(name, RRDSET_TYPE_AREA_NAME) == 0)) return RRDSET_TYPE_AREA;
 242     else if(unlikely(strcmp(name, RRDSET_TYPE_STACKED_NAME) == 0)) return RRDSET_TYPE_STACKED;
 243     else if(unlikely(strcmp(name, RRDSET_TYPE_LINE_NAME) == 0)) return RRDSET_TYPE_LINE;
 244     return RRDSET_TYPE_LINE;
 245 }
 246
 247 const char *rrdset_type_name(int chart_type)
 248 {
 249     static char line[] = RRDSET_TYPE_LINE_NAME;
 250     static char area[] = RRDSET_TYPE_AREA_NAME;
 251     static char stacked[] = RRDSET_TYPE_STACKED_NAME;
 252
 253     switch(chart_type) {
 254         case RRDSET_TYPE_LINE:
 255             return line;
 256
 257         case RRDSET_TYPE_AREA:
 258             return area;
 259
 260         case RRDSET_TYPE_STACKED:
 261             return stacked;
 262     }
 263     return line;
 264 }
 265
 266 // ----------------------------------------------------------------------------
 267 // load / save
 268
 269 const char *rrd_memory_mode_name(int id)
 270 {
 271     static const char ram[] = RRD_MEMORY_MODE_RAM_NAME;
 272     static const char map[] = RRD_MEMORY_MODE_MAP_NAME;
 273     static const char save[] = RRD_MEMORY_MODE_SAVE_NAME;
 274
 275     switch(id) {
 276         case RRD_MEMORY_MODE_RAM:
 277             return ram;
 278
 279         case RRD_MEMORY_MODE_MAP:
 280             return map;
 281
 282         case RRD_MEMORY_MODE_SAVE:
 283         default:
 284             return save;
 285     }
 286
 287     return save;
 288 }
 289
 290 int rrd_memory_mode_id(const char *name)
 291 {
 292     if(unlikely(!strcmp(name, RRD_MEMORY_MODE_RAM_NAME)))
 293         return RRD_MEMORY_MODE_RAM;
 294     else if(unlikely(!strcmp(name, RRD_MEMORY_MODE_MAP_NAME)))
 295         return RRD_MEMORY_MODE_MAP;
 296
 297     return RRD_MEMORY_MODE_SAVE;
 298 }
 299
 300 // ----------------------------------------------------------------------------
 301 // algorithms types
 302
 303 int rrddim_algorithm_id(const char *name)
 304 {
 305     if(strcmp(name, RRDDIM_INCREMENTAL_NAME) == 0)          return RRDDIM_INCREMENTAL;
 306     if(strcmp(name, RRDDIM_ABSOLUTE_NAME) == 0)             return RRDDIM_ABSOLUTE;
 307     if(strcmp(name, RRDDIM_PCENT_OVER_ROW_TOTAL_NAME) == 0)         return RRDDIM_PCENT_OVER_ROW_TOTAL;
 308     if(strcmp(name, RRDDIM_PCENT_OVER_DIFF_TOTAL_NAME) == 0)    return RRDDIM_PCENT_OVER_DIFF_TOTAL;
 309     return RRDDIM_ABSOLUTE;
 310 }
 311
 312 const char *rrddim_algorithm_name(int chart_type)
 313 {
 314     static char absolute[] = RRDDIM_ABSOLUTE_NAME;
 315     static char incremental[] = RRDDIM_INCREMENTAL_NAME;
 316     static char percentage_of_absolute_row[] = RRDDIM_PCENT_OVER_ROW_TOTAL_NAME;
 317     static char percentage_of_incremental_row[] = RRDDIM_PCENT_OVER_DIFF_TOTAL_NAME;
 318
 319     switch(chart_type) {
 320         case RRDDIM_ABSOLUTE:
 321             return absolute;
 322
 323         case RRDDIM_INCREMENTAL:
 324             return incremental;
 325
 326         case RRDDIM_PCENT_OVER_ROW_TOTAL:
 327             return percentage_of_absolute_row;
 328
 329         case RRDDIM_PCENT_OVER_DIFF_TOTAL:
 330             return percentage_of_incremental_row;
 331     }
 332     return absolute;
 333 }
 334
 335 // ----------------------------------------------------------------------------
 336 // chart names
 337
 338 char *rrdset_strncpyz_name(char *to, const char *from, size_t length)
 339 {
 340     char c, *p = to;
 341
 342     while (length-- && (c = *from++)) {
 343         if(c != '.' && !isalnum(c))
 344             c = '_';
 345
 346         *p++ = c;
 347     }
 348
 349     *p = '\0';
 350
 351     return to;
 352 }
 353
 354 void rrdset_set_name(RRDSET *st, const char *name)
 355 {
 356     if(unlikely(st->name && !strcmp(st->name, name)))
 357         return;
 358
 359     debug(D_RRD_CALLS, "rrdset_set_name() old: %s, new: %s", st->name, name);
 360
 361     char b[CONFIG_MAX_VALUE + 1];
 362     char n[RRD_ID_LENGTH_MAX + 1];
 363
 364     snprintfz(n, RRD_ID_LENGTH_MAX, "%s.%s", st->type, name);
 365     rrdset_strncpyz_name(b, n, CONFIG_MAX_VALUE);
 366
 367     if(st->name) {
 368         rrdset_index_del_name(&localhost, st);
 369         st->name = config_set_default(st->id, "name", b);
 370         st->hash_name = simple_hash(st->name);
 371         rrdsetvar_rename_all(st);
 372     }
 373     else {
 374         st->name = config_get(st->id, "name", b);
 375         st->hash_name = simple_hash(st->name);
 376     }
 377
 378     pthread_rwlock_wrlock(&st->rwlock);
 379     RRDDIM *rd;
 380     for(rd = st->dimensions; rd ;rd = rd->next)
 381         rrddimvar_rename_all(rd);
 382     pthread_rwlock_unlock(&st->rwlock);
 383
 384     rrdset_index_add_name(&localhost, st);
 385 }
 386
 387 // ----------------------------------------------------------------------------
 388 // cache directory
 389
 390 char *rrdset_cache_dir(const char *id)
 391 {
 392     char *ret = NULL;
 393
 394     static char *cache_dir = NULL;
 395     if(!cache_dir) {
 396         cache_dir = config_get("global", "cache directory", CACHE_DIR);
 397         int r = mkdir(cache_dir, 0755);
 398         if(r != 0 && errno != EEXIST)
 399             error("Cannot create directory '%s'", cache_dir);
 400     }
 401
 402     char b[FILENAME_MAX + 1];
 403     char n[FILENAME_MAX + 1];
 404     rrdset_strncpyz_name(b, id, FILENAME_MAX);
 405
 406     snprintfz(n, FILENAME_MAX, "%s/%s", cache_dir, b);
 407     ret = config_get(id, "cache directory", n);
 408
 409     if(rrd_memory_mode == RRD_MEMORY_MODE_MAP || rrd_memory_mode == RRD_MEMORY_MODE_SAVE) {
 410         int r = mkdir(ret, 0775);
 411         if(r != 0 && errno != EEXIST)
 412             error("Cannot create directory '%s'", ret);
 413     }
 414
 415     return ret;
 416 }
 417
 418 // ----------------------------------------------------------------------------
 419 // core functions
 420
 421 void rrdset_reset(RRDSET *st)
 422 {
 423     debug(D_RRD_CALLS, "rrdset_reset() %s", st->name);
 424
 425     st->last_collected_time.tv_sec = 0;
 426     st->last_collected_time.tv_usec = 0;
 427     st->last_updated.tv_sec = 0;
 428     st->last_updated.tv_usec = 0;
 429     st->current_entry = 0;
 430     st->counter = 0;
 431     st->counter_done = 0;
 432
 433     RRDDIM *rd;
 434     for(rd = st->dimensions; rd ; rd = rd->next) {
 435         rd->last_collected_time.tv_sec = 0;
 436         rd->last_collected_time.tv_usec = 0;
 437         rd->counter = 0;
 438         memset(rd->values, 0, rd->entries * sizeof(storage_number));
 439     }
 440 }
 441 static inline long align_entries_to_pagesize(long entries) {
 442     if(entries < 5) entries = 5;
 443     if(entries > RRD_HISTORY_ENTRIES_MAX) entries = RRD_HISTORY_ENTRIES_MAX;
 444
 445 #ifdef NETDATA_LOG_ALLOCATIONS
 446     long page = (size_t)sysconf(_SC_PAGESIZE);
 447
 448     long size = sizeof(RRDDIM) + entries * sizeof(storage_number);
 449     if(size % page) {
 450         size -= (size % page);
 451         size += page;
 452
 453         long n = (size - sizeof(RRDDIM)) / sizeof(storage_number);
 454         return n;
 455     }
 456
 457     return entries;
 458 #else
 459     return entries;
 460 #endif
 461 }
 462
 463 static inline void timeval_align(struct timeval *tv, int update_every) {
 464     tv->tv_sec -= tv->tv_sec % update_every;
 465     tv->tv_usec = 500000;
 466 }
 467
 468 RRDSET *rrdset_create(const char *type, const char *id, const char *name, const char *family, const char *context, const char *title, const char *units, long priority, int update_every, int chart_type)
 469 {
 470     if(!type || !type[0]) {
 471         fatal("Cannot create rrd stats without a type.");
 472         return NULL;
 473     }
 474
 475     if(!id || !id[0]) {
 476         fatal("Cannot create rrd stats without an id.");
 477         return NULL;
 478     }
 479
 480     char fullid[RRD_ID_LENGTH_MAX + 1];
 481     char fullfilename[FILENAME_MAX + 1];
 482
 483     snprintfz(fullid, RRD_ID_LENGTH_MAX, "%s.%s", type, id);
 484
 485     RRDSET *st = rrdset_find(fullid);
 486     if(st) {
 487         error("Cannot create rrd stats for '%s', it already exists.", fullid);
 488         return st;
 489     }
 490
 491     long rentries = config_get_number(fullid, "history", rrd_default_history_entries);
 492     long entries = align_entries_to_pagesize(rentries);
 493     if(entries != rentries) entries = config_set_number(fullid, "history", entries);
 494
 495     int enabled = config_get_boolean(fullid, "enabled", 1);
 496     if(!enabled) entries = 5;
 497
 498     unsigned long size = sizeof(RRDSET);
 499     char *cache_dir = rrdset_cache_dir(fullid);
 500
 501     debug(D_RRD_CALLS, "Creating RRD_STATS for '%s.%s'.", type, id);
 502
 503     snprintfz(fullfilename, FILENAME_MAX, "%s/main.db", cache_dir);
 504     if(rrd_memory_mode != RRD_MEMORY_MODE_RAM) st = (RRDSET *)mymmap(fullfilename, size, ((rrd_memory_mode == RRD_MEMORY_MODE_MAP)?MAP_SHARED:MAP_PRIVATE), 0);
 505     if(st) {
 506         if(strcmp(st->magic, RRDSET_MAGIC) != 0) {
 507             errno = 0;
 508             info("Initializing file %s.", fullfilename);
 509             memset(st, 0, size);
 510         }
 511         else if(strcmp(st->id, fullid) != 0) {
 512             errno = 0;
 513             error("File %s contents are not for chart %s. Clearing it.", fullfilename, fullid);
 514             // munmap(st, size);
 515             // st = NULL;
 516             memset(st, 0, size);
 517         }
 518         else if(st->memsize != size || st->entries != entries) {
 519             errno = 0;
 520             error("File %s does not have the desired size. Clearing it.", fullfilename);
 521             memset(st, 0, size);
 522         }
 523         else if(st->update_every != update_every) {
 524             errno = 0;
 525             error("File %s does not have the desired update frequency. Clearing it.", fullfilename);
 526             memset(st, 0, size);
 527         }
 528         else if((now_realtime_sec() - st->last_updated.tv_sec) > update_every * entries) {
 529             errno = 0;
 530             error("File %s is too old. Clearing it.", fullfilename);
 531             memset(st, 0, size);
 532         }
 533
 534         // make sure the database is aligned
 535         if(st->last_updated.tv_sec)
 536             timeval_align(&st->last_updated, update_every);
 537     }
 538
 539     if(st) {
 540         st->name = NULL;
 541         st->type = NULL;
 542         st->family = NULL;
 543         st->context = NULL;
 544         st->title = NULL;
 545         st->units = NULL;
 546         st->dimensions = NULL;
 547         st->next = NULL;
 548         st->mapped = rrd_memory_mode;
 549         st->variables = NULL;
 550         st->alarms = NULL;
 551         memset(&st->rwlock, 0, sizeof(pthread_rwlock_t));
 552         memset(&st->avl, 0, sizeof(avl));
 553         memset(&st->avlname, 0, sizeof(avl));
 554         memset(&st->variables_root_index, 0, sizeof(avl_tree_lock));
 555         memset(&st->dimensions_index, 0, sizeof(avl_tree_lock));
 556     }
 557     else {
 558         st = callocz(1, size);
 559         st->mapped = RRD_MEMORY_MODE_RAM;
 560     }
 561
 562     st->memsize = size;
 563     st->entries = entries;
 564     st->update_every = update_every;
 565
 566     if(st->current_entry >= st->entries) st->current_entry = 0;
 567
 568     strcpy(st->cache_filename, fullfilename);
 569     strcpy(st->magic, RRDSET_MAGIC);
 570
 571     strcpy(st->id, fullid);
 572     st->hash = simple_hash(st->id);
 573
 574     st->cache_dir = cache_dir;
 575
 576     st->chart_type = rrdset_type_id(config_get(st->id, "chart type", rrdset_type_name(chart_type)));
 577     st->type       = config_get(st->id, "type", type);
 578     st->family     = config_get(st->id, "family", family?family:st->type);
 579     st->units      = config_get(st->id, "units", units?units:"");
 580
 581     st->context    = config_get(st->id, "context", context?context:st->id);
 582     st->hash_context = simple_hash(st->context);
 583
 584     st->priority = config_get_number(st->id, "priority", priority);
 585     st->enabled = enabled;
 586
 587     st->isdetail = 0;
 588     st->debug = 0;
 589
 590     // if(!strcmp(st->id, "disk_util.dm-0")) {
 591     //     st->debug = 1;
 592     //     error("enabled debugging for '%s'", st->id);
 593     // }
 594     // else error("not enabled debugging for '%s'", st->id);
 595
 596     st->green = NAN;
 597     st->red = NAN;
 598
 599     st->last_collected_time.tv_sec = 0;
 600     st->last_collected_time.tv_usec = 0;
 601     st->counter_done = 0;
 602
 603     st->gap_when_lost_iterations_above = (int) (
 604             config_get_number(st->id, "gap when lost iterations above", RRD_DEFAULT_GAP_INTERPOLATIONS) + 2);
 605
 606     avl_init_lock(&st->dimensions_index, rrddim_compare);
 607     avl_init_lock(&st->variables_root_index, rrdvar_compare);
 608
 609     pthread_rwlock_init(&st->rwlock, NULL);
 610     rrdhost_rwlock(&localhost);
 611
 612     if(name && *name) rrdset_set_name(st, name);
 613     else rrdset_set_name(st, id);
 614
 615     {
 616         char varvalue[CONFIG_MAX_VALUE + 1];
 617         char varvalue2[CONFIG_MAX_VALUE + 1];
 618         snprintfz(varvalue, CONFIG_MAX_VALUE, "%s (%s)", title?title:"", st->name);
 619         json_escape_string(varvalue2, varvalue, sizeof(varvalue2));
 620         st->title = config_get(st->id, "title", varvalue2);
 621     }
 622
 623     st->rrdfamily = rrdfamily_create(st->family);
 624     st->rrdhost = &localhost;
 625
 626     st->next = localhost.rrdset_root;
 627     localhost.rrdset_root = st;
 628
 629     if(health_enabled) {
 630         rrdsetvar_create(st, "last_collected_t", RRDVAR_TYPE_TIME_T, &st->last_collected_time.tv_sec, 0);
 631         rrdsetvar_create(st, "collected_total_raw", RRDVAR_TYPE_TOTAL, &st->last_collected_total, 0);
 632         rrdsetvar_create(st, "green", RRDVAR_TYPE_CALCULATED, &st->green, 0);
 633         rrdsetvar_create(st, "red", RRDVAR_TYPE_CALCULATED, &st->red, 0);
 634         rrdsetvar_create(st, "update_every", RRDVAR_TYPE_INT, &st->update_every, 0);
 635     }
 636
 637     rrdset_index_add(&localhost, st);
 638
 639     rrdsetcalc_link_matching(st);
 640     rrdcalctemplate_link_matching(st);
 641
 642     rrdhost_unlock(&localhost);
 643
 644     return(st);
 645 }
 646
 647 RRDDIM *rrddim_add(RRDSET *st, const char *id, const char *name, long multiplier, long divisor, int algorithm)
 648 {
 649     char filename[FILENAME_MAX + 1];
 650     char fullfilename[FILENAME_MAX + 1];
 651
 652     char varname[CONFIG_MAX_NAME + 1];
 653     RRDDIM *rd = NULL;
 654     unsigned long size = sizeof(RRDDIM) + (st->entries * sizeof(storage_number));
 655
 656     debug(D_RRD_CALLS, "Adding dimension '%s/%s'.", st->id, id);
 657
 658     rrdset_strncpyz_name(filename, id, FILENAME_MAX);
 659     snprintfz(fullfilename, FILENAME_MAX, "%s/%s.db", st->cache_dir, filename);
 660     if(rrd_memory_mode != RRD_MEMORY_MODE_RAM) rd = (RRDDIM *)mymmap(fullfilename, size, ((rrd_memory_mode == RRD_MEMORY_MODE_MAP)?MAP_SHARED:MAP_PRIVATE), 1);
 661     if(rd) {
 662         struct timeval now;
 663         now_realtime_timeval(&now);
 664
 665         if(strcmp(rd->magic, RRDDIMENSION_MAGIC) != 0) {
 666             errno = 0;
 667             info("Initializing file %s.", fullfilename);
 668             memset(rd, 0, size);
 669         }
 670         else if(rd->memsize != size) {
 671             errno = 0;
 672             error("File %s does not have the desired size. Clearing it.", fullfilename);
 673             memset(rd, 0, size);
 674         }
 675         else if(rd->multiplier != multiplier) {
 676             errno = 0;
 677             error("File %s does not have the same multiplier. Clearing it.", fullfilename);
 678             memset(rd, 0, size);
 679         }
 680         else if(rd->divisor != divisor) {
 681             errno = 0;
 682             error("File %s does not have the same divisor. Clearing it.", fullfilename);
 683             memset(rd, 0, size);
 684         }
 685         else if(rd->algorithm != algorithm) {
 686             errno = 0;
 687             error("File %s does not have the same algorithm. Clearing it.", fullfilename);
 688             memset(rd, 0, size);
 689         }
 690         else if(rd->update_every != st->update_every) {
 691             errno = 0;
 692             error("File %s does not have the same refresh frequency. Clearing it.", fullfilename);
 693             memset(rd, 0, size);
 694         }
 695         else if(dt_usec(&now, &rd->last_collected_time) > (rd->entries * rd->update_every * USEC_PER_SEC)) {
 696             errno = 0;
 697             error("File %s is too old. Clearing it.", fullfilename);
 698             memset(rd, 0, size);
 699         }
 700         else if(strcmp(rd->id, id) != 0) {
 701             errno = 0;
 702             error("File %s contents are not for dimension %s. Clearing it.", fullfilename, id);
 703             // munmap(rd, size);
 704             // rd = NULL;
 705             memset(rd, 0, size);
 706         }
 707     }
 708
 709     if(rd) {
 710         // we have a file mapped for rd
 711         rd->mapped = rrd_memory_mode;
 712         rd->flags = 0x00000000;
 713         rd->variables = NULL;
 714         rd->next = NULL;
 715         rd->name = NULL;
 716         memset(&rd->avl, 0, sizeof(avl));
 717     }
 718     else {
 719         // if we didn't manage to get a mmap'd dimension, just create one
 720
 721         rd = callocz(1, size);
 722         rd->mapped = RRD_MEMORY_MODE_RAM;
 723     }
 724     rd->memsize = size;
 725
 726     strcpy(rd->magic, RRDDIMENSION_MAGIC);
 727     strcpy(rd->cache_filename, fullfilename);
 728     strncpyz(rd->id, id, RRD_ID_LENGTH_MAX);
 729     rd->hash = simple_hash(rd->id);
 730
 731     snprintfz(varname, CONFIG_MAX_NAME, "dim %s name", rd->id);
 732     rd->name = config_get(st->id, varname, (name && *name)?name:rd->id);
 733
 734     snprintfz(varname, CONFIG_MAX_NAME, "dim %s algorithm", rd->id);
 735     rd->algorithm = rrddim_algorithm_id(config_get(st->id, varname, rrddim_algorithm_name(algorithm)));
 736
 737     snprintfz(varname, CONFIG_MAX_NAME, "dim %s multiplier", rd->id);
 738     rd->multiplier = config_get_number(st->id, varname, multiplier);
 739
 740     snprintfz(varname, CONFIG_MAX_NAME, "dim %s divisor", rd->id);
 741     rd->divisor = config_get_number(st->id, varname, divisor);
 742     if(!rd->divisor) rd->divisor = 1;
 743
 744     rd->entries = st->entries;
 745     rd->update_every = st->update_every;
 746
 747     // prevent incremental calculation spikes
 748     rd->counter = 0;
 749     rd->updated = 0;
 750     rd->calculated_value = 0;
 751     rd->last_calculated_value = 0;
 752     rd->collected_value = 0;
 753     rd->last_collected_value = 0;
 754     rd->collected_volume = 0;
 755     rd->stored_volume = 0;
 756     rd->last_stored_value = 0;
 757     rd->values[st->current_entry] = pack_storage_number(0, SN_NOT_EXISTS);
 758     rd->last_collected_time.tv_sec = 0;
 759     rd->last_collected_time.tv_usec = 0;
 760     rd->rrdset = st;
 761
 762     // append this dimension
 763     pthread_rwlock_wrlock(&st->rwlock);
 764     if(!st->dimensions)
 765         st->dimensions = rd;
 766     else {
 767         RRDDIM *td = st->dimensions;
 768         for(; td->next; td = td->next) ;
 769         td->next = rd;
 770     }
 771
 772     if(health_enabled) {
 773         rrddimvar_create(rd, RRDVAR_TYPE_CALCULATED, NULL, NULL, &rd->last_stored_value, 0);
 774         rrddimvar_create(rd, RRDVAR_TYPE_COLLECTED, NULL, "_raw", &rd->last_collected_value, 0);
 775         rrddimvar_create(rd, RRDVAR_TYPE_TIME_T, NULL, "_last_collected_t", &rd->last_collected_time.tv_sec, 0);
 776     }
 777
 778     pthread_rwlock_unlock(&st->rwlock);
 779
 780     rrddim_index_add(st, rd);
 781
 782     return(rd);
 783 }
 784
 785 void rrddim_set_name(RRDSET *st, RRDDIM *rd, const char *name)
 786 {
 787     if(unlikely(rd->name && !strcmp(rd->name, name)))
 788         return;
 789
 790     debug(D_RRD_CALLS, "rrddim_set_name() from %s.%s to %s.%s", st->name, rd->name, st->name, name);
 791
 792     char varname[CONFIG_MAX_NAME + 1];
 793     snprintfz(varname, CONFIG_MAX_NAME, "dim %s name", rd->id);
 794     rd->name = config_set_default(st->id, varname, name);
 795
 796     rrddimvar_rename_all(rd);
 797 }
 798
 799 void rrddim_free(RRDSET *st, RRDDIM *rd)
 800 {
 801     debug(D_RRD_CALLS, "rrddim_free() %s.%s", st->name, rd->name);
 802
 803     if(rd == st->dimensions)
 804         st->dimensions = rd->next;
 805     else {
 806         RRDDIM *i;
 807         for (i = st->dimensions; i && i->next != rd; i = i->next) ;
 808
 809         if (i && i->next == rd)
 810             i->next = rd->next;
 811         else
 812             error("Request to free dimension '%s.%s' but it is not linked.", st->id, rd->name);
 813     }
 814     rd->next = NULL;
 815
 816     while(rd->variables)
 817         rrddimvar_free(rd->variables);
 818
 819     rrddim_index_del(st, rd);
 820
 821     // free(rd->annotations);
 822     if(rd->mapped == RRD_MEMORY_MODE_SAVE) {
 823         debug(D_RRD_CALLS, "Saving dimension '%s' to '%s'.", rd->name, rd->cache_filename);
 824         savememory(rd->cache_filename, rd, rd->memsize);
 825
 826         debug(D_RRD_CALLS, "Unmapping dimension '%s'.", rd->name);
 827         munmap(rd, rd->memsize);
 828     }
 829     else if(rd->mapped == RRD_MEMORY_MODE_MAP) {
 830         debug(D_RRD_CALLS, "Unmapping dimension '%s'.", rd->name);
 831         munmap(rd, rd->memsize);
 832     }
 833     else {
 834         debug(D_RRD_CALLS, "Removing dimension '%s'.", rd->name);
 835         freez(rd);
 836     }
 837 }
 838
 839 void rrdset_free_all(void)
 840 {
 841     info("Freeing all memory...");
 842
 843     rrdhost_rwlock(&localhost);
 844
 845     RRDSET *st;
 846     for(st = localhost.rrdset_root; st ;) {
 847         RRDSET *next = st->next;
 848
 849         pthread_rwlock_wrlock(&st->rwlock);
 850
 851         while(st->variables)
 852             rrdsetvar_free(st->variables);
 853
 854         while(st->alarms)
 855             rrdsetcalc_unlink(st->alarms);
 856
 857         while(st->dimensions)
 858             rrddim_free(st, st->dimensions);
 859
 860         rrdset_index_del(&localhost, st);
 861
 862         st->rrdfamily->use_count--;
 863         if(!st->rrdfamily->use_count)
 864             rrdfamily_free(st->rrdfamily);
 865
 866         pthread_rwlock_unlock(&st->rwlock);
 867
 868         if(st->mapped == RRD_MEMORY_MODE_SAVE) {
 869             debug(D_RRD_CALLS, "Saving stats '%s' to '%s'.", st->name, st->cache_filename);
 870             savememory(st->cache_filename, st, st->memsize);
 871
 872             debug(D_RRD_CALLS, "Unmapping stats '%s'.", st->name);
 873             munmap(st, st->memsize);
 874         }
 875         else if(st->mapped == RRD_MEMORY_MODE_MAP) {
 876             debug(D_RRD_CALLS, "Unmapping stats '%s'.", st->name);
 877             munmap(st, st->memsize);
 878         }
 879         else
 880             freez(st);
 881
 882         st = next;
 883     }
 884     localhost.rrdset_root = NULL;
 885
 886     rrdhost_unlock(&localhost);
 887
 888     info("Memory cleanup completed...");
 889 }
 890
 891 void rrdset_save_all(void) {
 892     info("Saving database...");
 893
 894     RRDSET *st;
 895     RRDDIM *rd;
 896
 897     rrdhost_rwlock(&localhost);
 898     for(st = localhost.rrdset_root; st ; st = st->next) {
 899         pthread_rwlock_wrlock(&st->rwlock);
 900
 901         if(st->mapped == RRD_MEMORY_MODE_SAVE) {
 902             debug(D_RRD_CALLS, "Saving stats '%s' to '%s'.", st->name, st->cache_filename);
 903             savememory(st->cache_filename, st, st->memsize);
 904         }
 905
 906         for(rd = st->dimensions; rd ; rd = rd->next) {
 907             if(likely(rd->mapped == RRD_MEMORY_MODE_SAVE)) {
 908                 debug(D_RRD_CALLS, "Saving dimension '%s' to '%s'.", rd->name, rd->cache_filename);
 909                 savememory(rd->cache_filename, rd, rd->memsize);
 910             }
 911         }
 912
 913         pthread_rwlock_unlock(&st->rwlock);
 914     }
 915     rrdhost_unlock(&localhost);
 916 }
 917
 918
 919 RRDSET *rrdset_find(const char *id)
 920 {
 921     debug(D_RRD_CALLS, "rrdset_find() for chart %s", id);
 922
 923     RRDSET *st = rrdset_index_find(&localhost, id, 0);
 924     return(st);
 925 }
 926
 927 RRDSET *rrdset_find_bytype(const char *type, const char *id)
 928 {
 929     debug(D_RRD_CALLS, "rrdset_find_bytype() for chart %s.%s", type, id);
 930
 931     char buf[RRD_ID_LENGTH_MAX + 1];
 932
 933     strncpyz(buf, type, RRD_ID_LENGTH_MAX - 1);
 934     strcat(buf, ".");
 935     int len = (int) strlen(buf);
 936     strncpyz(&buf[len], id, (size_t) (RRD_ID_LENGTH_MAX - len));
 937
 938     return(rrdset_find(buf));
 939 }
 940
 941 RRDSET *rrdset_find_byname(const char *name)
 942 {
 943     debug(D_RRD_CALLS, "rrdset_find_byname() for chart %s", name);
 944
 945     RRDSET *st = rrdset_index_find_name(&localhost, name, 0);
 946     return(st);
 947 }
 948
 949 RRDDIM *rrddim_find(RRDSET *st, const char *id)
 950 {
 951     debug(D_RRD_CALLS, "rrddim_find() for chart %s, dimension %s", st->name, id);
 952
 953     return rrddim_index_find(st, id, 0);
 954 }
 955
 956 int rrddim_hide(RRDSET *st, const char *id)
 957 {
 958     debug(D_RRD_CALLS, "rrddim_hide() for chart %s, dimension %s", st->name, id);
 959
 960     RRDDIM *rd = rrddim_find(st, id);
 961     if(unlikely(!rd)) {
 962         error("Cannot find dimension with id '%s' on stats '%s' (%s).", id, st->name, st->id);
 963         return 1;
 964     }
 965
 966     rd->flags |= RRDDIM_FLAG_HIDDEN;
 967     return 0;
 968 }
 969
 970 int rrddim_unhide(RRDSET *st, const char *id)
 971 {
 972     debug(D_RRD_CALLS, "rrddim_unhide() for chart %s, dimension %s", st->name, id);
 973
 974     RRDDIM *rd = rrddim_find(st, id);
 975     if(unlikely(!rd)) {
 976         error("Cannot find dimension with id '%s' on stats '%s' (%s).", id, st->name, st->id);
 977         return 1;
 978     }
 979
 980     if(rd->flags & RRDDIM_FLAG_HIDDEN) rd->flags ^= RRDDIM_FLAG_HIDDEN;
 981     return 0;
 982 }
 983
 984 collected_number rrddim_set_by_pointer(RRDSET *st, RRDDIM *rd, collected_number value)
 985 {
 986     debug(D_RRD_CALLS, "rrddim_set_by_pointer() for chart %s, dimension %s, value " COLLECTED_NUMBER_FORMAT, st->name, rd->name, value);
 987
 988     now_realtime_timeval(&rd->last_collected_time);
 989     rd->collected_value = value;
 990     rd->updated = 1;
 991     rd->counter++;
 992
 993     // fprintf(stderr, "%s.%s %llu " COLLECTED_NUMBER_FORMAT " dt %0.6f" " rate " CALCULATED_NUMBER_FORMAT "\n", st->name, rd->name, st->usec_since_last_update, value, (float)((double)st->usec_since_last_update / (double)1000000), (calculated_number)((value - rd->last_collected_value) * (calculated_number)rd->multiplier / (calculated_number)rd->divisor * 1000000.0 / (calculated_number)st->usec_since_last_update));
 994
 995     return rd->last_collected_value;
 996 }
 997
 998 collected_number rrddim_set(RRDSET *st, const char *id, collected_number value)
 999 {
1000     RRDDIM *rd = rrddim_find(st, id);
1001     if(unlikely(!rd)) {
1002         error("Cannot find dimension with id '%s' on stats '%s' (%s).", id, st->name, st->id);
1003         return 0;
1004     }
1005
1006     return rrddim_set_by_pointer(st, rd, value);
1007 }
1008
1009 void rrdset_next_usec_unfiltered(RRDSET *st, usec_t microseconds)
1010 {
1011     if(unlikely(!st->last_collected_time.tv_sec || !microseconds)) {
1012         // the first entry
1013         microseconds = st->update_every * USEC_PER_SEC;
1014     }
1015     st->usec_since_last_update = microseconds;
1016 }
1017
1018 void rrdset_next_usec(RRDSET *st, usec_t microseconds)
1019 {
1020     struct timeval now;
1021     now_realtime_timeval(&now);
1022
1023     if(unlikely(!st->last_collected_time.tv_sec)) {
1024         // the first entry
1025         microseconds = st->update_every * USEC_PER_SEC;
1026     }
1027     else if(unlikely(!microseconds)) {
1028         // no dt given by the plugin
1029         microseconds = dt_usec(&now, &st->last_collected_time);
1030     }
1031     else {
1032         // microseconds has the time since the last collection
1033         usec_t now_usec = timeval_usec(&now);
1034         usec_t last_usec = timeval_usec(&st->last_collected_time);
1035         usec_t since_last_usec = dt_usec(&now, &st->last_collected_time);
1036
1037         // verify the microseconds given is good
1038         if(unlikely(microseconds > since_last_usec)) {
1039             debug(D_RRD_CALLS, "dt %llu usec given is too big - it leads %llu usec to the future, for chart '%s' (%s).", microseconds, microseconds - since_last_usec, st->name, st->id);
1040
1041 #ifdef NETDATA_INTERNAL_CHECKS
1042             if(unlikely(last_usec + microseconds > now_usec + 1000))
1043                 error("dt %llu usec given is too big - it leads %llu usec to the future, for chart '%s' (%s).", microseconds, microseconds - since_last_usec, st->name, st->id);
1044 #endif
1045
1046             microseconds = since_last_usec;
1047         }
1048         else if(unlikely(microseconds < since_last_usec * 0.8)) {
1049             debug(D_RRD_CALLS, "dt %llu usec given is too small - expected %llu usec up to -20%%, for chart '%s' (%s).", microseconds, since_last_usec, st->name, st->id);
1050
1051 #ifdef NETDATA_INTERNAL_CHECKS
1052             error("dt %llu usec given is too small - expected %llu usec up to -20%%, for chart '%s' (%s).", microseconds, since_last_usec, st->name, st->id);
1053 #endif
1054             microseconds = since_last_usec;
1055         }
1056     }
1057     debug(D_RRD_CALLS, "rrdset_next_usec() for chart %s with microseconds %llu", st->name, microseconds);
1058
1059     if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: NEXT: %llu microseconds", st->name, microseconds);
1060     st->usec_since_last_update = microseconds;
1061 }
1062
1063 usec_t rrdset_done(RRDSET *st)
1064 {
1065     if(unlikely(netdata_exit)) return 0;
1066
1067     debug(D_RRD_CALLS, "rrdset_done() for chart %s", st->name);
1068
1069     RRDDIM *rd;
1070
1071     int
1072         pthreadoldcancelstate;  // store the old cancelable pthread state, to restore it at the end
1073
1074     char
1075         store_this_entry = 1,   // boolean: 1 = store this entry, 0 = don't store this entry
1076         first_entry = 0;        // boolean: 1 = this is the first entry seen for this chart, 0 = all other entries
1077
1078     unsigned int
1079         stored_entries = 0;     // the number of entries we have stored in the db, during this call to rrdset_done()
1080
1081     usec_t
1082         last_collect_ut,        // the timestamp in microseconds, of the last collected value
1083         now_collect_ut,         // the timestamp in microseconds, of this collected value (this is NOW)
1084         last_stored_ut,         // the timestamp in microseconds, of the last stored entry in the db
1085         next_store_ut,          // the timestamp in microseconds, of the next entry to store in the db
1086         update_every_ut = st->update_every * USEC_PER_SEC; // st->update_every in microseconds
1087
1088     if(unlikely(pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, &pthreadoldcancelstate) != 0))
1089         error("Cannot set pthread cancel state to DISABLE.");
1090
1091     // a read lock is OK here
1092     pthread_rwlock_rdlock(&st->rwlock);
1093
1094 /*
1095     // enable the chart, if it was disabled
1096     if(unlikely(rrd_delete_unupdated_dimensions) && !st->enabled)
1097         st->enabled = 1;
1098 */
1099
1100     // check if the chart has a long time to be updated
1101     if(unlikely(st->usec_since_last_update > st->entries * update_every_ut)) {
1102         info("%s: took too long to be updated (%0.3Lf secs). Resetting it.", st->name, (long double)(st->usec_since_last_update / 1000000.0));
1103         rrdset_reset(st);
1104         st->usec_since_last_update = update_every_ut;
1105         first_entry = 1;
1106     }
1107     if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: microseconds since last update: %llu", st->name, st->usec_since_last_update);
1108
1109     // set last_collected_time
1110     if(unlikely(!st->last_collected_time.tv_sec)) {
1111         // it is the first entry
1112         // set the last_collected_time to now
1113         now_realtime_timeval(&st->last_collected_time);
1114         timeval_align(&st->last_collected_time, st->update_every);
1115
1116         last_collect_ut = st->last_collected_time.tv_sec * USEC_PER_SEC + st->last_collected_time.tv_usec - update_every_ut;
1117
1118         // the first entry should not be stored
1119         store_this_entry = 0;
1120         first_entry = 1;
1121
1122         if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: has not set last_collected_time. Setting it now. Will not store the next entry.", st->name);
1123     }
1124     else {
1125         // it is not the first entry
1126         // calculate the proper last_collected_time, using usec_since_last_update
1127         last_collect_ut = st->last_collected_time.tv_sec * USEC_PER_SEC + st->last_collected_time.tv_usec;
1128         usec_t ut = last_collect_ut + st->usec_since_last_update;
1129         st->last_collected_time.tv_sec = (time_t) (ut / USEC_PER_SEC);
1130         st->last_collected_time.tv_usec = (suseconds_t) (ut % USEC_PER_SEC);
1131     }
1132
1133     // if this set has not been updated in the past
1134     // we fake the last_update time to be = now - usec_since_last_update
1135     if(unlikely(!st->last_updated.tv_sec)) {
1136         // it has never been updated before
1137         // set a fake last_updated, in the past using usec_since_last_update
1138         usec_t ut = st->last_collected_time.tv_sec * USEC_PER_SEC + st->last_collected_time.tv_usec - st->usec_since_last_update;
1139         st->last_updated.tv_sec = (time_t) (ut / USEC_PER_SEC);
1140         st->last_updated.tv_usec = (suseconds_t) (ut % USEC_PER_SEC);
1141
1142         // the first entry should not be stored
1143         store_this_entry = 0;
1144         first_entry = 1;
1145
1146         if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: initializing last_updated to now - %llu microseconds (%0.3Lf). Will not store the next entry.", st->name, st->usec_since_last_update, (long double)ut/1000000.0);
1147     }
1148
1149     // check if we will re-write the entire data set
1150     if(unlikely(dt_usec(&st->last_collected_time, &st->last_updated) > st->entries * update_every_ut)) {
1151         info("%s: too old data (last updated at %ld.%ld, last collected at %ld.%ld). Resetting it. Will not store the next entry.", st->name, st->last_updated.tv_sec, st->last_updated.tv_usec, st->last_collected_time.tv_sec, st->last_collected_time.tv_usec);
1152         rrdset_reset(st);
1153
1154         st->usec_since_last_update = update_every_ut;
1155
1156         now_realtime_timeval(&st->last_collected_time);
1157         timeval_align(&st->last_collected_time, st->update_every);
1158
1159         usec_t ut = st->last_collected_time.tv_sec * USEC_PER_SEC + st->last_collected_time.tv_usec - st->usec_since_last_update;
1160         st->last_updated.tv_sec = (time_t) (ut / USEC_PER_SEC);
1161         st->last_updated.tv_usec = (suseconds_t) (ut % USEC_PER_SEC);
1162
1163         // the first entry should not be stored
1164         store_this_entry = 0;
1165         first_entry = 1;
1166     }
1167
1168     // these are the 3 variables that will help us in interpolation
1169     // last_stored_ut = the last time we added a value to the storage
1170     // now_collect_ut = the time the current value has been collected
1171     // next_store_ut  = the time of the next interpolation point
1172     last_stored_ut = st->last_updated.tv_sec * USEC_PER_SEC + st->last_updated.tv_usec;
1173     now_collect_ut = st->last_collected_time.tv_sec * USEC_PER_SEC + st->last_collected_time.tv_usec;
1174     next_store_ut  = (st->last_updated.tv_sec + st->update_every) * USEC_PER_SEC;
1175
1176     if(unlikely(st->debug)) {
1177         debug(D_RRD_STATS, "%s: last_collect_ut = %0.3Lf (last collection time)", st->name, (long double)last_collect_ut/1000000.0);
1178         debug(D_RRD_STATS, "%s: now_collect_ut  = %0.3Lf (current collection time)", st->name, (long double)now_collect_ut/1000000.0);
1179         debug(D_RRD_STATS, "%s: last_stored_ut  = %0.3Lf (last updated time)", st->name, (long double)last_stored_ut/1000000.0);
1180         debug(D_RRD_STATS, "%s: next_store_ut   = %0.3Lf (next interpolation point)", st->name, (long double)next_store_ut/1000000.0);
1181     }
1182
1183     if(unlikely(!st->counter_done)) {
1184         store_this_entry = 0;
1185         if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: Will not store the next entry.", st->name);
1186     }
1187     st->counter_done++;
1188
1189     // calculate totals and count the dimensions
1190     int dimensions;
1191     st->collected_total = 0;
1192     for( rd = st->dimensions, dimensions = 0 ; rd ; rd = rd->next, dimensions++ )
1193         if(likely(rd->updated)) st->collected_total += rd->collected_value;
1194
1195     uint32_t storage_flags = SN_EXISTS;
1196
1197     // process all dimensions to calculate their values
1198     // based on the collected figures only
1199     // at this stage we do not interpolate anything
1200     for( rd = st->dimensions ; rd ; rd = rd->next ) {
1201
1202         if(unlikely(!rd->updated)) {
1203             rd->calculated_value = 0;
1204             continue;
1205         }
1206
1207         if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: START "
1208             " last_collected_value = " COLLECTED_NUMBER_FORMAT
1209             " collected_value = " COLLECTED_NUMBER_FORMAT
1210             " last_calculated_value = " CALCULATED_NUMBER_FORMAT
1211             " calculated_value = " CALCULATED_NUMBER_FORMAT
1212             , st->id, rd->name
1213             , rd->last_collected_value
1214             , rd->collected_value
1215             , rd->last_calculated_value
1216             , rd->calculated_value
1217             );
1218
1219         switch(rd->algorithm) {
1220             case RRDDIM_ABSOLUTE:
1221                 rd->calculated_value = (calculated_number)rd->collected_value
1222                     * (calculated_number)rd->multiplier
1223                     / (calculated_number)rd->divisor;
1224
1225                 if(unlikely(st->debug))
1226                     debug(D_RRD_STATS, "%s/%s: CALC ABS/ABS-NO-IN "
1227                         CALCULATED_NUMBER_FORMAT " = "
1228                         COLLECTED_NUMBER_FORMAT
1229                         " * " CALCULATED_NUMBER_FORMAT
1230                         " / " CALCULATED_NUMBER_FORMAT
1231                         , st->id, rd->name
1232                         , rd->calculated_value
1233                         , rd->collected_value
1234                         , (calculated_number)rd->multiplier
1235                         , (calculated_number)rd->divisor
1236                         );
1237                 break;
1238
1239             case RRDDIM_PCENT_OVER_ROW_TOTAL:
1240                 if(unlikely(!st->collected_total))
1241                     rd->calculated_value = 0;
1242                 else
1243                     // the percentage of the current value
1244                     // over the total of all dimensions
1245                     rd->calculated_value =
1246                           (calculated_number)100
1247                         * (calculated_number)rd->collected_value
1248                         / (calculated_number)st->collected_total;
1249
1250                 if(unlikely(st->debug))
1251                     debug(D_RRD_STATS, "%s/%s: CALC PCENT-ROW "
1252                         CALCULATED_NUMBER_FORMAT " = 100"
1253                         " * " COLLECTED_NUMBER_FORMAT
1254                         " / " COLLECTED_NUMBER_FORMAT
1255                         , st->id, rd->name
1256                         , rd->calculated_value
1257                         , rd->collected_value
1258                         , st->collected_total
1259                         );
1260                 break;
1261
1262             case RRDDIM_INCREMENTAL:
1263                 if(unlikely(rd->counter <= 1)) {
1264                     rd->calculated_value = 0;
1265                     continue;
1266                 }
1267
1268                 // if the new is smaller than the old (an overflow, or reset), set the old equal to the new
1269                 // to reset the calculation (it will give zero as the calculation for this second)
1270                 if(unlikely(rd->last_collected_value > rd->collected_value)) {
1271                     debug(D_RRD_STATS, "%s.%s: RESET or OVERFLOW. Last collected value = " COLLECTED_NUMBER_FORMAT ", current = " COLLECTED_NUMBER_FORMAT
1272                             , st->name, rd->name
1273                             , rd->last_collected_value
1274                             , rd->collected_value);
1275                     if(!(rd->flags & RRDDIM_FLAG_DONT_DETECT_RESETS_OR_OVERFLOWS)) storage_flags = SN_EXISTS_RESET;
1276                     rd->last_collected_value = rd->collected_value;
1277                 }
1278
1279                 rd->calculated_value +=
1280                       (calculated_number)(rd->collected_value - rd->last_collected_value)
1281                     * (calculated_number)rd->multiplier
1282                     / (calculated_number)rd->divisor;
1283
1284                 if(unlikely(st->debug))
1285                     debug(D_RRD_STATS, "%s/%s: CALC INC PRE "
1286                         CALCULATED_NUMBER_FORMAT " = ("
1287                         COLLECTED_NUMBER_FORMAT " - " COLLECTED_NUMBER_FORMAT
1288                         ")"
1289                         " * " CALCULATED_NUMBER_FORMAT
1290                         " / " CALCULATED_NUMBER_FORMAT
1291                         , st->id, rd->name
1292                         , rd->calculated_value
1293                         , rd->collected_value, rd->last_collected_value
1294                         , (calculated_number)rd->multiplier
1295                         , (calculated_number)rd->divisor
1296                         );
1297                 break;
1298
1299             case RRDDIM_PCENT_OVER_DIFF_TOTAL:
1300                 if(unlikely(rd->counter <= 1)) {
1301                     rd->calculated_value = 0;
1302                     continue;
1303                 }
1304
1305                 // if the new is smaller than the old (an overflow, or reset), set the old equal to the new
1306                 // to reset the calculation (it will give zero as the calculation for this second)
1307                 if(unlikely(rd->last_collected_value > rd->collected_value)) {
1308                     debug(D_RRD_STATS, "%s.%s: RESET or OVERFLOW. Last collected value = " COLLECTED_NUMBER_FORMAT ", current = " COLLECTED_NUMBER_FORMAT
1309                     , st->name, rd->name
1310                     , rd->last_collected_value
1311                     , rd->collected_value);
1312                     if(!(rd->flags & RRDDIM_FLAG_DONT_DETECT_RESETS_OR_OVERFLOWS)) storage_flags = SN_EXISTS_RESET;
1313                     rd->last_collected_value = rd->collected_value;
1314                 }
1315
1316                 // the percentage of the current increment
1317                 // over the increment of all dimensions together
1318                 if(unlikely(st->collected_total == st->last_collected_total))
1319                     rd->calculated_value = 0;
1320                 else
1321                     rd->calculated_value =
1322                           (calculated_number)100
1323                         * (calculated_number)(rd->collected_value - rd->last_collected_value)
1324                         / (calculated_number)(st->collected_total - st->last_collected_total);
1325
1326                 if(unlikely(st->debug))
1327                     debug(D_RRD_STATS, "%s/%s: CALC PCENT-DIFF "
1328                         CALCULATED_NUMBER_FORMAT " = 100"
1329                         " * (" COLLECTED_NUMBER_FORMAT " - " COLLECTED_NUMBER_FORMAT ")"
1330                         " / (" COLLECTED_NUMBER_FORMAT " - " COLLECTED_NUMBER_FORMAT ")"
1331                         , st->id, rd->name
1332                         , rd->calculated_value
1333                         , rd->collected_value, rd->last_collected_value
1334                         , st->collected_total, st->last_collected_total
1335                         );
1336                 break;
1337
1338             default:
1339                 // make the default zero, to make sure
1340                 // it gets noticed when we add new types
1341                 rd->calculated_value = 0;
1342
1343                 if(unlikely(st->debug))
1344                     debug(D_RRD_STATS, "%s/%s: CALC "
1345                         CALCULATED_NUMBER_FORMAT " = 0"
1346                         , st->id, rd->name
1347                         , rd->calculated_value
1348                         );
1349                 break;
1350         }
1351
1352         if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: PHASE2 "
1353             " last_collected_value = " COLLECTED_NUMBER_FORMAT
1354             " collected_value = " COLLECTED_NUMBER_FORMAT
1355             " last_calculated_value = " CALCULATED_NUMBER_FORMAT
1356             " calculated_value = " CALCULATED_NUMBER_FORMAT
1357             , st->id, rd->name
1358             , rd->last_collected_value
1359             , rd->collected_value
1360             , rd->last_calculated_value
1361             , rd->calculated_value
1362             );
1363
1364     }
1365
1366     // at this point we have all the calculated values ready
1367     // it is now time to interpolate values on a second boundary
1368
1369     if(unlikely(now_collect_ut < next_store_ut)) {
1370         // this is collected in the same interpolation point
1371         if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: THIS IS IN THE SAME INTERPOLATION POINT", st->name);
1372 #ifdef NETDATA_INTERNAL_CHECKS
1373         info("%s is collected in the same interpolation point: short by %llu microseconds", st->name, next_store_ut - now_collect_ut);
1374 #endif
1375     }
1376
1377     usec_t first_ut = last_stored_ut;
1378     long long iterations = (now_collect_ut - last_stored_ut) / (update_every_ut);
1379     if((now_collect_ut % (update_every_ut)) == 0) iterations++;
1380
1381     for( ; next_store_ut <= now_collect_ut ; last_collect_ut = next_store_ut, next_store_ut += update_every_ut, iterations-- ) {
1382 #ifdef NETDATA_INTERNAL_CHECKS
1383         if(iterations < 0) { error("%s: iterations calculation wrapped! first_ut = %llu, last_stored_ut = %llu, next_store_ut = %llu, now_collect_ut = %llu", st->name, first_ut, last_stored_ut, next_store_ut, now_collect_ut); }
1384 #endif
1385
1386         if(unlikely(st->debug)) {
1387             debug(D_RRD_STATS, "%s: last_stored_ut = %0.3Lf (last updated time)", st->name, (long double)last_stored_ut/1000000.0);
1388             debug(D_RRD_STATS, "%s: next_store_ut  = %0.3Lf (next interpolation point)", st->name, (long double)next_store_ut/1000000.0);
1389         }
1390
1391         st->last_updated.tv_sec = (time_t) (next_store_ut / USEC_PER_SEC);
1392         st->last_updated.tv_usec = 0;
1393
1394         for( rd = st->dimensions ; likely(rd) ; rd = rd->next ) {
1395             calculated_number new_value;
1396
1397             switch(rd->algorithm) {
1398                 case RRDDIM_INCREMENTAL:
1399                     new_value = (calculated_number)
1400                         (      rd->calculated_value
1401                             * (calculated_number)(next_store_ut - last_collect_ut)
1402                             / (calculated_number)(now_collect_ut - last_collect_ut)
1403                         );
1404
1405                     if(unlikely(st->debug))
1406                         debug(D_RRD_STATS, "%s/%s: CALC2 INC "
1407                             CALCULATED_NUMBER_FORMAT " = "
1408                             CALCULATED_NUMBER_FORMAT
1409                             " * %llu"
1410                             " / %llu"
1411                             , st->id, rd->name
1412                             , new_value
1413                             , rd->calculated_value
1414                             , (next_store_ut - last_stored_ut)
1415                             , (now_collect_ut - last_stored_ut)
1416                             );
1417
1418                     rd->calculated_value -= new_value;
1419                     new_value += rd->last_calculated_value;
1420                     rd->last_calculated_value = 0;
1421                     new_value /= (calculated_number)st->update_every;
1422
1423                     if(unlikely(next_store_ut - last_stored_ut < update_every_ut)) {
1424                         if(unlikely(st->debug))
1425                             debug(D_RRD_STATS, "%s/%s: COLLECTION POINT IS SHORT " CALCULATED_NUMBER_FORMAT " - EXTRAPOLATING",
1426                                 st->id, rd->name
1427                                 , (calculated_number)(next_store_ut - last_stored_ut)
1428                                 );
1429                         new_value = new_value * (calculated_number)(st->update_every * 1000000) / (calculated_number)(next_store_ut - last_stored_ut);
1430                     }
1431                     break;
1432
1433                 case RRDDIM_ABSOLUTE:
1434                 case RRDDIM_PCENT_OVER_ROW_TOTAL:
1435                 case RRDDIM_PCENT_OVER_DIFF_TOTAL:
1436                 default:
1437                     if(iterations == 1) {
1438                         // this is the last iteration
1439                         // do not interpolate
1440                         // just show the calculated value
1441
1442                         new_value = rd->calculated_value;
1443                     }
1444                     else {
1445                         // we have missed an update
1446                         // interpolate in the middle values
1447
1448                         new_value = (calculated_number)
1449                             (   (     (rd->calculated_value - rd->last_calculated_value)
1450                                     * (calculated_number)(next_store_ut - last_collect_ut)
1451                                     / (calculated_number)(now_collect_ut - last_collect_ut)
1452                                 )
1453                                 +  rd->last_calculated_value
1454                             );
1455
1456                         if(unlikely(st->debug))
1457                             debug(D_RRD_STATS, "%s/%s: CALC2 DEF "
1458                                 CALCULATED_NUMBER_FORMAT " = ((("
1459                                 "(" CALCULATED_NUMBER_FORMAT " - " CALCULATED_NUMBER_FORMAT ")"
1460                                 " * %llu"
1461                                 " / %llu) + " CALCULATED_NUMBER_FORMAT
1462                                 , st->id, rd->name
1463                                 , new_value
1464                                 , rd->calculated_value, rd->last_calculated_value
1465                                 , (next_store_ut - first_ut)
1466                                 , (now_collect_ut - first_ut), rd->last_calculated_value
1467                                 );
1468                     }
1469                     break;
1470             }
1471
1472             if(unlikely(!store_this_entry)) {
1473                 rd->values[st->current_entry] = pack_storage_number(0, SN_NOT_EXISTS);
1474                 continue;
1475             }
1476
1477             if(likely(rd->updated && rd->counter > 1 && iterations < st->gap_when_lost_iterations_above)) {
1478                 rd->values[st->current_entry] = pack_storage_number(new_value, storage_flags );
1479                 rd->last_stored_value = new_value;
1480
1481                 if(unlikely(st->debug))
1482                     debug(D_RRD_STATS, "%s/%s: STORE[%ld] "
1483                         CALCULATED_NUMBER_FORMAT " = " CALCULATED_NUMBER_FORMAT
1484                         , st->id, rd->name
1485                         , st->current_entry
1486                         , unpack_storage_number(rd->values[st->current_entry]), new_value
1487                         );
1488             }
1489             else {
1490                 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: STORE[%ld] = NON EXISTING "
1491                         , st->id, rd->name
1492                         , st->current_entry
1493                         );
1494                 rd->values[st->current_entry] = pack_storage_number(0, SN_NOT_EXISTS);
1495                 rd->last_stored_value = NAN;
1496             }
1497
1498             stored_entries++;
1499
1500             if(unlikely(st->debug)) {
1501                 calculated_number t1 = new_value * (calculated_number)rd->multiplier / (calculated_number)rd->divisor;
1502                 calculated_number t2 = unpack_storage_number(rd->values[st->current_entry]);
1503                 calculated_number accuracy = accuracy_loss(t1, t2);
1504                 debug(D_RRD_STATS, "%s/%s: UNPACK[%ld] = " CALCULATED_NUMBER_FORMAT " FLAGS=0x%08x (original = " CALCULATED_NUMBER_FORMAT ", accuracy loss = " CALCULATED_NUMBER_FORMAT "%%%s)"
1505                         , st->id, rd->name
1506                         , st->current_entry
1507                         , t2
1508                         , get_storage_number_flags(rd->values[st->current_entry])
1509                         , t1
1510                         , accuracy
1511                         , (accuracy > ACCURACY_LOSS) ? " **TOO BIG** " : ""
1512                         );
1513
1514                 rd->collected_volume += t1;
1515                 rd->stored_volume += t2;
1516                 accuracy = accuracy_loss(rd->collected_volume, rd->stored_volume);
1517                 debug(D_RRD_STATS, "%s/%s: VOLUME[%ld] = " CALCULATED_NUMBER_FORMAT ", calculated  = " CALCULATED_NUMBER_FORMAT ", accuracy loss = " CALCULATED_NUMBER_FORMAT "%%%s"
1518                         , st->id, rd->name
1519                         , st->current_entry
1520                         , rd->stored_volume
1521                         , rd->collected_volume
1522                         , accuracy
1523                         , (accuracy > ACCURACY_LOSS) ? " **TOO BIG** " : ""
1524                         );
1525
1526             }
1527         }
1528         // reset the storage flags for the next point, if any;
1529         storage_flags = SN_EXISTS;
1530
1531         st->counter++;
1532         st->current_entry = ((st->current_entry + 1) >= st->entries) ? 0 : st->current_entry + 1;
1533         last_stored_ut = next_store_ut;
1534     }
1535
1536     st->last_collected_total  = st->collected_total;
1537
1538     for( rd = st->dimensions; rd ; rd = rd->next ) {
1539         if(unlikely(!rd->updated)) continue;
1540
1541         if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: setting last_collected_value (old: " COLLECTED_NUMBER_FORMAT ") to last_collected_value (new: " COLLECTED_NUMBER_FORMAT ")", st->id, rd->name, rd->last_collected_value, rd->collected_value);
1542         rd->last_collected_value = rd->collected_value;
1543
1544         switch(rd->algorithm) {
1545             case RRDDIM_INCREMENTAL:
1546                 if(unlikely(!first_entry)) {
1547                     if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: setting last_calculated_value (old: " CALCULATED_NUMBER_FORMAT ") to last_calculated_value (new: " CALCULATED_NUMBER_FORMAT ")", st->id, rd->name, rd->last_calculated_value + rd->calculated_value, rd->calculated_value);
1548                     rd->last_calculated_value += rd->calculated_value;
1549                 }
1550                 else {
1551                     if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: THIS IS THE FIRST POINT", st->name);
1552                 }
1553                 break;
1554
1555             case RRDDIM_ABSOLUTE:
1556             case RRDDIM_PCENT_OVER_ROW_TOTAL:
1557             case RRDDIM_PCENT_OVER_DIFF_TOTAL:
1558                 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: setting last_calculated_value (old: " CALCULATED_NUMBER_FORMAT ") to last_calculated_value (new: " CALCULATED_NUMBER_FORMAT ")", st->id, rd->name, rd->last_calculated_value, rd->calculated_value);
1559                 rd->last_calculated_value = rd->calculated_value;
1560                 break;
1561         }
1562
1563         rd->calculated_value = 0;
1564         rd->collected_value = 0;
1565         rd->updated = 0;
1566
1567         if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: END "
1568             " last_collected_value = " COLLECTED_NUMBER_FORMAT
1569             " collected_value = " COLLECTED_NUMBER_FORMAT
1570             " last_calculated_value = " CALCULATED_NUMBER_FORMAT
1571             " calculated_value = " CALCULATED_NUMBER_FORMAT
1572             , st->id, rd->name
1573             , rd->last_collected_value
1574             , rd->collected_value
1575             , rd->last_calculated_value
1576             , rd->calculated_value
1577             );
1578     }
1579
1580     // ALL DONE ABOUT THE DATA UPDATE
1581     // --------------------------------------------------------------------
1582
1583 /*
1584     // find if there are any obsolete dimensions (not updated recently)
1585     if(unlikely(rrd_delete_unupdated_dimensions)) {
1586
1587         for( rd = st->dimensions; likely(rd) ; rd = rd->next )
1588             if((rd->last_collected_time.tv_sec + (rrd_delete_unupdated_dimensions * st->update_every)) < st->last_collected_time.tv_sec)
1589                 break;
1590
1591         if(unlikely(rd)) {
1592             RRDDIM *last;
1593             // there is dimension to free
1594             // upgrade our read lock to a write lock
1595             pthread_rwlock_unlock(&st->rwlock);
1596             pthread_rwlock_wrlock(&st->rwlock);
1597
1598             for( rd = st->dimensions, last = NULL ; likely(rd) ; ) {
1599                 // remove it only it is not updated in rrd_delete_unupdated_dimensions seconds
1600
1601                 if(unlikely((rd->last_collected_time.tv_sec + (rrd_delete_unupdated_dimensions * st->update_every)) < st->last_collected_time.tv_sec)) {
1602                     info("Removing obsolete dimension '%s' (%s) of '%s' (%s).", rd->name, rd->id, st->name, st->id);
1603
1604                     if(unlikely(!last)) {
1605                         st->dimensions = rd->next;
1606                         rd->next = NULL;
1607                         rrddim_free(st, rd);
1608                         rd = st->dimensions;
1609                         continue;
1610                     }
1611                     else {
1612                         last->next = rd->next;
1613                         rd->next = NULL;
1614                         rrddim_free(st, rd);
1615                         rd = last->next;
1616                         continue;
1617                     }
1618                 }
1619
1620                 last = rd;
1621                 rd = rd->next;
1622             }
1623
1624             if(unlikely(!st->dimensions)) {
1625                 info("Disabling chart %s (%s) since it does not have any dimensions", st->name, st->id);
1626                 st->enabled = 0;
1627             }
1628         }
1629     }
1630 */
1631
1632     pthread_rwlock_unlock(&st->rwlock);
1633
1634     if(unlikely(pthread_setcancelstate(pthreadoldcancelstate, NULL) != 0))
1635         error("Cannot set pthread cancel state to RESTORE (%d).", pthreadoldcancelstate);
1636
1637     return(st->usec_since_last_update);
1638 }