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