src/common.c

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