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 **/
30 #if HAVE_CONFIG_H
31 # include "config.h"
32 #endif
34 #include "collectd.h"
35 #include "common.h"
36 #include "plugin.h"
37 #include "utils_cache.h"
39 #if HAVE_PTHREAD_H
40 # include <pthread.h>
41 #endif
43 #ifdef HAVE_MATH_H
44 # include <math.h>
45 #endif
47 /* for getaddrinfo */
48 #include <sys/types.h>
49 #include <sys/socket.h>
50 #include <netdb.h>
52 #include <poll.h>
54 #if HAVE_NETINET_IN_H
55 # include <netinet/in.h>
56 #endif
58 /* for ntohl and htonl */
59 #if HAVE_ARPA_INET_H
60 # include <arpa/inet.h>
61 #endif
63 #ifdef HAVE_LIBKSTAT
64 extern kstat_ctl_t *kc;
65 #endif
67 #if !HAVE_GETPWNAM_R
68 static pthread_mutex_t getpwnam_r_lock = PTHREAD_MUTEX_INITIALIZER;
69 #endif
71 #if !HAVE_STRERROR_R
72 static pthread_mutex_t strerror_r_lock = PTHREAD_MUTEX_INITIALIZER;
73 #endif
75 char *sstrncpy (char *dest, const char *src, size_t n)
76 {
77 strncpy (dest, src, n);
78 dest[n - 1] = '\0';
80 return (dest);
81 } /* char *sstrncpy */
83 int ssnprintf (char *dest, size_t n, const char *format, ...)
84 {
85 int ret = 0;
86 va_list ap;
88 va_start (ap, format);
89 ret = vsnprintf (dest, n, format, ap);
90 dest[n - 1] = '\0';
91 va_end (ap);
93 return (ret);
94 } /* int ssnprintf */
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;
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);
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));
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);
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 }
134 return (alloc_buffer);
135 } /* }}} char *ssnprintf_alloc */
137 char *sstrdup (const char *s)
138 {
139 char *r;
140 size_t sz;
142 if (s == NULL)
143 return (NULL);
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);
156 return (r);
157 } /* char *sstrdup */
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';
166 #if !HAVE_STRERROR_R
167 {
168 char *temp;
170 pthread_mutex_lock (&strerror_r_lock);
172 temp = strerror (errnum);
173 sstrncpy (buf, temp, buflen);
175 pthread_mutex_unlock (&strerror_r_lock);
176 }
177 /* #endif !HAVE_STRERROR_R */
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 */
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 */
203 return (buf);
204 } /* char *sstrerror */
206 void *smalloc (size_t size)
207 {
208 void *r;
210 if ((r = malloc (size)) == NULL)
211 {
212 ERROR ("Not enough memory.");
213 exit (3);
214 }
216 return (r);
217 } /* void *smalloc */
219 #if 0
220 void sfree (void **ptr)
221 {
222 if (ptr == NULL)
223 return;
225 if (*ptr != NULL)
226 free (*ptr);
228 *ptr = NULL;
229 }
230 #endif
232 ssize_t sread (int fd, void *buf, size_t count)
233 {
234 char *ptr;
235 size_t nleft;
236 ssize_t status;
238 ptr = (char *) buf;
239 nleft = count;
241 while (nleft > 0)
242 {
243 status = read (fd, (void *) ptr, nleft);
245 if ((status < 0) && ((errno == EAGAIN) || (errno == EINTR)))
246 continue;
248 if (status < 0)
249 return (status);
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 }
260 assert ((0 > status) || (nleft >= (size_t)status));
262 nleft = nleft - status;
263 ptr = ptr + status;
264 }
266 return (0);
267 }
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;
277 ptr = (const char *) buf;
278 nleft = count;
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 }
293 while (nleft > 0)
294 {
295 status = write (fd, (const void *) ptr, nleft);
297 if ((status < 0) && ((errno == EAGAIN) || (errno == EINTR)))
298 continue;
300 if (status < 0)
301 return (status);
303 nleft = nleft - status;
304 ptr = ptr + status;
305 }
307 return (0);
308 }
310 int strsplit (char *string, char **fields, size_t size)
311 {
312 size_t i;
313 char *ptr;
314 char *saveptr;
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++;
324 if (i >= size)
325 break;
326 }
328 return ((int) i);
329 }
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;
340 if ((buffer_size < 1) || (fields_num <= 0))
341 return (-1);
343 memset (buffer, 0, buffer_size);
344 ptr = buffer;
345 avail = buffer_size - 1;
347 sep_len = 0;
348 if (sep != NULL)
349 sep_len = strlen (sep);
351 for (i = 0; i < fields_num; i++)
352 {
353 size_t field_len;
355 if ((i > 0) && (sep_len > 0))
356 {
357 if (avail < sep_len)
358 return (-1);
360 memcpy (ptr, sep, sep_len);
361 ptr += sep_len;
362 avail -= sep_len;
363 }
365 field_len = strlen (fields[i]);
366 if (avail < field_len)
367 return (-1);
369 memcpy (ptr, fields[i], field_len);
370 ptr += field_len;
371 avail -= field_len;
372 }
374 assert (buffer[buffer_size - 1] == 0);
375 return (strlen (buffer));
376 }
378 int strsubstitute (char *str, char c_from, char c_to)
379 {
380 int ret;
382 if (str == NULL)
383 return (-1);
385 ret = 0;
386 while (*str != '\0')
387 {
388 if (*str == c_from)
389 {
390 *str = c_to;
391 ret++;
392 }
393 str++;
394 }
396 return (ret);
397 } /* int strsubstitute */
399 int escape_string (char *buffer, size_t buffer_size)
400 {
401 char *temp;
402 size_t i;
403 size_t j;
405 /* Check if we need to escape at all first */
406 temp = strpbrk (buffer, " \t\"\\");
407 if (temp == NULL)
408 return (0);
410 if (buffer_size < 3)
411 return (EINVAL);
413 temp = (char *) malloc (buffer_size);
414 if (temp == NULL)
415 return (ENOMEM);
416 memset (temp, 0, buffer_size);
418 temp[0] = '"';
419 j = 1;
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 }
444 assert ((j + 1) < buffer_size);
445 temp[j] = '"';
446 temp[j + 1] = 0;
448 sstrncpy (buffer, temp, buffer_size);
449 sfree (temp);
450 return (0);
451 } /* int escape_string */
453 int strunescape (char *buf, size_t buf_len)
454 {
455 size_t i;
457 for (i = 0; (i < buf_len) && (buf[i] != '\0'); ++i)
458 {
459 if (buf[i] != '\\')
460 continue;
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 }
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 }
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 */
492 size_t strstripnewline (char *buffer)
493 {
494 size_t buffer_len = strlen (buffer);
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 }
505 return (buffer_len);
506 } /* size_t strstripnewline */
508 int escape_slashes (char *buffer, size_t buffer_size)
509 {
510 int i;
511 size_t buffer_len;
513 buffer_len = strlen (buffer);
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 }
526 /* Move one to the left */
527 if (buffer[0] == '/')
528 {
529 memmove (buffer, buffer + 1, buffer_len);
530 buffer_len--;
531 }
533 for (i = 0; i < buffer_len; i++)
534 {
535 if (buffer[i] == '/')
536 buffer[i] = '_';
537 }
539 return (0);
540 } /* int escape_slashes */
542 void replace_special (char *buffer, size_t buffer_size)
543 {
544 size_t i;
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 */
555 int timeval_cmp (struct timeval tv0, struct timeval tv1, struct timeval *delta)
556 {
557 struct timeval *larger;
558 struct timeval *smaller;
560 int status;
562 NORMALIZE_TIMEVAL (tv0);
563 NORMALIZE_TIMEVAL (tv1);
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 }
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 }
588 if (delta != NULL) {
589 delta->tv_sec = larger->tv_sec - smaller->tv_sec;
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 }
600 assert ((delta == NULL)
601 || ((0 <= delta->tv_usec) && (delta->tv_usec < 1000000)));
603 return (status);
604 } /* int timeval_cmp */
606 int check_create_dir (const char *file_orig)
607 {
608 struct stat statbuf;
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;
622 /*
623 * Sanity checks first
624 */
625 if (file_orig == NULL)
626 return (-1);
628 if ((len = strlen (file_orig)) < 1)
629 return (-1);
630 else if (len >= sizeof (file_copy))
631 return (-1);
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;
642 /*
643 * Create a copy for `strtok_r' to destroy
644 */
645 sstrncpy (file_copy, file_orig, sizeof (file_copy));
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++;
659 if (fields_num >= 16)
660 break;
661 }
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 }
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 }
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;
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;
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 }
731 return (0);
732 } /* check_create_dir */
734 #ifdef HAVE_LIBKSTAT
735 int get_kstat (kstat_t **ksp_ptr, char *module, int instance, char *name)
736 {
737 char ident[128];
739 *ksp_ptr = NULL;
741 if (kc == NULL)
742 return (-1);
744 ssnprintf (ident, sizeof (ident), "%s,%i,%s", module, instance, name);
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 }
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 }
760 #ifdef assert
761 assert (*ksp_ptr != NULL);
762 assert ((*ksp_ptr)->ks_type == KSTAT_TYPE_NAMED);
763 #endif
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 }
771 if ((*ksp_ptr)->ks_type != KSTAT_TYPE_NAMED)
772 {
773 ERROR ("get_kstat: kstat %s has wrong type", ident);
774 return (-1);
775 }
777 return (0);
778 }
780 long long get_kstat_value (kstat_t *ksp, char *name)
781 {
782 kstat_named_t *kn;
783 long long retval = -1LL;
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 }
800 if ((kn = (kstat_named_t *) kstat_data_lookup (ksp, name)) == NULL)
801 return (-1LL);
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);
814 return (retval);
815 }
816 #endif /* HAVE_LIBKSTAT */
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 */
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 */
838 #if FP_LAYOUT_NEED_NOTHING
839 /* Well, we need nothing.. */
840 /* #endif FP_LAYOUT_NEED_NOTHING */
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
857 double ntohd (double d)
858 {
859 union
860 {
861 uint8_t byte[8];
862 uint64_t integer;
863 double floating;
864 } ret;
866 ret.floating = d;
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;
880 tmp = ret.integer;
881 ret.integer = FP_CONVERT (tmp);
882 return (ret.floating);
883 }
884 } /* double ntohd */
886 double htond (double d)
887 {
888 union
889 {
890 uint8_t byte[8];
891 uint64_t integer;
892 double floating;
893 } ret;
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;
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 */
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;
923 buffer = ret;
924 buffer_size = (size_t) ret_len;
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)
934 assert (plugin != NULL);
935 assert (type != NULL);
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;
955 #undef APPEND
956 return (0);
957 } /* int format_name */
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;
968 assert (0 == strcmp (ds->type, vl->type));
970 memset (ret, 0, ret_len);
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)
989 BUFFER_ADD ("%.3f", CDTIME_T_TO_DOUBLE (vl->time));
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 */
1021 #undef BUFFER_ADD
1023 sfree (rates);
1024 return (0);
1025 } /* }}} int format_values */
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;
1037 hostname = str;
1038 if (hostname == NULL)
1039 return (-1);
1041 plugin = strchr (hostname, '/');
1042 if (plugin == NULL)
1043 return (-1);
1044 *plugin = '\0'; plugin++;
1046 type = strchr (plugin, '/');
1047 if (type == NULL)
1048 return (-1);
1049 *type = '\0'; type++;
1051 plugin_instance = strchr (plugin, '-');
1052 if (plugin_instance != NULL)
1053 {
1054 *plugin_instance = '\0';
1055 plugin_instance++;
1056 }
1058 type_instance = strchr (type, '-');
1059 if (type_instance != NULL)
1060 {
1061 *type_instance = '\0';
1062 type_instance++;
1063 }
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 */
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;
1083 if ((str == NULL) || (vl == NULL))
1084 return (EINVAL);
1086 sstrncpy (str_copy, str, sizeof (str_copy));
1088 status = parse_identifier (str_copy, &host,
1089 &plugin, &plugin_instance,
1090 &type, &type_instance);
1091 if (status != 0)
1092 return (status);
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));
1104 return (0);
1105 } /* }}} int parse_identifier_vl */
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;
1113 if (value_orig == NULL)
1114 return (EINVAL);
1116 value = strdup (value_orig);
1117 if (value == NULL)
1118 return (ENOMEM);
1119 value_len = strlen (value);
1121 while ((value_len > 0) && isspace ((int) value[value_len - 1]))
1122 {
1123 value[value_len - 1] = 0;
1124 value_len--;
1125 }
1127 switch (ds_type)
1128 {
1129 case DS_TYPE_COUNTER:
1130 ret_value->counter = (counter_t) strtoull (value, &endptr, 0);
1131 break;
1133 case DS_TYPE_GAUGE:
1134 ret_value->gauge = (gauge_t) strtod (value, &endptr);
1135 break;
1137 case DS_TYPE_DERIVE:
1138 ret_value->derive = (derive_t) strtoll (value, &endptr, 0);
1139 break;
1141 case DS_TYPE_ABSOLUTE:
1142 ret_value->absolute = (absolute_t) strtoull (value, &endptr, 0);
1143 break;
1145 default:
1146 sfree (value);
1147 ERROR ("parse_value: Invalid data source type: %i.", ds_type);
1148 return -1;
1149 }
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);
1162 sfree (value);
1163 return 0;
1164 } /* int parse_value */
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;
1173 if ((buffer == NULL) || (vl == NULL) || (ds == NULL))
1174 return EINVAL;
1176 i = -1;
1177 dummy = buffer;
1178 saveptr = NULL;
1179 while ((ptr = strtok_r (dummy, ":", &saveptr)) != NULL)
1180 {
1181 dummy = NULL;
1183 if (i >= vl->values_len)
1184 {
1185 /* Make sure i is invalid. */
1186 i = vl->values_len + 1;
1187 break;
1188 }
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;
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);
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 }
1218 i++;
1219 } /* while (strtok_r) */
1221 if ((ptr != NULL) || (i != vl->values_len))
1222 return (-1);
1223 return (0);
1224 } /* int parse_values */
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;
1233 memset (pwbuf, '\0', sizeof (struct passwd));
1235 pthread_mutex_lock (&getpwnam_r_lock);
1237 do
1238 {
1239 pw = getpwnam (name);
1240 if (pw == NULL)
1241 {
1242 status = (errno != 0) ? errno : ENOENT;
1243 break;
1244 }
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);
1266 pwbuf->pw_uid = pw->pw_uid;
1267 pwbuf->pw_gid = pw->pw_gid;
1269 if (pwbufp != NULL)
1270 *pwbufp = pwbuf;
1271 } while (0);
1273 pthread_mutex_unlock (&getpwnam_r_lock);
1275 return (status);
1276 } /* int getpwnam_r */
1277 #endif /* !HAVE_GETPWNAM_R */
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));
1286 n->severity = severity;
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));
1303 return (0);
1304 } /* int notification_init */
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;
1314 success = 0;
1315 failure = 0;
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 }
1325 while ((ent = readdir (dh)) != NULL)
1326 {
1327 int status;
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 }
1341 status = (*callback) (dir, ent->d_name, user_data);
1342 if (status != 0)
1343 failure++;
1344 else
1345 success++;
1346 }
1348 closedir (dh);
1350 if ((success == 0) && (failure > 0))
1351 return (-1);
1352 return (0);
1353 }
1355 ssize_t read_file_contents (const char *filename, char *buf, size_t bufsize)
1356 {
1357 FILE *fh;
1358 ssize_t ret;
1360 fh = fopen (filename, "r");
1361 if (fh == NULL)
1362 return (-1);
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 }
1372 fclose(fh);
1373 return (ret);
1374 }
1376 counter_t counter_diff (counter_t old_value, counter_t new_value)
1377 {
1378 counter_t diff;
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 }
1393 return (diff);
1394 } /* counter_t counter_diff */
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;
1403 if (ds_type == DS_TYPE_GAUGE)
1404 {
1405 state->last_value.gauge = rate;
1406 state->last_time = t;
1408 *ret_value = state->last_value;
1409 return (0);
1410 }
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 }
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 }
1430 delta_t = t - state->last_time;
1431 delta_gauge = (rate * CDTIME_T_TO_DOUBLE (delta_t)) + state->residual;
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 }
1456 state->last_time = t;
1457 return (EAGAIN);
1458 } /* }}} */
1460 if (ds_type == DS_TYPE_DERIVE)
1461 {
1462 derive_t delta_derive = (derive_t) delta_gauge;
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;
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;
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 }
1486 state->last_time = t;
1487 *ret_value = state->last_value;
1488 return (0);
1489 } /* }}} value_t rate_to_value */
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;
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 }
1504 interval = CDTIME_T_TO_DOUBLE(t - state->last_time);
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 }
1526 state->last_time = t;
1527 return (EAGAIN);
1528 } /* }}} */
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 }
1550 state->last_time = t;
1551 return (0);
1552 } /* }}} value_t rate_to_value */
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;
1562 if (service_name == NULL)
1563 return (-1);
1565 ai_list = NULL;
1566 memset (&ai_hints, 0, sizeof (ai_hints));
1567 ai_hints.ai_family = AF_UNSPEC;
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 }
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;
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;
1592 sa = (void *) ai_ptr->ai_addr;
1593 service_number = (int) ntohs (sa->sin6_port);
1594 }
1596 if ((service_number > 0) && (service_number <= 65535))
1597 break;
1598 }
1600 freeaddrinfo (ai_list);
1602 if ((service_number > 0) && (service_number <= 65535))
1603 return (service_number);
1604 return (-1);
1605 } /* int service_name_to_port_number */
1607 int strtoderive (const char *string, derive_t *ret_value) /* {{{ */
1608 {
1609 derive_t tmp;
1610 char *endptr;
1612 if ((string == NULL) || (ret_value == NULL))
1613 return (EINVAL);
1615 errno = 0;
1616 endptr = NULL;
1617 tmp = (derive_t) strtoll (string, &endptr, /* base = */ 0);
1618 if ((endptr == string) || (errno != 0))
1619 return (-1);
1621 *ret_value = tmp;
1622 return (0);
1623 } /* }}} int strtoderive */
1625 int strtogauge (const char *string, gauge_t *ret_value) /* {{{ */
1626 {
1627 gauge_t tmp;
1628 char *endptr = NULL;
1630 if ((string == NULL) || (ret_value == NULL))
1631 return (EINVAL);
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);
1641 *ret_value = tmp;
1642 return (0);
1643 } /* }}} int strtogauge */
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;
1650 if (str == NULL)
1651 return (EINVAL);
1653 array = realloc (*ret_array,
1654 (array_len + 1) * sizeof (*array));
1655 if (array == NULL)
1656 return (ENOMEM);
1657 *ret_array = array;
1659 array[array_len] = strdup (str);
1660 if (array[array_len] == NULL)
1661 return (ENOMEM);
1663 array_len++;
1664 *ret_array_len = array_len;
1665 return (0);
1666 } /* }}} int strarray_add */
1668 void strarray_free (char **array, size_t array_len) /* {{{ */
1669 {
1670 size_t i;
1672 for (i = 0; i < array_len; i++)
1673 sfree (array[i]);
1674 sfree (array);
1675 } /* }}} void strarray_free */