src/daemon/common.c

   1 /**
   2  * collectd - src/common.c
   3  * Copyright (C) 2005-2014  Florian octo Forster
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a
   6  * copy of this software and associated documentation files (the "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9  * and/or sell copies of the Software, and to permit persons to whom the
  10  * Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice shall be included in
  13  * all copies or substantial portions of the Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  18  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  21  * DEALINGS IN THE SOFTWARE.
  22  *
  23  * Authors:
  24  *   Florian octo Forster <octo at collectd.org>
  25  *   Niki W. Waibel <niki.waibel@gmx.net>
  26  *   Sebastian Harl <sh at tokkee.org>
  27  *   Michał Mirosław <mirq-linux at rere.qmqm.pl>
  28 **/
  29
  30 #if HAVE_CONFIG_H
  31 # include "config.h"
  32 #endif
  33
  34 #include "collectd.h"
  35 #include "common.h"
  36 #include "plugin.h"
  37 #include "utils_cache.h"
  38
  39 #if HAVE_PTHREAD_H
  40 # include <pthread.h>
  41 #endif
  42
  43 #ifdef HAVE_MATH_H
  44 # include <math.h>
  45 #endif
  46
  47 /* for getaddrinfo */
  48 #include <sys/types.h>
  49 #include <sys/socket.h>
  50 #include <netdb.h>
  51
  52 #include <poll.h>
  53
  54 #if HAVE_NETINET_IN_H
  55 # include <netinet/in.h>
  56 #endif
  57
  58 /* for ntohl and htonl */
  59 #if HAVE_ARPA_INET_H
  60 # include <arpa/inet.h>
  61 #endif
  62
  63 #ifdef HAVE_LIBKSTAT
  64 extern kstat_ctl_t *kc;
  65 #endif
  66
  67 #if !HAVE_GETPWNAM_R
  68 static pthread_mutex_t getpwnam_r_lock = PTHREAD_MUTEX_INITIALIZER;
  69 #endif
  70
  71 #if !HAVE_STRERROR_R
  72 static pthread_mutex_t strerror_r_lock = PTHREAD_MUTEX_INITIALIZER;
  73 #endif
  74
  75 char *sstrncpy (char *dest, const char *src, size_t n)
  76 {
  77         strncpy (dest, src, n);
  78         dest[n - 1] = '\0';
  79
  80         return (dest);
  81 } /* char *sstrncpy */
  82
  83 int ssnprintf (char *dest, size_t n, const char *format, ...)
  84 {
  85         int ret = 0;
  86         va_list ap;
  87
  88         va_start (ap, format);
  89         ret = vsnprintf (dest, n, format, ap);
  90         dest[n - 1] = '\0';
  91         va_end (ap);
  92
  93         return (ret);
  94 } /* int ssnprintf */
  95
  96 char *ssnprintf_alloc (char const *format, ...) /* {{{ */
  97 {
  98         char static_buffer[1024] = "";
  99         char *alloc_buffer;
 100         size_t alloc_buffer_size;
 101         int status;
 102         va_list ap;
 103
 104         /* Try printing into the static buffer. In many cases it will be
 105          * sufficiently large and we can simply return a strdup() of this
 106          * buffer. */
 107         va_start (ap, format);
 108         status = vsnprintf (static_buffer, sizeof (static_buffer), format, ap);
 109         va_end (ap);
 110         if (status < 0)
 111                 return (NULL);
 112
 113         /* "status" does not include the null byte. */
 114         alloc_buffer_size = (size_t) (status + 1);
 115         if (alloc_buffer_size <= sizeof (static_buffer))
 116                 return (strdup (static_buffer));
 117
 118         /* Allocate a buffer large enough to hold the string. */
 119         alloc_buffer = malloc (alloc_buffer_size);
 120         if (alloc_buffer == NULL)
 121                 return (NULL);
 122         memset (alloc_buffer, 0, alloc_buffer_size);
 123
 124         /* Print again into this new buffer. */
 125         va_start (ap, format);
 126         status = vsnprintf (alloc_buffer, alloc_buffer_size, format, ap);
 127         va_end (ap);
 128         if (status < 0)
 129         {
 130                 sfree (alloc_buffer);
 131                 return (NULL);
 132         }
 133
 134         return (alloc_buffer);
 135 } /* }}} char *ssnprintf_alloc */
 136
 137 char *sstrdup (const char *s)
 138 {
 139         char *r;
 140         size_t sz;
 141
 142         if (s == NULL)
 143                 return (NULL);
 144
 145         /* Do not use `strdup' here, because it's not specified in POSIX. It's
 146          * ``only'' an XSI extension. */
 147         sz = strlen (s) + 1;
 148         r = (char *) malloc (sizeof (char) * sz);
 149         if (r == NULL)
 150         {
 151                 ERROR ("sstrdup: Out of memory.");
 152                 exit (3);
 153         }
 154         memcpy (r, s, sizeof (char) * sz);
 155
 156         return (r);
 157 } /* char *sstrdup */
 158
 159 /* Even though Posix requires "strerror_r" to return an "int",
 160  * some systems (e.g. the GNU libc) return a "char *" _and_
 161  * ignore the second argument ... -tokkee */
 162 char *sstrerror (int errnum, char *buf, size_t buflen)
 163 {
 164         buf[0] = '\0';
 165
 166 #if !HAVE_STRERROR_R
 167         {
 168                 char *temp;
 169
 170                 pthread_mutex_lock (&strerror_r_lock);
 171
 172                 temp = strerror (errnum);
 173                 sstrncpy (buf, temp, buflen);
 174
 175                 pthread_mutex_unlock (&strerror_r_lock);
 176         }
 177 /* #endif !HAVE_STRERROR_R */
 178
 179 #elif STRERROR_R_CHAR_P
 180         {
 181                 char *temp;
 182                 temp = strerror_r (errnum, buf, buflen);
 183                 if (buf[0] == '\0')
 184                 {
 185                         if ((temp != NULL) && (temp != buf) && (temp[0] != '\0'))
 186                                 sstrncpy (buf, temp, buflen);
 187                         else
 188                                 sstrncpy (buf, "strerror_r did not return "
 189                                                 "an error message", buflen);
 190                 }
 191         }
 192 /* #endif STRERROR_R_CHAR_P */
 193
 194 #else
 195         if (strerror_r (errnum, buf, buflen) != 0)
 196         {
 197                 ssnprintf (buf, buflen, "Error #%i; "
 198                                 "Additionally, strerror_r failed.",
 199                                 errnum);
 200         }
 201 #endif /* STRERROR_R_CHAR_P */
 202
 203         return (buf);
 204 } /* char *sstrerror */
 205
 206 void *smalloc (size_t size)
 207 {
 208         void *r;
 209
 210         if ((r = malloc (size)) == NULL)
 211         {
 212                 ERROR ("Not enough memory.");
 213                 exit (3);
 214         }
 215
 216         return (r);
 217 } /* void *smalloc */
 218
 219 #if 0
 220 void sfree (void **ptr)
 221 {
 222         if (ptr == NULL)
 223                 return;
 224
 225         if (*ptr != NULL)
 226                 free (*ptr);
 227
 228         *ptr = NULL;
 229 }
 230 #endif
 231
 232 ssize_t sread (int fd, void *buf, size_t count)
 233 {
 234         char    *ptr;
 235         size_t   nleft;
 236         ssize_t  status;
 237
 238         ptr   = (char *) buf;
 239         nleft = count;
 240
 241         while (nleft > 0)
 242         {
 243                 status = read (fd, (void *) ptr, nleft);
 244
 245                 if ((status < 0) && ((errno == EAGAIN) || (errno == EINTR)))
 246                         continue;
 247
 248                 if (status < 0)
 249                         return (status);
 250
 251                 if (status == 0)
 252                 {
 253                         DEBUG ("Received EOF from fd %i. "
 254                                         "Closing fd and returning error.",
 255                                         fd);
 256                         close (fd);
 257                         return (-1);
 258                 }
 259
 260                 assert ((0 > status) || (nleft >= (size_t)status));
 261
 262                 nleft = nleft - status;
 263                 ptr   = ptr   + status;
 264         }
 265
 266         return (0);
 267 }
 268
 269
 270 ssize_t swrite (int fd, const void *buf, size_t count)
 271 {
 272         const char *ptr;
 273         size_t      nleft;
 274         ssize_t     status;
 275         struct      pollfd pfd;
 276
 277         ptr   = (const char *) buf;
 278         nleft = count;
 279
 280         /* checking for closed peer connection */
 281         pfd.fd = fd;
 282         pfd.events = POLLIN | POLLHUP;
 283         pfd.revents = 0;
 284         if (poll(&pfd, 1, 0) > 0) {
 285                 char buffer[32];
 286                 if (recv(fd, buffer, sizeof(buffer), MSG_PEEK | MSG_DONTWAIT) == 0) {
 287                         // if recv returns zero (even though poll() said there is data to be read),
 288                         // that means the connection has been closed
 289                         return -1;
 290                 }
 291         }
 292
 293         while (nleft > 0)
 294         {
 295                 status = write (fd, (const void *) ptr, nleft);
 296
 297                 if ((status < 0) && ((errno == EAGAIN) || (errno == EINTR)))
 298                         continue;
 299
 300                 if (status < 0)
 301                         return (status);
 302
 303                 nleft = nleft - status;
 304                 ptr   = ptr   + status;
 305         }
 306
 307         return (0);
 308 }
 309
 310 int strsplit (char *string, char **fields, size_t size)
 311 {
 312         size_t i;
 313         char *ptr;
 314         char *saveptr;
 315
 316         i = 0;
 317         ptr = string;
 318         saveptr = NULL;
 319         while ((fields[i] = strtok_r (ptr, " \t\r\n", &saveptr)) != NULL)
 320         {
 321                 ptr = NULL;
 322                 i++;
 323
 324                 if (i >= size)
 325                         break;
 326         }
 327
 328         return ((int) i);
 329 }
 330
 331 int strjoin (char *buffer, size_t buffer_size,
 332                 char **fields, size_t fields_num,
 333                 const char *sep)
 334 {
 335         size_t avail;
 336         char *ptr;
 337         size_t sep_len;
 338         size_t i;
 339
 340         if ((buffer_size < 1) || (fields_num <= 0))
 341                 return (-1);
 342
 343         memset (buffer, 0, buffer_size);
 344         ptr = buffer;
 345         avail = buffer_size - 1;
 346
 347         sep_len = 0;
 348         if (sep != NULL)
 349                 sep_len = strlen (sep);
 350
 351         for (i = 0; i < fields_num; i++)
 352         {
 353                 size_t field_len;
 354
 355                 if ((i > 0) && (sep_len > 0))
 356                 {
 357                         if (avail < sep_len)
 358                                 return (-1);
 359
 360                         memcpy (ptr, sep, sep_len);
 361                         ptr += sep_len;
 362                         avail -= sep_len;
 363                 }
 364
 365                 field_len = strlen (fields[i]);
 366                 if (avail < field_len)
 367                         return (-1);
 368
 369                 memcpy (ptr, fields[i], field_len);
 370                 ptr += field_len;
 371                 avail -= field_len;
 372         }
 373
 374         assert (buffer[buffer_size - 1] == 0);
 375         return (strlen (buffer));
 376 }
 377
 378 int strsubstitute (char *str, char c_from, char c_to)
 379 {
 380         int ret;
 381
 382         if (str == NULL)
 383                 return (-1);
 384
 385         ret = 0;
 386         while (*str != '\0')
 387         {
 388                 if (*str == c_from)
 389                 {
 390                         *str = c_to;
 391                         ret++;
 392                 }
 393                 str++;
 394         }
 395
 396         return (ret);
 397 } /* int strsubstitute */
 398
 399 int escape_string (char *buffer, size_t buffer_size)
 400 {
 401   char *temp;
 402   size_t i;
 403   size_t j;
 404
 405   /* Check if we need to escape at all first */
 406   temp = strpbrk (buffer, " \t\"\\");
 407   if (temp == NULL)
 408     return (0);
 409
 410   if (buffer_size < 3)
 411     return (EINVAL);
 412
 413   temp = (char *) malloc (buffer_size);
 414   if (temp == NULL)
 415     return (ENOMEM);
 416   memset (temp, 0, buffer_size);
 417
 418   temp[0] = '"';
 419   j = 1;
 420
 421   for (i = 0; i < buffer_size; i++)
 422   {
 423     if (buffer[i] == 0)
 424     {
 425       break;
 426     }
 427     else if ((buffer[i] == '"') || (buffer[i] == '\\'))
 428     {
 429       if (j > (buffer_size - 4))
 430         break;
 431       temp[j] = '\\';
 432       temp[j + 1] = buffer[i];
 433       j += 2;
 434     }
 435     else
 436     {
 437       if (j > (buffer_size - 3))
 438         break;
 439       temp[j] = buffer[i];
 440       j++;
 441     }
 442   }
 443
 444   assert ((j + 1) < buffer_size);
 445   temp[j] = '"';
 446   temp[j + 1] = 0;
 447
 448   sstrncpy (buffer, temp, buffer_size);
 449   sfree (temp);
 450   return (0);
 451 } /* int escape_string */
 452
 453 int strunescape (char *buf, size_t buf_len)
 454 {
 455         size_t i;
 456
 457         for (i = 0; (i < buf_len) && (buf[i] != '\0'); ++i)
 458         {
 459                 if (buf[i] != '\\')
 460                         continue;
 461
 462                 if (((i + 1) >= buf_len) || (buf[i + 1] == 0)) {
 463                         ERROR ("string unescape: backslash found at end of string.");
 464                         /* Ensure null-byte at the end of the buffer. */
 465                         buf[i] = 0;
 466                         return (-1);
 467                 }
 468
 469                 switch (buf[i + 1]) {
 470                         case 't':
 471                                 buf[i] = '\t';
 472                                 break;
 473                         case 'n':
 474                                 buf[i] = '\n';
 475                                 break;
 476                         case 'r':
 477                                 buf[i] = '\r';
 478                                 break;
 479                         default:
 480                                 buf[i] = buf[i + 1];
 481                                 break;
 482                 }
 483
 484                 /* Move everything after the position one position to the left.
 485                  * Add a null-byte as last character in the buffer. */
 486                 memmove (buf + i + 1, buf + i + 2, buf_len - i - 2);
 487                 buf[buf_len - 1] = 0;
 488         }
 489         return (0);
 490 } /* int strunescape */
 491
 492 size_t strstripnewline (char *buffer)
 493 {
 494         size_t buffer_len = strlen (buffer);
 495
 496         while (buffer_len > 0)
 497         {
 498                 if ((buffer[buffer_len - 1] != '\n')
 499                                 && (buffer[buffer_len - 1] != '\r'))
 500                         break;
 501                 buffer_len--;
 502                 buffer[buffer_len] = 0;
 503         }
 504
 505         return (buffer_len);
 506 } /* size_t strstripnewline */
 507
 508 int escape_slashes (char *buffer, size_t buffer_size)
 509 {
 510         int i;
 511         size_t buffer_len;
 512
 513         buffer_len = strlen (buffer);
 514
 515         if (buffer_len <= 1)
 516         {
 517                 if (strcmp ("/", buffer) == 0)
 518                 {
 519                         if (buffer_size < 5)
 520                                 return (-1);
 521                         sstrncpy (buffer, "root", buffer_size);
 522                 }
 523                 return (0);
 524         }
 525
 526         /* Move one to the left */
 527         if (buffer[0] == '/')
 528         {
 529                 memmove (buffer, buffer + 1, buffer_len);
 530                 buffer_len--;
 531         }
 532
 533         for (i = 0; i < buffer_len; i++)
 534         {
 535                 if (buffer[i] == '/')
 536                         buffer[i] = '_';
 537         }
 538
 539         return (0);
 540 } /* int escape_slashes */
 541
 542 void replace_special (char *buffer, size_t buffer_size)
 543 {
 544         size_t i;
 545
 546         for (i = 0; i < buffer_size; i++)
 547         {
 548                 if (buffer[i] == 0)
 549                         return;
 550                 if ((!isalnum ((int) buffer[i])) && (buffer[i] != '-'))
 551                         buffer[i] = '_';
 552         }
 553 } /* void replace_special */
 554
 555 int timeval_cmp (struct timeval tv0, struct timeval tv1, struct timeval *delta)
 556 {
 557         struct timeval *larger;
 558         struct timeval *smaller;
 559
 560         int status;
 561
 562         NORMALIZE_TIMEVAL (tv0);
 563         NORMALIZE_TIMEVAL (tv1);
 564
 565         if ((tv0.tv_sec == tv1.tv_sec) && (tv0.tv_usec == tv1.tv_usec))
 566         {
 567                 if (delta != NULL) {
 568                         delta->tv_sec  = 0;
 569                         delta->tv_usec = 0;
 570                 }
 571                 return (0);
 572         }
 573
 574         if ((tv0.tv_sec < tv1.tv_sec)
 575                         || ((tv0.tv_sec == tv1.tv_sec) && (tv0.tv_usec < tv1.tv_usec)))
 576         {
 577                 larger  = &tv1;
 578                 smaller = &tv0;
 579                 status  = -1;
 580         }
 581         else
 582         {
 583                 larger  = &tv0;
 584                 smaller = &tv1;
 585                 status  = 1;
 586         }
 587
 588         if (delta != NULL) {
 589                 delta->tv_sec = larger->tv_sec - smaller->tv_sec;
 590
 591                 if (smaller->tv_usec <= larger->tv_usec)
 592                         delta->tv_usec = larger->tv_usec - smaller->tv_usec;
 593                 else
 594                 {
 595                         --delta->tv_sec;
 596                         delta->tv_usec = 1000000 + larger->tv_usec - smaller->tv_usec;
 597                 }
 598         }
 599
 600         assert ((delta == NULL)
 601                         || ((0 <= delta->tv_usec) && (delta->tv_usec < 1000000)));
 602
 603         return (status);
 604 } /* int timeval_cmp */
 605
 606 int check_create_dir (const char *file_orig)
 607 {
 608         struct stat statbuf;
 609
 610         char  file_copy[512];
 611         char  dir[512];
 612         int   dir_len = 512;
 613         char *fields[16];
 614         int   fields_num;
 615         char *ptr;
 616         char *saveptr;
 617         int   last_is_file = 1;
 618         int   path_is_absolute = 0;
 619         size_t len;
 620         int   i;
 621
 622         /*
 623          * Sanity checks first
 624          */
 625         if (file_orig == NULL)
 626                 return (-1);
 627
 628         if ((len = strlen (file_orig)) < 1)
 629                 return (-1);
 630         else if (len >= sizeof (file_copy))
 631                 return (-1);
 632
 633         /*
 634          * If `file_orig' ends in a slash the last component is a directory,
 635          * otherwise it's a file. Act accordingly..
 636          */
 637         if (file_orig[len - 1] == '/')
 638                 last_is_file = 0;
 639         if (file_orig[0] == '/')
 640                 path_is_absolute = 1;
 641
 642         /*
 643          * Create a copy for `strtok_r' to destroy
 644          */
 645         sstrncpy (file_copy, file_orig, sizeof (file_copy));
 646
 647         /*
 648          * Break into components. This will eat up several slashes in a row and
 649          * remove leading and trailing slashes..
 650          */
 651         ptr = file_copy;
 652         saveptr = NULL;
 653         fields_num = 0;
 654         while ((fields[fields_num] = strtok_r (ptr, "/", &saveptr)) != NULL)
 655         {
 656                 ptr = NULL;
 657                 fields_num++;
 658
 659                 if (fields_num >= 16)
 660                         break;
 661         }
 662
 663         /*
 664          * For each component, do..
 665          */
 666         for (i = 0; i < (fields_num - last_is_file); i++)
 667         {
 668                 /*
 669                  * Do not create directories that start with a dot. This
 670                  * prevents `../../' attacks and other likely malicious
 671                  * behavior.
 672                  */
 673                 if (fields[i][0] == '.')
 674                 {
 675                         ERROR ("Cowardly refusing to create a directory that "
 676                                         "begins with a `.' (dot): `%s'", file_orig);
 677                         return (-2);
 678                 }
 679
 680                 /*
 681                  * Join the components together again
 682                  */
 683                 dir[0] = '/';
 684                 if (strjoin (dir + path_is_absolute, dir_len - path_is_absolute,
 685                                         fields, i + 1, "/") < 0)
 686                 {
 687                         ERROR ("strjoin failed: `%s', component #%i", file_orig, i);
 688                         return (-1);
 689                 }
 690
 691                 while (42) {
 692                         if ((stat (dir, &statbuf) == -1)
 693                                         && (lstat (dir, &statbuf) == -1))
 694                         {
 695                                 if (errno == ENOENT)
 696                                 {
 697                                         if (mkdir (dir, S_IRWXU | S_IRWXG | S_IRWXO) == 0)
 698                                                 break;
 699
 700                                         /* this might happen, if a different thread created
 701                                          * the directory in the meantime
 702                                          * => call stat() again to check for S_ISDIR() */
 703                                         if (EEXIST == errno)
 704                                                 continue;
 705
 706                                         char errbuf[1024];
 707                                         ERROR ("check_create_dir: mkdir (%s): %s", dir,
 708                                                         sstrerror (errno,
 709                                                                 errbuf, sizeof (errbuf)));
 710                                         return (-1);
 711                                 }
 712                                 else
 713                                 {
 714                                         char errbuf[1024];
 715                                         ERROR ("check_create_dir: stat (%s): %s", dir,
 716                                                         sstrerror (errno, errbuf,
 717                                                                 sizeof (errbuf)));
 718                                         return (-1);
 719                                 }
 720                         }
 721                         else if (!S_ISDIR (statbuf.st_mode))
 722                         {
 723                                 ERROR ("check_create_dir: `%s' exists but is not "
 724                                                 "a directory!", dir);
 725                                 return (-1);
 726                         }
 727                         break;
 728                 }
 729         }
 730
 731         return (0);
 732 } /* check_create_dir */
 733
 734 #ifdef HAVE_LIBKSTAT
 735 int get_kstat (kstat_t **ksp_ptr, char *module, int instance, char *name)
 736 {
 737         char ident[128];
 738
 739         *ksp_ptr = NULL;
 740
 741         if (kc == NULL)
 742                 return (-1);
 743
 744         ssnprintf (ident, sizeof (ident), "%s,%i,%s", module, instance, name);
 745
 746         *ksp_ptr = kstat_lookup (kc, module, instance, name);
 747         if (*ksp_ptr == NULL)
 748         {
 749                 ERROR ("get_kstat: Cound not find kstat %s", ident);
 750                 return (-1);
 751         }
 752
 753         if ((*ksp_ptr)->ks_type != KSTAT_TYPE_NAMED)
 754         {
 755                 ERROR ("get_kstat: kstat %s has wrong type", ident);
 756                 *ksp_ptr = NULL;
 757                 return (-1);
 758         }
 759
 760 #ifdef assert
 761         assert (*ksp_ptr != NULL);
 762         assert ((*ksp_ptr)->ks_type == KSTAT_TYPE_NAMED);
 763 #endif
 764
 765         if (kstat_read (kc, *ksp_ptr, NULL) == -1)
 766         {
 767                 ERROR ("get_kstat: kstat %s could not be read", ident);
 768                 return (-1);
 769         }
 770
 771         if ((*ksp_ptr)->ks_type != KSTAT_TYPE_NAMED)
 772         {
 773                 ERROR ("get_kstat: kstat %s has wrong type", ident);
 774                 return (-1);
 775         }
 776
 777         return (0);
 778 }
 779
 780 long long get_kstat_value (kstat_t *ksp, char *name)
 781 {
 782         kstat_named_t *kn;
 783         long long retval = -1LL;
 784
 785         if (ksp == NULL)
 786         {
 787                 ERROR ("get_kstat_value (\"%s\"): ksp is NULL.", name);
 788                 return (-1LL);
 789         }
 790         else if (ksp->ks_type != KSTAT_TYPE_NAMED)
 791         {
 792                 ERROR ("get_kstat_value (\"%s\"): ksp->ks_type (%#x) "
 793                                 "is not KSTAT_TYPE_NAMED (%#x).",
 794                                 name,
 795                                 (unsigned int) ksp->ks_type,
 796                                 (unsigned int) KSTAT_TYPE_NAMED);
 797                 return (-1LL);
 798         }
 799
 800         if ((kn = (kstat_named_t *) kstat_data_lookup (ksp, name)) == NULL)
 801                 return (-1LL);
 802
 803         if (kn->data_type == KSTAT_DATA_INT32)
 804                 retval = (long long) kn->value.i32;
 805         else if (kn->data_type == KSTAT_DATA_UINT32)
 806                 retval = (long long) kn->value.ui32;
 807         else if (kn->data_type == KSTAT_DATA_INT64)
 808                 retval = (long long) kn->value.i64; /* According to ANSI C99 `long long' must hold at least 64 bits */
 809         else if (kn->data_type == KSTAT_DATA_UINT64)
 810                 retval = (long long) kn->value.ui64; /* XXX: Might overflow! */
 811         else
 812                 WARNING ("get_kstat_value: Not a numeric value: %s", name);
 813
 814         return (retval);
 815 }
 816 #endif /* HAVE_LIBKSTAT */
 817
 818 #ifndef HAVE_HTONLL
 819 unsigned long long ntohll (unsigned long long n)
 820 {
 821 #if BYTE_ORDER == BIG_ENDIAN
 822         return (n);
 823 #else
 824         return (((unsigned long long) ntohl (n)) << 32) + ntohl (n >> 32);
 825 #endif
 826 } /* unsigned long long ntohll */
 827
 828 unsigned long long htonll (unsigned long long n)
 829 {
 830 #if BYTE_ORDER == BIG_ENDIAN
 831         return (n);
 832 #else
 833         return (((unsigned long long) htonl (n)) << 32) + htonl (n >> 32);
 834 #endif
 835 } /* unsigned long long htonll */
 836 #endif /* HAVE_HTONLL */
 837
 838 #if FP_LAYOUT_NEED_NOTHING
 839 /* Well, we need nothing.. */
 840 /* #endif FP_LAYOUT_NEED_NOTHING */
 841
 842 #elif FP_LAYOUT_NEED_ENDIANFLIP || FP_LAYOUT_NEED_INTSWAP
 843 # if FP_LAYOUT_NEED_ENDIANFLIP
 844 #  define FP_CONVERT(A) ((((uint64_t)(A) & 0xff00000000000000LL) >> 56) | \
 845                          (((uint64_t)(A) & 0x00ff000000000000LL) >> 40) | \
 846                          (((uint64_t)(A) & 0x0000ff0000000000LL) >> 24) | \
 847                          (((uint64_t)(A) & 0x000000ff00000000LL) >> 8)  | \
 848                          (((uint64_t)(A) & 0x00000000ff000000LL) << 8)  | \
 849                          (((uint64_t)(A) & 0x0000000000ff0000LL) << 24) | \
 850                          (((uint64_t)(A) & 0x000000000000ff00LL) << 40) | \
 851                          (((uint64_t)(A) & 0x00000000000000ffLL) << 56))
 852 # else
 853 #  define FP_CONVERT(A) ((((uint64_t)(A) & 0xffffffff00000000LL) >> 32) | \
 854                          (((uint64_t)(A) & 0x00000000ffffffffLL) << 32))
 855 # endif
 856
 857 double ntohd (double d)
 858 {
 859         union
 860         {
 861                 uint8_t  byte[8];
 862                 uint64_t integer;
 863                 double   floating;
 864         } ret;
 865
 866         ret.floating = d;
 867
 868         /* NAN in x86 byte order */
 869         if ((ret.byte[0] == 0x00) && (ret.byte[1] == 0x00)
 870                         && (ret.byte[2] == 0x00) && (ret.byte[3] == 0x00)
 871                         && (ret.byte[4] == 0x00) && (ret.byte[5] == 0x00)
 872                         && (ret.byte[6] == 0xf8) && (ret.byte[7] == 0x7f))
 873         {
 874                 return (NAN);
 875         }
 876         else
 877         {
 878                 uint64_t tmp;
 879
 880                 tmp = ret.integer;
 881                 ret.integer = FP_CONVERT (tmp);
 882                 return (ret.floating);
 883         }
 884 } /* double ntohd */
 885
 886 double htond (double d)
 887 {
 888         union
 889         {
 890                 uint8_t  byte[8];
 891                 uint64_t integer;
 892                 double   floating;
 893         } ret;
 894
 895         if (isnan (d))
 896         {
 897                 ret.byte[0] = ret.byte[1] = ret.byte[2] = ret.byte[3] = 0x00;
 898                 ret.byte[4] = ret.byte[5] = 0x00;
 899                 ret.byte[6] = 0xf8;
 900                 ret.byte[7] = 0x7f;
 901                 return (ret.floating);
 902         }
 903         else
 904         {
 905                 uint64_t tmp;
 906
 907                 ret.floating = d;
 908                 tmp = FP_CONVERT (ret.integer);
 909                 ret.integer = tmp;
 910                 return (ret.floating);
 911         }
 912 } /* double htond */
 913 #endif /* FP_LAYOUT_NEED_ENDIANFLIP || FP_LAYOUT_NEED_INTSWAP */
 914
 915 int format_name (char *ret, int ret_len,
 916                 const char *hostname,
 917                 const char *plugin, const char *plugin_instance,
 918                 const char *type, const char *type_instance)
 919 {
 920   char *buffer;
 921   size_t buffer_size;
 922
 923   buffer = ret;
 924   buffer_size = (size_t) ret_len;
 925
 926 #define APPEND(str) do {                                               \
 927   size_t l = strlen (str);                                             \
 928   if (l >= buffer_size)                                                \
 929     return (ENOBUFS);                                                  \
 930   memcpy (buffer, (str), l);                                           \
 931   buffer += l; buffer_size -= l;                                       \
 932 } while (0)
 933
 934   assert (plugin != NULL);
 935   assert (type != NULL);
 936
 937   APPEND (hostname);
 938   APPEND ("/");
 939   APPEND (plugin);
 940   if ((plugin_instance != NULL) && (plugin_instance[0] != 0))
 941   {
 942     APPEND ("-");
 943     APPEND (plugin_instance);
 944   }
 945   APPEND ("/");
 946   APPEND (type);
 947   if ((type_instance != NULL) && (type_instance[0] != 0))
 948   {
 949     APPEND ("-");
 950     APPEND (type_instance);
 951   }
 952   assert (buffer_size > 0);
 953   buffer[0] = 0;
 954
 955 #undef APPEND
 956   return (0);
 957 } /* int format_name */
 958
 959 int format_values (char *ret, size_t ret_len, /* {{{ */
 960                 const data_set_t *ds, const value_list_t *vl,
 961                 _Bool store_rates)
 962 {
 963         size_t offset = 0;
 964         int status;
 965         int i;
 966         gauge_t *rates = NULL;
 967
 968         assert (0 == strcmp (ds->type, vl->type));
 969
 970         memset (ret, 0, ret_len);
 971
 972 #define BUFFER_ADD(...) do { \
 973         status = ssnprintf (ret + offset, ret_len - offset, \
 974                         __VA_ARGS__); \
 975         if (status < 1) \
 976         { \
 977                 sfree (rates); \
 978                 return (-1); \
 979         } \
 980         else if (((size_t) status) >= (ret_len - offset)) \
 981         { \
 982                 sfree (rates); \
 983                 return (-1); \
 984         } \
 985         else \
 986                 offset += ((size_t) status); \
 987 } while (0)
 988
 989         BUFFER_ADD ("%.3f", CDTIME_T_TO_DOUBLE (vl->time));
 990
 991         for (i = 0; i < ds->ds_num; i++)
 992         {
 993                 if (ds->ds[i].type == DS_TYPE_GAUGE)
 994                         BUFFER_ADD (":"GAUGE_FORMAT, vl->values[i].gauge);
 995                 else if (store_rates)
 996                 {
 997                         if (rates == NULL)
 998                                 rates = uc_get_rate (ds, vl);
 999                         if (rates == NULL)
1000                         {
1001                                 WARNING ("format_values: uc_get_rate failed.");
1002                                 return (-1);
1003                         }
1004                         BUFFER_ADD (":"GAUGE_FORMAT, rates[i]);
1005                 }
1006                 else if (ds->ds[i].type == DS_TYPE_COUNTER)
1007                         BUFFER_ADD (":%llu", vl->values[i].counter);
1008                 else if (ds->ds[i].type == DS_TYPE_DERIVE)
1009                         BUFFER_ADD (":%"PRIi64, vl->values[i].derive);
1010                 else if (ds->ds[i].type == DS_TYPE_ABSOLUTE)
1011                         BUFFER_ADD (":%"PRIu64, vl->values[i].absolute);
1012                 else
1013                 {
1014                         ERROR ("format_values: Unknown data source type: %i",
1015                                         ds->ds[i].type);
1016                         sfree (rates);
1017                         return (-1);
1018                 }
1019         } /* for ds->ds_num */
1020
1021 #undef BUFFER_ADD
1022
1023         sfree (rates);
1024         return (0);
1025 } /* }}} int format_values */
1026
1027 int parse_identifier (char *str, char **ret_host,
1028                 char **ret_plugin, char **ret_plugin_instance,
1029                 char **ret_type, char **ret_type_instance)
1030 {
1031         char *hostname = NULL;
1032         char *plugin = NULL;
1033         char *plugin_instance = NULL;
1034         char *type = NULL;
1035         char *type_instance = NULL;
1036
1037         hostname = str;
1038         if (hostname == NULL)
1039                 return (-1);
1040
1041         plugin = strchr (hostname, '/');
1042         if (plugin == NULL)
1043                 return (-1);
1044         *plugin = '\0'; plugin++;
1045
1046         type = strchr (plugin, '/');
1047         if (type == NULL)
1048                 return (-1);
1049         *type = '\0'; type++;
1050
1051         plugin_instance = strchr (plugin, '-');
1052         if (plugin_instance != NULL)
1053         {
1054                 *plugin_instance = '\0';
1055                 plugin_instance++;
1056         }
1057
1058         type_instance = strchr (type, '-');
1059         if (type_instance != NULL)
1060         {
1061                 *type_instance = '\0';
1062                 type_instance++;
1063         }
1064
1065         *ret_host = hostname;
1066         *ret_plugin = plugin;
1067         *ret_plugin_instance = plugin_instance;
1068         *ret_type = type;
1069         *ret_type_instance = type_instance;
1070         return (0);
1071 } /* int parse_identifier */
1072
1073 int parse_identifier_vl (const char *str, value_list_t *vl) /* {{{ */
1074 {
1075         char str_copy[6 * DATA_MAX_NAME_LEN];
1076         char *host = NULL;
1077         char *plugin = NULL;
1078         char *plugin_instance = NULL;
1079         char *type = NULL;
1080         char *type_instance = NULL;
1081         int status;
1082
1083         if ((str == NULL) || (vl == NULL))
1084                 return (EINVAL);
1085
1086         sstrncpy (str_copy, str, sizeof (str_copy));
1087
1088         status = parse_identifier (str_copy, &host,
1089                         &plugin, &plugin_instance,
1090                         &type, &type_instance);
1091         if (status != 0)
1092                 return (status);
1093
1094         sstrncpy (vl->host, host, sizeof (vl->host));
1095         sstrncpy (vl->plugin, plugin, sizeof (vl->plugin));
1096         sstrncpy (vl->plugin_instance,
1097                         (plugin_instance != NULL) ? plugin_instance : "",
1098                         sizeof (vl->plugin_instance));
1099         sstrncpy (vl->type, type, sizeof (vl->type));
1100         sstrncpy (vl->type_instance,
1101                         (type_instance != NULL) ? type_instance : "",
1102                         sizeof (vl->type_instance));
1103
1104         return (0);
1105 } /* }}} int parse_identifier_vl */
1106
1107 int parse_value (const char *value_orig, value_t *ret_value, int ds_type)
1108 {
1109   char *value;
1110   char *endptr = NULL;
1111   size_t value_len;
1112
1113   if (value_orig == NULL)
1114     return (EINVAL);
1115
1116   value = strdup (value_orig);
1117   if (value == NULL)
1118     return (ENOMEM);
1119   value_len = strlen (value);
1120
1121   while ((value_len > 0) && isspace ((int) value[value_len - 1]))
1122   {
1123     value[value_len - 1] = 0;
1124     value_len--;
1125   }
1126
1127   switch (ds_type)
1128   {
1129     case DS_TYPE_COUNTER:
1130       ret_value->counter = (counter_t) strtoull (value, &endptr, 0);
1131       break;
1132
1133     case DS_TYPE_GAUGE:
1134       ret_value->gauge = (gauge_t) strtod (value, &endptr);
1135       break;
1136
1137     case DS_TYPE_DERIVE:
1138       ret_value->derive = (derive_t) strtoll (value, &endptr, 0);
1139       break;
1140
1141     case DS_TYPE_ABSOLUTE:
1142       ret_value->absolute = (absolute_t) strtoull (value, &endptr, 0);
1143       break;
1144
1145     default:
1146       sfree (value);
1147       ERROR ("parse_value: Invalid data source type: %i.", ds_type);
1148       return -1;
1149   }
1150
1151   if (value == endptr) {
1152     ERROR ("parse_value: Failed to parse string as %s: %s.",
1153         DS_TYPE_TO_STRING (ds_type), value);
1154     sfree (value);
1155     return -1;
1156   }
1157   else if ((NULL != endptr) && ('\0' != *endptr))
1158     INFO ("parse_value: Ignoring trailing garbage \"%s\" after %s value. "
1159         "Input string was \"%s\".",
1160         endptr, DS_TYPE_TO_STRING (ds_type), value_orig);
1161
1162   sfree (value);
1163   return 0;
1164 } /* int parse_value */
1165
1166 int parse_values (char *buffer, value_list_t *vl, const data_set_t *ds)
1167 {
1168         int i;
1169         char *dummy;
1170         char *ptr;
1171         char *saveptr;
1172
1173         if ((buffer == NULL) || (vl == NULL) || (ds == NULL))
1174                 return EINVAL;
1175
1176         i = -1;
1177         dummy = buffer;
1178         saveptr = NULL;
1179         while ((ptr = strtok_r (dummy, ":", &saveptr)) != NULL)
1180         {
1181                 dummy = NULL;
1182
1183                 if (i >= vl->values_len)
1184                 {
1185                         /* Make sure i is invalid. */
1186                         i = vl->values_len + 1;
1187                         break;
1188                 }
1189
1190                 if (i == -1)
1191                 {
1192                         if (strcmp ("N", ptr) == 0)
1193                                 vl->time = cdtime ();
1194                         else
1195                         {
1196                                 char *endptr = NULL;
1197                                 double tmp;
1198
1199                                 errno = 0;
1200                                 tmp = strtod (ptr, &endptr);
1201                                 if ((errno != 0)                    /* Overflow */
1202                                                 || (endptr == ptr)  /* Invalid string */
1203                                                 || (endptr == NULL) /* This should not happen */
1204                                                 || (*endptr != 0))  /* Trailing chars */
1205                                         return (-1);
1206
1207                                 vl->time = DOUBLE_TO_CDTIME_T (tmp);
1208                         }
1209                 }
1210                 else
1211                 {
1212                         if ((strcmp ("U", ptr) == 0) && (ds->ds[i].type == DS_TYPE_GAUGE))
1213                                 vl->values[i].gauge = NAN;
1214                         else if (0 != parse_value (ptr, &vl->values[i], ds->ds[i].type))
1215                                 return -1;
1216                 }
1217
1218                 i++;
1219         } /* while (strtok_r) */
1220
1221         if ((ptr != NULL) || (i != vl->values_len))
1222                 return (-1);
1223         return (0);
1224 } /* int parse_values */
1225
1226 #if !HAVE_GETPWNAM_R
1227 int getpwnam_r (const char *name, struct passwd *pwbuf, char *buf,
1228                 size_t buflen, struct passwd **pwbufp)
1229 {
1230         int status = 0;
1231         struct passwd *pw;
1232
1233         memset (pwbuf, '\0', sizeof (struct passwd));
1234
1235         pthread_mutex_lock (&getpwnam_r_lock);
1236
1237         do
1238         {
1239                 pw = getpwnam (name);
1240                 if (pw == NULL)
1241                 {
1242                         status = (errno != 0) ? errno : ENOENT;
1243                         break;
1244                 }
1245
1246 #define GETPWNAM_COPY_MEMBER(member) \
1247                 if (pw->member != NULL) \
1248                 { \
1249                         int len = strlen (pw->member); \
1250                         if (len >= buflen) \
1251                         { \
1252                                 status = ENOMEM; \
1253                                 break; \
1254                         } \
1255                         sstrncpy (buf, pw->member, buflen); \
1256                         pwbuf->member = buf; \
1257                         buf    += (len + 1); \
1258                         buflen -= (len + 1); \
1259                 }
1260                 GETPWNAM_COPY_MEMBER(pw_name);
1261                 GETPWNAM_COPY_MEMBER(pw_passwd);
1262                 GETPWNAM_COPY_MEMBER(pw_gecos);
1263                 GETPWNAM_COPY_MEMBER(pw_dir);
1264                 GETPWNAM_COPY_MEMBER(pw_shell);
1265
1266                 pwbuf->pw_uid = pw->pw_uid;
1267                 pwbuf->pw_gid = pw->pw_gid;
1268
1269                 if (pwbufp != NULL)
1270                         *pwbufp = pwbuf;
1271         } while (0);
1272
1273         pthread_mutex_unlock (&getpwnam_r_lock);
1274
1275         return (status);
1276 } /* int getpwnam_r */
1277 #endif /* !HAVE_GETPWNAM_R */
1278
1279 int notification_init (notification_t *n, int severity, const char *message,
1280                 const char *host,
1281                 const char *plugin, const char *plugin_instance,
1282                 const char *type, const char *type_instance)
1283 {
1284         memset (n, '\0', sizeof (notification_t));
1285
1286         n->severity = severity;
1287
1288         if (message != NULL)
1289                 sstrncpy (n->message, message, sizeof (n->message));
1290         if (host != NULL)
1291                 sstrncpy (n->host, host, sizeof (n->host));
1292         if (plugin != NULL)
1293                 sstrncpy (n->plugin, plugin, sizeof (n->plugin));
1294         if (plugin_instance != NULL)
1295                 sstrncpy (n->plugin_instance, plugin_instance,
1296                                 sizeof (n->plugin_instance));
1297         if (type != NULL)
1298                 sstrncpy (n->type, type, sizeof (n->type));
1299         if (type_instance != NULL)
1300                 sstrncpy (n->type_instance, type_instance,
1301                                 sizeof (n->type_instance));
1302
1303         return (0);
1304 } /* int notification_init */
1305
1306 int walk_directory (const char *dir, dirwalk_callback_f callback,
1307                 void *user_data, int include_hidden)
1308 {
1309         struct dirent *ent;
1310         DIR *dh;
1311         int success;
1312         int failure;
1313
1314         success = 0;
1315         failure = 0;
1316
1317         if ((dh = opendir (dir)) == NULL)
1318         {
1319                 char errbuf[1024];
1320                 ERROR ("walk_directory: Cannot open '%s': %s", dir,
1321                                 sstrerror (errno, errbuf, sizeof (errbuf)));
1322                 return -1;
1323         }
1324
1325         while ((ent = readdir (dh)) != NULL)
1326         {
1327                 int status;
1328
1329                 if (include_hidden)
1330                 {
1331                         if ((strcmp (".", ent->d_name) == 0)
1332                                         || (strcmp ("..", ent->d_name) == 0))
1333                                 continue;
1334                 }
1335                 else /* if (!include_hidden) */
1336                 {
1337                         if (ent->d_name[0]=='.')
1338                                 continue;
1339                 }
1340
1341                 status = (*callback) (dir, ent->d_name, user_data);
1342                 if (status != 0)
1343                         failure++;
1344                 else
1345                         success++;
1346         }
1347
1348         closedir (dh);
1349
1350         if ((success == 0) && (failure > 0))
1351                 return (-1);
1352         return (0);
1353 }
1354
1355 ssize_t read_file_contents (const char *filename, char *buf, size_t bufsize)
1356 {
1357         FILE *fh;
1358         ssize_t ret;
1359
1360         fh = fopen (filename, "r");
1361         if (fh == NULL)
1362                 return (-1);
1363
1364         ret = (ssize_t) fread (buf, 1, bufsize, fh);
1365         if ((ret == 0) && (ferror (fh) != 0))
1366         {
1367                 ERROR ("read_file_contents: Reading file \"%s\" failed.",
1368                                 filename);
1369                 ret = -1;
1370         }
1371
1372         fclose(fh);
1373         return (ret);
1374 }
1375
1376 counter_t counter_diff (counter_t old_value, counter_t new_value)
1377 {
1378         counter_t diff;
1379
1380         if (old_value > new_value)
1381         {
1382                 if (old_value <= 4294967295U)
1383                         diff = (4294967295U - old_value) + new_value;
1384                 else
1385                         diff = (18446744073709551615ULL - old_value)
1386                                 + new_value;
1387         }
1388         else
1389         {
1390                 diff = new_value - old_value;
1391         }
1392
1393         return (diff);
1394 } /* counter_t counter_diff */
1395
1396 int rate_to_value (value_t *ret_value, gauge_t rate, /* {{{ */
1397                 rate_to_value_state_t *state,
1398                 int ds_type, cdtime_t t)
1399 {
1400         gauge_t delta_gauge;
1401         cdtime_t delta_t;
1402
1403         if (ds_type == DS_TYPE_GAUGE)
1404         {
1405                 state->last_value.gauge = rate;
1406                 state->last_time = t;
1407
1408                 *ret_value = state->last_value;
1409                 return (0);
1410         }
1411
1412         /* Counter and absolute can't handle negative rates. Reset "last time"
1413          * to zero, so that the next valid rate will re-initialize the
1414          * structure. */
1415         if ((rate < 0.0)
1416                         && ((ds_type == DS_TYPE_COUNTER)
1417                                 || (ds_type == DS_TYPE_ABSOLUTE)))
1418         {
1419                 memset (state, 0, sizeof (*state));
1420                 return (EINVAL);
1421         }
1422
1423         /* Another invalid state: The time is not increasing. */
1424         if (t <= state->last_time)
1425         {
1426                 memset (state, 0, sizeof (*state));
1427                 return (EINVAL);
1428         }
1429
1430         delta_t = t - state->last_time;
1431         delta_gauge = (rate * CDTIME_T_TO_DOUBLE (delta_t)) + state->residual;
1432
1433         /* Previous value is invalid. */
1434         if (state->last_time == 0) /* {{{ */
1435         {
1436                 if (ds_type == DS_TYPE_DERIVE)
1437                 {
1438                         state->last_value.derive = (derive_t) rate;
1439                         state->residual = rate - ((gauge_t) state->last_value.derive);
1440                 }
1441                 else if (ds_type == DS_TYPE_COUNTER)
1442                 {
1443                         state->last_value.counter = (counter_t) rate;
1444                         state->residual = rate - ((gauge_t) state->last_value.counter);
1445                 }
1446                 else if (ds_type == DS_TYPE_ABSOLUTE)
1447                 {
1448                         state->last_value.absolute = (absolute_t) rate;
1449                         state->residual = rate - ((gauge_t) state->last_value.absolute);
1450                 }
1451                 else
1452                 {
1453                         assert (23 == 42);
1454                 }
1455
1456                 state->last_time = t;
1457                 return (EAGAIN);
1458         } /* }}} */
1459
1460         if (ds_type == DS_TYPE_DERIVE)
1461         {
1462                 derive_t delta_derive = (derive_t) delta_gauge;
1463
1464                 state->last_value.derive += delta_derive;
1465                 state->residual = delta_gauge - ((gauge_t) delta_derive);
1466         }
1467         else if (ds_type == DS_TYPE_COUNTER)
1468         {
1469                 counter_t delta_counter = (counter_t) delta_gauge;
1470
1471                 state->last_value.counter += delta_counter;
1472                 state->residual = delta_gauge - ((gauge_t) delta_counter);
1473         }
1474         else if (ds_type == DS_TYPE_ABSOLUTE)
1475         {
1476                 absolute_t delta_absolute = (absolute_t) delta_gauge;
1477
1478                 state->last_value.absolute = delta_absolute;
1479                 state->residual = delta_gauge - ((gauge_t) delta_absolute);
1480         }
1481         else
1482         {
1483                 assert (23 == 42);
1484         }
1485
1486         state->last_time = t;
1487         *ret_value = state->last_value;
1488         return (0);
1489 } /* }}} value_t rate_to_value */
1490
1491 int value_to_rate (value_t *ret_rate, derive_t value, /* {{{ */
1492                 value_to_rate_state_t *state,
1493                 int ds_type, cdtime_t t)
1494 {
1495         double interval;
1496
1497         /* Another invalid state: The time is not increasing. */
1498         if (t <= state->last_time)
1499         {
1500                 memset (state, 0, sizeof (*state));
1501                 return (EINVAL);
1502         }
1503
1504         interval = CDTIME_T_TO_DOUBLE(t - state->last_time);
1505
1506         /* Previous value is invalid. */
1507         if (state->last_time == 0) /* {{{ */
1508         {
1509                 if (ds_type == DS_TYPE_DERIVE)
1510                 {
1511                         state->last_value.derive = value;
1512                 }
1513                 else if (ds_type == DS_TYPE_COUNTER)
1514                 {
1515                         state->last_value.counter = (counter_t) value;
1516                 }
1517                 else if (ds_type == DS_TYPE_ABSOLUTE)
1518                 {
1519                         state->last_value.absolute = (absolute_t) value;
1520                 }
1521                 else
1522                 {
1523                         assert (23 == 42);
1524                 }
1525
1526                 state->last_time = t;
1527                 return (EAGAIN);
1528         } /* }}} */
1529
1530         if (ds_type == DS_TYPE_DERIVE)
1531         {
1532                 ret_rate->gauge = (value - state->last_value.derive) / interval;
1533                 state->last_value.derive = value;
1534         }
1535         else if (ds_type == DS_TYPE_COUNTER)
1536         {
1537                 ret_rate->gauge = (((counter_t)value) - state->last_value.counter) / interval;
1538                 state->last_value.counter = (counter_t) value;
1539         }
1540         else if (ds_type == DS_TYPE_ABSOLUTE)
1541         {
1542                 ret_rate->gauge = (((absolute_t)value) - state->last_value.absolute) / interval;
1543                 state->last_value.absolute = (absolute_t) value;
1544         }
1545         else
1546         {
1547                 assert (23 == 42);
1548         }
1549
1550         state->last_time = t;
1551         return (0);
1552 } /* }}} value_t rate_to_value */
1553
1554 int service_name_to_port_number (const char *service_name)
1555 {
1556         struct addrinfo *ai_list;
1557         struct addrinfo *ai_ptr;
1558         struct addrinfo ai_hints;
1559         int status;
1560         int service_number;
1561
1562         if (service_name == NULL)
1563                 return (-1);
1564
1565         ai_list = NULL;
1566         memset (&ai_hints, 0, sizeof (ai_hints));
1567         ai_hints.ai_family = AF_UNSPEC;
1568
1569         status = getaddrinfo (/* node = */ NULL, service_name,
1570                         &ai_hints, &ai_list);
1571         if (status != 0)
1572         {
1573                 ERROR ("service_name_to_port_number: getaddrinfo failed: %s",
1574                                 gai_strerror (status));
1575                 return (-1);
1576         }
1577
1578         service_number = -1;
1579         for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next)
1580         {
1581                 if (ai_ptr->ai_family == AF_INET)
1582                 {
1583                         struct sockaddr_in *sa;
1584
1585                         sa = (void *) ai_ptr->ai_addr;
1586                         service_number = (int) ntohs (sa->sin_port);
1587                 }
1588                 else if (ai_ptr->ai_family == AF_INET6)
1589                 {
1590                         struct sockaddr_in6 *sa;
1591
1592                         sa = (void *) ai_ptr->ai_addr;
1593                         service_number = (int) ntohs (sa->sin6_port);
1594                 }
1595
1596                 if ((service_number > 0) && (service_number <= 65535))
1597                         break;
1598         }
1599
1600         freeaddrinfo (ai_list);
1601
1602         if ((service_number > 0) && (service_number <= 65535))
1603                 return (service_number);
1604         return (-1);
1605 } /* int service_name_to_port_number */
1606
1607 int strtoderive (const char *string, derive_t *ret_value) /* {{{ */
1608 {
1609         derive_t tmp;
1610         char *endptr;
1611
1612         if ((string == NULL) || (ret_value == NULL))
1613                 return (EINVAL);
1614
1615         errno = 0;
1616         endptr = NULL;
1617         tmp = (derive_t) strtoll (string, &endptr, /* base = */ 0);
1618         if ((endptr == string) || (errno != 0))
1619                 return (-1);
1620
1621         *ret_value = tmp;
1622         return (0);
1623 } /* }}} int strtoderive */
1624
1625 int strtogauge (const char *string, gauge_t *ret_value) /* {{{ */
1626 {
1627         gauge_t tmp;
1628         char *endptr = NULL;
1629
1630         if ((string == NULL) || (ret_value == NULL))
1631                 return (EINVAL);
1632
1633         errno = 0;
1634         endptr = NULL;
1635         tmp = (gauge_t) strtod (string, &endptr);
1636         if (errno != 0)
1637                 return (errno);
1638         else if ((endptr == NULL) || (*endptr != 0))
1639                 return (EINVAL);
1640
1641         *ret_value = tmp;
1642         return (0);
1643 } /* }}} int strtogauge */
1644
1645 int strarray_add (char ***ret_array, size_t *ret_array_len, char const *str) /* {{{ */
1646 {
1647         char **array;
1648         size_t array_len = *ret_array_len;
1649
1650         if (str == NULL)
1651                 return (EINVAL);
1652
1653         array = realloc (*ret_array,
1654             (array_len + 1) * sizeof (*array));
1655         if (array == NULL)
1656                 return (ENOMEM);
1657         *ret_array = array;
1658
1659         array[array_len] = strdup (str);
1660         if (array[array_len] == NULL)
1661                 return (ENOMEM);
1662
1663         array_len++;
1664         *ret_array_len = array_len;
1665         return (0);
1666 } /* }}} int strarray_add */
1667
1668 void strarray_free (char **array, size_t array_len) /* {{{ */
1669 {
1670         size_t i;
1671
1672         for (i = 0; i < array_len; i++)
1673                 sfree (array[i]);
1674         sfree (array);
1675 } /* }}} void strarray_free */