src/common.c

   1 /**
   2  * collectd - src/common.c
   3  * Copyright (C) 2005-2008  Florian octo Forster
   4  *
   5  * This program is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License as published by the
   7  * Free Software Foundation; only version 2 of the License is applicable.
   8  *
   9  * This program is distributed in the hope that it will be useful, but
  10  * WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along
  15  * with this program; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
  17  *
  18  * Authors:
  19  *   Florian octo Forster <octo at verplant.org>
  20  *   Niki W. Waibel <niki.waibel@gmx.net>
  21  *   Sebastian Harl <sh at tokkee.org>
  22  *   Michał Mirosław <mirq-linux at rere.qmqm.pl>
  23 **/
  24
  25 #if HAVE_CONFIG_H
  26 # include "config.h"
  27 #endif
  28
  29 #include "collectd.h"
  30 #include "common.h"
  31 #include "plugin.h"
  32
  33 #if HAVE_PTHREAD_H
  34 # include <pthread.h>
  35 #endif
  36
  37 #ifdef HAVE_MATH_H
  38 # include <math.h>
  39 #endif
  40
  41 /* for ntohl and htonl */
  42 #if HAVE_ARPA_INET_H
  43 # include <arpa/inet.h>
  44 #endif
  45
  46 #ifdef HAVE_LIBKSTAT
  47 extern kstat_ctl_t *kc;
  48 #endif
  49
  50 #if !HAVE_GETPWNAM_R
  51 static pthread_mutex_t getpwnam_r_lock = PTHREAD_MUTEX_INITIALIZER;
  52 #endif
  53
  54 #if !HAVE_STRERROR_R
  55 static pthread_mutex_t strerror_r_lock = PTHREAD_MUTEX_INITIALIZER;
  56 #endif
  57
  58 char *sstrncpy (char *dest, const char *src, size_t n)
  59 {
  60         strncpy (dest, src, n);
  61         dest[n - 1] = '\0';
  62
  63         return (dest);
  64 } /* char *sstrncpy */
  65
  66 int ssnprintf (char *dest, size_t n, const char *format, ...)
  67 {
  68         int ret = 0;
  69         va_list ap;
  70
  71         va_start (ap, format);
  72         ret = vsnprintf (dest, n, format, ap);
  73         dest[n - 1] = '\0';
  74         va_end (ap);
  75
  76         return (ret);
  77 } /* int ssnprintf */
  78
  79 char *sstrdup (const char *s)
  80 {
  81         char *r;
  82         size_t sz;
  83
  84         if (s == NULL)
  85                 return (NULL);
  86
  87         /* Do not use `strdup' here, because it's not specified in POSIX. It's
  88          * ``only'' an XSI extension. */
  89         sz = strlen (s) + 1;
  90         r = (char *) malloc (sizeof (char) * sz);
  91         if (r == NULL)
  92         {
  93                 ERROR ("sstrdup: Out of memory.");
  94                 exit (3);
  95         }
  96         memcpy (r, s, sizeof (char) * sz);
  97
  98         return (r);
  99 } /* char *sstrdup */
 100
 101 /* Even though Posix requires "strerror_r" to return an "int",
 102  * some systems (e.g. the GNU libc) return a "char *" _and_
 103  * ignore the second argument ... -tokkee */
 104 char *sstrerror (int errnum, char *buf, size_t buflen)
 105 {
 106         buf[0] = '\0';
 107
 108 #if !HAVE_STRERROR_R
 109         {
 110                 char *temp;
 111
 112                 pthread_mutex_lock (&strerror_r_lock);
 113
 114                 temp = strerror (errnum);
 115                 sstrncpy (buf, temp, buflen);
 116
 117                 pthread_mutex_unlock (&strerror_r_lock);
 118         }
 119 /* #endif !HAVE_STRERROR_R */
 120
 121 #elif STRERROR_R_CHAR_P
 122         {
 123                 char *temp;
 124                 temp = strerror_r (errnum, buf, buflen);
 125                 if (buf[0] == '\0')
 126                 {
 127                         if ((temp != NULL) && (temp != buf) && (temp[0] != '\0'))
 128                                 sstrncpy (buf, temp, buflen);
 129                         else
 130                                 sstrncpy (buf, "strerror_r did not return "
 131                                                 "an error message", buflen);
 132                 }
 133         }
 134 /* #endif STRERROR_R_CHAR_P */
 135
 136 #else
 137         if (strerror_r (errnum, buf, buflen) != 0)
 138         {
 139                 ssnprintf (buf, buflen, "Error #%i; "
 140                                 "Additionally, strerror_r failed.",
 141                                 errnum);
 142         }
 143 #endif /* STRERROR_R_CHAR_P */
 144
 145         return (buf);
 146 } /* char *sstrerror */
 147
 148 void *smalloc (size_t size)
 149 {
 150         void *r;
 151
 152         if ((r = malloc (size)) == NULL)
 153         {
 154                 ERROR ("Not enough memory.");
 155                 exit (3);
 156         }
 157
 158         return (r);
 159 } /* void *smalloc */
 160
 161 #if 0
 162 void sfree (void **ptr)
 163 {
 164         if (ptr == NULL)
 165                 return;
 166
 167         if (*ptr != NULL)
 168                 free (*ptr);
 169
 170         *ptr = NULL;
 171 }
 172 #endif
 173
 174 ssize_t sread (int fd, void *buf, size_t count)
 175 {
 176         char    *ptr;
 177         size_t   nleft;
 178         ssize_t  status;
 179
 180         ptr   = (char *) buf;
 181         nleft = count;
 182
 183         while (nleft > 0)
 184         {
 185                 status = read (fd, (void *) ptr, nleft);
 186
 187                 if ((status < 0) && ((errno == EAGAIN) || (errno == EINTR)))
 188                         continue;
 189
 190                 if (status < 0)
 191                         return (status);
 192
 193                 if (status == 0)
 194                 {
 195                         DEBUG ("Received EOF from fd %i. "
 196                                         "Closing fd and returning error.",
 197                                         fd);
 198                         close (fd);
 199                         return (-1);
 200                 }
 201
 202                 assert ((0 > status) || (nleft >= (size_t)status));
 203
 204                 nleft = nleft - status;
 205                 ptr   = ptr   + status;
 206         }
 207
 208         return (0);
 209 }
 210
 211
 212 ssize_t swrite (int fd, const void *buf, size_t count)
 213 {
 214         const char *ptr;
 215         size_t      nleft;
 216         ssize_t     status;
 217
 218         ptr   = (const char *) buf;
 219         nleft = count;
 220
 221         while (nleft > 0)
 222         {
 223                 status = write (fd, (const void *) ptr, nleft);
 224
 225                 if ((status < 0) && ((errno == EAGAIN) || (errno == EINTR)))
 226                         continue;
 227
 228                 if (status < 0)
 229                         return (status);
 230
 231                 nleft = nleft - status;
 232                 ptr   = ptr   + status;
 233         }
 234
 235         return (0);
 236 }
 237
 238 int strsplit (char *string, char **fields, size_t size)
 239 {
 240         size_t i;
 241         char *ptr;
 242         char *saveptr;
 243
 244         i = 0;
 245         ptr = string;
 246         saveptr = NULL;
 247         while ((fields[i] = strtok_r (ptr, " \t\r\n", &saveptr)) != NULL)
 248         {
 249                 ptr = NULL;
 250                 i++;
 251
 252                 if (i >= size)
 253                         break;
 254         }
 255
 256         return (i);
 257 }
 258
 259 int strjoin (char *dst, size_t dst_len,
 260                 char **fields, size_t fields_num,
 261                 const char *sep)
 262 {
 263         size_t field_len;
 264         size_t sep_len;
 265         int i;
 266
 267         memset (dst, '\0', dst_len);
 268
 269         if (fields_num <= 0)
 270                 return (-1);
 271
 272         sep_len = 0;
 273         if (sep != NULL)
 274                 sep_len = strlen (sep);
 275
 276         for (i = 0; i < (int)fields_num; i++)
 277         {
 278                 if ((i > 0) && (sep_len > 0))
 279                 {
 280                         if (dst_len <= sep_len)
 281                                 return (-1);
 282
 283                         strncat (dst, sep, dst_len);
 284                         dst_len -= sep_len;
 285                 }
 286
 287                 field_len = strlen (fields[i]);
 288
 289                 if (dst_len <= field_len)
 290                         return (-1);
 291
 292                 strncat (dst, fields[i], dst_len);
 293                 dst_len -= field_len;
 294         }
 295
 296         return (strlen (dst));
 297 }
 298
 299 int strsubstitute (char *str, char c_from, char c_to)
 300 {
 301         int ret;
 302
 303         if (str == NULL)
 304                 return (-1);
 305
 306         ret = 0;
 307         while (*str != '\0')
 308         {
 309                 if (*str == c_from)
 310                 {
 311                         *str = c_to;
 312                         ret++;
 313                 }
 314                 str++;
 315         }
 316
 317         return (ret);
 318 } /* int strsubstitute */
 319
 320 int strunescape (char *buf, size_t buf_len)
 321 {
 322         size_t i;
 323
 324         for (i = 0; (i < buf_len) && (buf[i] != '\0'); ++i)
 325         {
 326                 if (buf[i] != '\\')
 327                         continue;
 328
 329                 if ((i >= buf_len) || (buf[i + 1] == '\0')) {
 330                         ERROR ("string unescape: backslash found at end of string.");
 331                         return (-1);
 332                 }
 333
 334                 switch (buf[i + 1]) {
 335                         case 't':
 336                                 buf[i] = '\t';
 337                                 break;
 338                         case 'n':
 339                                 buf[i] = '\n';
 340                                 break;
 341                         case 'r':
 342                                 buf[i] = '\r';
 343                                 break;
 344                         default:
 345                                 buf[i] = buf[i + 1];
 346                                 break;
 347                 }
 348
 349                 memmove (buf + i + 1, buf + i + 2, buf_len - i - 2);
 350         }
 351         return (0);
 352 } /* int strunescape */
 353
 354 int escape_slashes (char *buf, int buf_len)
 355 {
 356         int i;
 357
 358         if (strcmp (buf, "/") == 0)
 359         {
 360                 if (buf_len < 5)
 361                         return (-1);
 362
 363                 strncpy (buf, "root", buf_len);
 364                 return (0);
 365         }
 366
 367         if (buf_len <= 1)
 368                 return (0);
 369
 370         /* Move one to the left */
 371         if (buf[0] == '/')
 372                 memmove (buf, buf + 1, buf_len - 1);
 373
 374         for (i = 0; i < buf_len - 1; i++)
 375         {
 376                 if (buf[i] == '\0')
 377                         break;
 378                 else if (buf[i] == '/')
 379                         buf[i] = '_';
 380         }
 381         buf[i] = '\0';
 382
 383         return (0);
 384 } /* int escape_slashes */
 385
 386 void replace_special (char *buffer, size_t buffer_size)
 387 {
 388         size_t i;
 389
 390         for (i = 0; i < buffer_size; i++)
 391         {
 392                 if (buffer[i] == 0)
 393                         return;
 394                 if ((!isalnum ((int) buffer[i])) && (buffer[i] != '-'))
 395                         buffer[i] = '_';
 396         }
 397 } /* void replace_special */
 398
 399 int timeval_cmp (struct timeval tv0, struct timeval tv1, struct timeval *delta)
 400 {
 401         struct timeval *larger;
 402         struct timeval *smaller;
 403
 404         int status;
 405
 406         NORMALIZE_TIMEVAL (tv0);
 407         NORMALIZE_TIMEVAL (tv1);
 408
 409         if ((tv0.tv_sec == tv1.tv_sec) && (tv0.tv_usec == tv1.tv_usec))
 410         {
 411                 if (delta != NULL) {
 412                         delta->tv_sec  = 0;
 413                         delta->tv_usec = 0;
 414                 }
 415                 return (0);
 416         }
 417
 418         if ((tv0.tv_sec < tv1.tv_sec)
 419                         || ((tv0.tv_sec == tv1.tv_sec) && (tv0.tv_usec < tv1.tv_usec)))
 420         {
 421                 larger  = &tv1;
 422                 smaller = &tv0;
 423                 status  = -1;
 424         }
 425         else
 426         {
 427                 larger  = &tv0;
 428                 smaller = &tv1;
 429                 status  = 1;
 430         }
 431
 432         if (delta != NULL) {
 433                 delta->tv_sec = larger->tv_sec - smaller->tv_sec;
 434
 435                 if (smaller->tv_usec <= larger->tv_usec)
 436                         delta->tv_usec = larger->tv_usec - smaller->tv_usec;
 437                 else
 438                 {
 439                         --delta->tv_sec;
 440                         delta->tv_usec = 1000000 + larger->tv_usec - smaller->tv_usec;
 441                 }
 442         }
 443
 444         assert ((delta == NULL)
 445                         || ((0 <= delta->tv_usec) && (delta->tv_usec < 1000000)));
 446
 447         return (status);
 448 } /* int timeval_cmp */
 449
 450 int check_create_dir (const char *file_orig)
 451 {
 452         struct stat statbuf;
 453
 454         char  file_copy[512];
 455         char  dir[512];
 456         int   dir_len = 512;
 457         char *fields[16];
 458         int   fields_num;
 459         char *ptr;
 460         char *saveptr;
 461         int   last_is_file = 1;
 462         int   path_is_absolute = 0;
 463         size_t len;
 464         int   i;
 465
 466         /*
 467          * Sanity checks first
 468          */
 469         if (file_orig == NULL)
 470                 return (-1);
 471
 472         if ((len = strlen (file_orig)) < 1)
 473                 return (-1);
 474         else if (len >= sizeof (file_copy))
 475                 return (-1);
 476
 477         /*
 478          * If `file_orig' ends in a slash the last component is a directory,
 479          * otherwise it's a file. Act accordingly..
 480          */
 481         if (file_orig[len - 1] == '/')
 482                 last_is_file = 0;
 483         if (file_orig[0] == '/')
 484                 path_is_absolute = 1;
 485
 486         /*
 487          * Create a copy for `strtok_r' to destroy
 488          */
 489         sstrncpy (file_copy, file_orig, sizeof (file_copy));
 490
 491         /*
 492          * Break into components. This will eat up several slashes in a row and
 493          * remove leading and trailing slashes..
 494          */
 495         ptr = file_copy;
 496         saveptr = NULL;
 497         fields_num = 0;
 498         while ((fields[fields_num] = strtok_r (ptr, "/", &saveptr)) != NULL)
 499         {
 500                 ptr = NULL;
 501                 fields_num++;
 502
 503                 if (fields_num >= 16)
 504                         break;
 505         }
 506
 507         /*
 508          * For each component, do..
 509          */
 510         for (i = 0; i < (fields_num - last_is_file); i++)
 511         {
 512                 /*
 513                  * Do not create directories that start with a dot. This
 514                  * prevents `../../' attacks and other likely malicious
 515                  * behavior.
 516                  */
 517                 if (fields[i][0] == '.')
 518                 {
 519                         ERROR ("Cowardly refusing to create a directory that begins with a `.' (dot): `%s'", file_orig);
 520                         return (-2);
 521                 }
 522
 523                 /*
 524                  * Join the components together again
 525                  */
 526                 dir[0] = '/';
 527                 if (strjoin (dir + path_is_absolute, dir_len - path_is_absolute,
 528                                         fields, i + 1, "/") < 0)
 529                 {
 530                         ERROR ("strjoin failed: `%s', component #%i", file_orig, i);
 531                         return (-1);
 532                 }
 533
 534                 if (stat (dir, &statbuf) == -1)
 535                 {
 536                         if (errno == ENOENT)
 537                         {
 538                                 if (mkdir (dir, 0755) == -1)
 539                                 {
 540                                         char errbuf[1024];
 541                                         ERROR ("check_create_dir: mkdir (%s): %s", dir,
 542                                                         sstrerror (errno,
 543                                                                 errbuf, sizeof (errbuf)));
 544                                         return (-1);
 545                                 }
 546                         }
 547                         else
 548                         {
 549                                 char errbuf[1024];
 550                                 ERROR ("stat (%s): %s", dir,
 551                                                 sstrerror (errno, errbuf,
 552                                                         sizeof (errbuf)));
 553                                 return (-1);
 554                         }
 555                 }
 556                 else if (!S_ISDIR (statbuf.st_mode))
 557                 {
 558                         ERROR ("stat (%s): Not a directory!", dir);
 559                         return (-1);
 560                 }
 561         }
 562
 563         return (0);
 564 } /* check_create_dir */
 565
 566 #ifdef HAVE_LIBKSTAT
 567 int get_kstat (kstat_t **ksp_ptr, char *module, int instance, char *name)
 568 {
 569         char ident[128];
 570
 571         if (kc == NULL)
 572                 return (-1);
 573
 574         ssnprintf (ident, sizeof (ident), "%s,%i,%s", module, instance, name);
 575
 576         if (*ksp_ptr == NULL)
 577         {
 578                 if ((*ksp_ptr = kstat_lookup (kc, module, instance, name)) == NULL)
 579                 {
 580                         ERROR ("Cound not find kstat %s", ident);
 581                         return (-1);
 582                 }
 583
 584                 if ((*ksp_ptr)->ks_type != KSTAT_TYPE_NAMED)
 585                 {
 586                         WARNING ("kstat %s has wrong type", ident);
 587                         *ksp_ptr = NULL;
 588                         return (-1);
 589                 }
 590         }
 591
 592 #ifdef assert
 593         assert (*ksp_ptr != NULL);
 594         assert ((*ksp_ptr)->ks_type == KSTAT_TYPE_NAMED);
 595 #endif
 596
 597         if (kstat_read (kc, *ksp_ptr, NULL) == -1)
 598         {
 599                 WARNING ("kstat %s could not be read", ident);
 600                 return (-1);
 601         }
 602
 603         if ((*ksp_ptr)->ks_type != KSTAT_TYPE_NAMED)
 604         {
 605                 WARNING ("kstat %s has wrong type", ident);
 606                 return (-1);
 607         }
 608
 609         return (0);
 610 }
 611
 612 long long get_kstat_value (kstat_t *ksp, char *name)
 613 {
 614         kstat_named_t *kn;
 615         long long retval = -1LL;
 616
 617 #ifdef assert
 618         assert (ksp != NULL);
 619         assert (ksp->ks_type == KSTAT_TYPE_NAMED);
 620 #else
 621         if (ksp == NULL)
 622         {
 623                 ERROR ("ERROR: %s:%i: ksp == NULL\n", __FILE__, __LINE__);
 624                 return (-1LL);
 625         }
 626         else if (ksp->ks_type != KSTAT_TYPE_NAMED)
 627         {
 628                 ERROR ("ERROR: %s:%i: ksp->ks_type != KSTAT_TYPE_NAMED\n", __FILE__, __LINE__);
 629                 return (-1LL);
 630         }
 631 #endif
 632
 633         if ((kn = (kstat_named_t *) kstat_data_lookup (ksp, name)) == NULL)
 634                 return (retval);
 635
 636         if (kn->data_type == KSTAT_DATA_INT32)
 637                 retval = (long long) kn->value.i32;
 638         else if (kn->data_type == KSTAT_DATA_UINT32)
 639                 retval = (long long) kn->value.ui32;
 640         else if (kn->data_type == KSTAT_DATA_INT64)
 641                 retval = (long long) kn->value.i64; /* According to ANSI C99 `long long' must hold at least 64 bits */
 642         else if (kn->data_type == KSTAT_DATA_UINT64)
 643                 retval = (long long) kn->value.ui64; /* XXX: Might overflow! */
 644         else
 645                 WARNING ("get_kstat_value: Not a numeric value: %s", name);
 646
 647         return (retval);
 648 }
 649 #endif /* HAVE_LIBKSTAT */
 650
 651 unsigned long long ntohll (unsigned long long n)
 652 {
 653 #if BYTE_ORDER == BIG_ENDIAN
 654         return (n);
 655 #else
 656         return (((unsigned long long) ntohl (n)) << 32) + ntohl (n >> 32);
 657 #endif
 658 } /* unsigned long long ntohll */
 659
 660 unsigned long long htonll (unsigned long long n)
 661 {
 662 #if BYTE_ORDER == BIG_ENDIAN
 663         return (n);
 664 #else
 665         return (((unsigned long long) htonl (n)) << 32) + htonl (n >> 32);
 666 #endif
 667 } /* unsigned long long htonll */
 668
 669 #if FP_LAYOUT_NEED_NOTHING
 670 /* Well, we need nothing.. */
 671 /* #endif FP_LAYOUT_NEED_NOTHING */
 672
 673 #elif FP_LAYOUT_NEED_ENDIANFLIP || FP_LAYOUT_NEED_INTSWAP
 674 # if FP_LAYOUT_NEED_ENDIANFLIP
 675 #  define FP_CONVERT(A) ((((uint64_t)(A) & 0xff00000000000000LL) >> 56) | \
 676                          (((uint64_t)(A) & 0x00ff000000000000LL) >> 40) | \
 677                          (((uint64_t)(A) & 0x0000ff0000000000LL) >> 24) | \
 678                          (((uint64_t)(A) & 0x000000ff00000000LL) >> 8)  | \
 679                          (((uint64_t)(A) & 0x00000000ff000000LL) << 8)  | \
 680                          (((uint64_t)(A) & 0x0000000000ff0000LL) << 24) | \
 681                          (((uint64_t)(A) & 0x000000000000ff00LL) << 40) | \
 682                          (((uint64_t)(A) & 0x00000000000000ffLL) << 56))
 683 # else
 684 #  define FP_CONVERT(A) ((((uint64_t)(A) & 0xffffffff00000000LL) >> 32) | \
 685                          (((uint64_t)(A) & 0x00000000ffffffffLL) << 32))
 686 # endif
 687
 688 double ntohd (double d)
 689 {
 690         union
 691         {
 692                 uint8_t  byte[8];
 693                 uint64_t integer;
 694                 double   floating;
 695         } ret;
 696
 697         ret.floating = d;
 698
 699         /* NAN in x86 byte order */
 700         if ((ret.byte[0] == 0x00) && (ret.byte[1] == 0x00)
 701                         && (ret.byte[2] == 0x00) && (ret.byte[3] == 0x00)
 702                         && (ret.byte[4] == 0x00) && (ret.byte[5] == 0x00)
 703                         && (ret.byte[6] == 0xf8) && (ret.byte[7] == 0x7f))
 704         {
 705                 return (NAN);
 706         }
 707         else
 708         {
 709                 uint64_t tmp;
 710
 711                 tmp = ret.integer;
 712                 ret.integer = FP_CONVERT (tmp);
 713                 return (ret.floating);
 714         }
 715 } /* double ntohd */
 716
 717 double htond (double d)
 718 {
 719         union
 720         {
 721                 uint8_t  byte[8];
 722                 uint64_t integer;
 723                 double   floating;
 724         } ret;
 725
 726         if (isnan (d))
 727         {
 728                 ret.byte[0] = ret.byte[1] = ret.byte[2] = ret.byte[3] = 0x00;
 729                 ret.byte[4] = ret.byte[5] = 0x00;
 730                 ret.byte[6] = 0xf8;
 731                 ret.byte[7] = 0x7f;
 732                 return (ret.floating);
 733         }
 734         else
 735         {
 736                 uint64_t tmp;
 737
 738                 ret.floating = d;
 739                 tmp = FP_CONVERT (ret.integer);
 740                 ret.integer = tmp;
 741                 return (ret.floating);
 742         }
 743 } /* double htond */
 744 #endif /* FP_LAYOUT_NEED_ENDIANFLIP || FP_LAYOUT_NEED_INTSWAP */
 745
 746 int format_name (char *ret, int ret_len,
 747                 const char *hostname,
 748                 const char *plugin, const char *plugin_instance,
 749                 const char *type, const char *type_instance)
 750 {
 751         int  status;
 752
 753         assert (plugin != NULL);
 754         assert (type != NULL);
 755
 756         if ((plugin_instance == NULL) || (strlen (plugin_instance) == 0))
 757         {
 758                 if ((type_instance == NULL) || (strlen (type_instance) == 0))
 759                         status = ssnprintf (ret, ret_len, "%s/%s/%s",
 760                                         hostname, plugin, type);
 761                 else
 762                         status = ssnprintf (ret, ret_len, "%s/%s/%s-%s",
 763                                         hostname, plugin, type,
 764                                         type_instance);
 765         }
 766         else
 767         {
 768                 if ((type_instance == NULL) || (strlen (type_instance) == 0))
 769                         status = ssnprintf (ret, ret_len, "%s/%s-%s/%s",
 770                                         hostname, plugin, plugin_instance,
 771                                         type);
 772                 else
 773                         status = ssnprintf (ret, ret_len, "%s/%s-%s/%s-%s",
 774                                         hostname, plugin, plugin_instance,
 775                                         type, type_instance);
 776         }
 777
 778         if ((status < 1) || (status >= ret_len))
 779                 return (-1);
 780         return (0);
 781 } /* int format_name */
 782
 783 int parse_identifier (char *str, char **ret_host,
 784                 char **ret_plugin, char **ret_plugin_instance,
 785                 char **ret_type, char **ret_type_instance)
 786 {
 787         char *hostname = NULL;
 788         char *plugin = NULL;
 789         char *plugin_instance = NULL;
 790         char *type = NULL;
 791         char *type_instance = NULL;
 792
 793         hostname = str;
 794         if (hostname == NULL)
 795                 return (-1);
 796
 797         plugin = strchr (hostname, '/');
 798         if (plugin == NULL)
 799                 return (-1);
 800         *plugin = '\0'; plugin++;
 801
 802         type = strchr (plugin, '/');
 803         if (type == NULL)
 804                 return (-1);
 805         *type = '\0'; type++;
 806
 807         plugin_instance = strchr (plugin, '-');
 808         if (plugin_instance != NULL)
 809         {
 810                 *plugin_instance = '\0';
 811                 plugin_instance++;
 812         }
 813
 814         type_instance = strchr (type, '-');
 815         if (type_instance != NULL)
 816         {
 817                 *type_instance = '\0';
 818                 type_instance++;
 819         }
 820
 821         *ret_host = hostname;
 822         *ret_plugin = plugin;
 823         *ret_plugin_instance = plugin_instance;
 824         *ret_type = type;
 825         *ret_type_instance = type_instance;
 826         return (0);
 827 } /* int parse_identifier */
 828
 829 int parse_value (const char *value, value_t *ret_value, const data_source_t ds)
 830 {
 831         char *endptr = NULL;
 832
 833         if (DS_TYPE_COUNTER == ds.type)
 834                 ret_value->counter = (counter_t)strtoll (value, &endptr, 0);
 835         else if (DS_TYPE_GAUGE == ds.type)
 836                 ret_value->gauge = (gauge_t)strtod (value, &endptr);
 837         else {
 838                 ERROR ("parse_value: Invalid data source \"%s\" "
 839                                 "(type = %i).", ds.name, ds.type);
 840                 return -1;
 841         }
 842
 843         if (value == endptr) {
 844                 ERROR ("parse_value: Failed to parse string as number: %s.", value);
 845                 return -1;
 846         }
 847         else if ((NULL != endptr) && ('\0' != *endptr))
 848                 WARNING ("parse_value: Ignoring trailing garbage after number: %s.",
 849                                 endptr);
 850         return 0;
 851 } /* int parse_value */
 852
 853 int parse_values (char *buffer, value_list_t *vl, const data_set_t *ds)
 854 {
 855         int i;
 856         char *dummy;
 857         char *ptr;
 858         char *saveptr;
 859
 860         i = -1;
 861         dummy = buffer;
 862         saveptr = NULL;
 863         while ((ptr = strtok_r (dummy, ":", &saveptr)) != NULL)
 864         {
 865                 dummy = NULL;
 866
 867                 if (i >= vl->values_len)
 868                         break;
 869
 870                 if (i == -1)
 871                 {
 872                         if (strcmp ("N", ptr) == 0)
 873                                 vl->time = time (NULL);
 874                         else
 875                                 vl->time = (time_t) atoi (ptr);
 876                 }
 877                 else
 878                 {
 879                         if ((strcmp ("U", ptr) == 0) && (ds->ds[i].type == DS_TYPE_GAUGE))
 880                                 vl->values[i].gauge = NAN;
 881                         else if (0 != parse_value (ptr, &vl->values[i], ds->ds[i]))
 882                                 return -1;
 883                 }
 884
 885                 i++;
 886         } /* while (strtok_r) */
 887
 888         if ((ptr != NULL) || (i != vl->values_len))
 889                 return (-1);
 890         return (0);
 891 } /* int parse_values */
 892
 893 #if !HAVE_GETPWNAM_R
 894 int getpwnam_r (const char *name, struct passwd *pwbuf, char *buf,
 895                 size_t buflen, struct passwd **pwbufp)
 896 {
 897         int status = 0;
 898         struct passwd *pw;
 899
 900         memset (pwbuf, '\0', sizeof (struct passwd));
 901
 902         pthread_mutex_lock (&getpwnam_r_lock);
 903
 904         do
 905         {
 906                 pw = getpwnam (name);
 907                 if (pw == NULL)
 908                 {
 909                         status = (errno != 0) ? errno : ENOENT;
 910                         break;
 911                 }
 912
 913 #define GETPWNAM_COPY_MEMBER(member) \
 914                 if (pw->member != NULL) \
 915                 { \
 916                         int len = strlen (pw->member); \
 917                         if (len >= buflen) \
 918                         { \
 919                                 status = ENOMEM; \
 920                                 break; \
 921                         } \
 922                         sstrncpy (buf, pw->member, buflen); \
 923                         pwbuf->member = buf; \
 924                         buf    += (len + 1); \
 925                         buflen -= (len + 1); \
 926                 }
 927                 GETPWNAM_COPY_MEMBER(pw_name);
 928                 GETPWNAM_COPY_MEMBER(pw_passwd);
 929                 GETPWNAM_COPY_MEMBER(pw_gecos);
 930                 GETPWNAM_COPY_MEMBER(pw_dir);
 931                 GETPWNAM_COPY_MEMBER(pw_shell);
 932
 933                 pwbuf->pw_uid = pw->pw_uid;
 934                 pwbuf->pw_gid = pw->pw_gid;
 935
 936                 if (pwbufp != NULL)
 937                         *pwbufp = pwbuf;
 938         } while (0);
 939
 940         pthread_mutex_unlock (&getpwnam_r_lock);
 941
 942         return (status);
 943 } /* int getpwnam_r */
 944 #endif /* !HAVE_GETPWNAM_R */
 945
 946 int notification_init (notification_t *n, int severity, const char *message,
 947                 const char *host,
 948                 const char *plugin, const char *plugin_instance,
 949                 const char *type, const char *type_instance)
 950 {
 951         memset (n, '\0', sizeof (notification_t));
 952
 953         n->severity = severity;
 954
 955         if (message != NULL)
 956                 sstrncpy (n->message, message, sizeof (n->message));
 957         if (host != NULL)
 958                 sstrncpy (n->host, host, sizeof (n->host));
 959         if (plugin != NULL)
 960                 sstrncpy (n->plugin, plugin, sizeof (n->plugin));
 961         if (plugin_instance != NULL)
 962                 sstrncpy (n->plugin_instance, plugin_instance,
 963                                 sizeof (n->plugin_instance));
 964         if (type != NULL)
 965                 sstrncpy (n->type, type, sizeof (n->type));
 966         if (type_instance != NULL)
 967                 sstrncpy (n->type_instance, type_instance,
 968                                 sizeof (n->type_instance));
 969
 970         return (0);
 971 } /* int notification_init */
 972
 973 int walk_directory (const char *dir, dirwalk_callback_f callback,
 974                 void *user_data)
 975 {
 976         struct dirent *ent;
 977         DIR *dh;
 978         int success;
 979         int failure;
 980
 981         success = 0;
 982         failure = 0;
 983
 984         if ((dh = opendir (dir)) == NULL)
 985         {
 986                 char errbuf[1024];
 987                 ERROR ("walk_directory: Cannot open '%s': %s", dir,
 988                                 sstrerror (errno, errbuf, sizeof (errbuf)));
 989                 return -1;
 990         }
 991
 992         while ((ent = readdir (dh)) != NULL)
 993         {
 994                 int status;
 995
 996                 if (ent->d_name[0] == '.')
 997                         continue;
 998
 999                 status = (*callback) (dir, ent->d_name, user_data);
1000                 if (status != 0)
1001                         failure++;
1002                 else
1003                         success++;
1004         }
1005
1006         closedir (dh);
1007
1008         if ((success == 0) && (failure > 0))
1009                 return (-1);
1010         return (0);
1011 }
1012
1013 int read_file_contents (const char *filename, char *buf, int bufsize)
1014 {
1015         FILE *fh;
1016         int n;
1017
1018         if ((fh = fopen (filename, "r")) == NULL)
1019                 return -1;
1020
1021         n = fread(buf, 1, bufsize, fh);
1022         fclose(fh);
1023
1024         return n;
1025 }
1026
1027 counter_t counter_diff (counter_t old_value, counter_t new_value)
1028 {
1029         counter_t diff;
1030
1031         if (old_value > new_value)
1032         {
1033                 if (old_value <= 4294967295U)
1034                         diff = (4294967295U - old_value) + new_value;
1035                 else
1036                         diff = (18446744073709551615ULL - old_value)
1037                                 + new_value;
1038         }
1039         else
1040         {
1041                 diff = new_value - old_value;
1042         }
1043
1044         return (diff);
1045 } /* counter_t counter_to_gauge */