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 i = -1;
1174 dummy = buffer;
1175 saveptr = NULL;
1176 while ((ptr = strtok_r (dummy, ":", &saveptr)) != NULL)
1177 {
1178 dummy = NULL;
1180 if (i >= vl->values_len)
1181 {
1182 /* Make sure i is invalid. */
1183 i = vl->values_len + 1;
1184 break;
1185 }
1187 if (i == -1)
1188 {
1189 if (strcmp ("N", ptr) == 0)
1190 vl->time = cdtime ();
1191 else
1192 {
1193 char *endptr = NULL;
1194 double tmp;
1196 errno = 0;
1197 tmp = strtod (ptr, &endptr);
1198 if ((errno != 0) /* Overflow */
1199 || (endptr == ptr) /* Invalid string */
1200 || (endptr == NULL) /* This should not happen */
1201 || (*endptr != 0)) /* Trailing chars */
1202 return (-1);
1204 vl->time = DOUBLE_TO_CDTIME_T (tmp);
1205 }
1206 }
1207 else
1208 {
1209 if ((strcmp ("U", ptr) == 0) && (ds->ds[i].type == DS_TYPE_GAUGE))
1210 vl->values[i].gauge = NAN;
1211 else if (0 != parse_value (ptr, &vl->values[i], ds->ds[i].type))
1212 return -1;
1213 }
1215 i++;
1216 } /* while (strtok_r) */
1218 if ((ptr != NULL) || (i != vl->values_len))
1219 return (-1);
1220 return (0);
1221 } /* int parse_values */
1223 #if !HAVE_GETPWNAM_R
1224 int getpwnam_r (const char *name, struct passwd *pwbuf, char *buf,
1225 size_t buflen, struct passwd **pwbufp)
1226 {
1227 int status = 0;
1228 struct passwd *pw;
1230 memset (pwbuf, '\0', sizeof (struct passwd));
1232 pthread_mutex_lock (&getpwnam_r_lock);
1234 do
1235 {
1236 pw = getpwnam (name);
1237 if (pw == NULL)
1238 {
1239 status = (errno != 0) ? errno : ENOENT;
1240 break;
1241 }
1243 #define GETPWNAM_COPY_MEMBER(member) \
1244 if (pw->member != NULL) \
1245 { \
1246 int len = strlen (pw->member); \
1247 if (len >= buflen) \
1248 { \
1249 status = ENOMEM; \
1250 break; \
1251 } \
1252 sstrncpy (buf, pw->member, buflen); \
1253 pwbuf->member = buf; \
1254 buf += (len + 1); \
1255 buflen -= (len + 1); \
1256 }
1257 GETPWNAM_COPY_MEMBER(pw_name);
1258 GETPWNAM_COPY_MEMBER(pw_passwd);
1259 GETPWNAM_COPY_MEMBER(pw_gecos);
1260 GETPWNAM_COPY_MEMBER(pw_dir);
1261 GETPWNAM_COPY_MEMBER(pw_shell);
1263 pwbuf->pw_uid = pw->pw_uid;
1264 pwbuf->pw_gid = pw->pw_gid;
1266 if (pwbufp != NULL)
1267 *pwbufp = pwbuf;
1268 } while (0);
1270 pthread_mutex_unlock (&getpwnam_r_lock);
1272 return (status);
1273 } /* int getpwnam_r */
1274 #endif /* !HAVE_GETPWNAM_R */
1276 int notification_init (notification_t *n, int severity, const char *message,
1277 const char *host,
1278 const char *plugin, const char *plugin_instance,
1279 const char *type, const char *type_instance)
1280 {
1281 memset (n, '\0', sizeof (notification_t));
1283 n->severity = severity;
1285 if (message != NULL)
1286 sstrncpy (n->message, message, sizeof (n->message));
1287 if (host != NULL)
1288 sstrncpy (n->host, host, sizeof (n->host));
1289 if (plugin != NULL)
1290 sstrncpy (n->plugin, plugin, sizeof (n->plugin));
1291 if (plugin_instance != NULL)
1292 sstrncpy (n->plugin_instance, plugin_instance,
1293 sizeof (n->plugin_instance));
1294 if (type != NULL)
1295 sstrncpy (n->type, type, sizeof (n->type));
1296 if (type_instance != NULL)
1297 sstrncpy (n->type_instance, type_instance,
1298 sizeof (n->type_instance));
1300 return (0);
1301 } /* int notification_init */
1303 int walk_directory (const char *dir, dirwalk_callback_f callback,
1304 void *user_data, int include_hidden)
1305 {
1306 struct dirent *ent;
1307 DIR *dh;
1308 int success;
1309 int failure;
1311 success = 0;
1312 failure = 0;
1314 if ((dh = opendir (dir)) == NULL)
1315 {
1316 char errbuf[1024];
1317 ERROR ("walk_directory: Cannot open '%s': %s", dir,
1318 sstrerror (errno, errbuf, sizeof (errbuf)));
1319 return -1;
1320 }
1322 while ((ent = readdir (dh)) != NULL)
1323 {
1324 int status;
1326 if (include_hidden)
1327 {
1328 if ((strcmp (".", ent->d_name) == 0)
1329 || (strcmp ("..", ent->d_name) == 0))
1330 continue;
1331 }
1332 else /* if (!include_hidden) */
1333 {
1334 if (ent->d_name[0]=='.')
1335 continue;
1336 }
1338 status = (*callback) (dir, ent->d_name, user_data);
1339 if (status != 0)
1340 failure++;
1341 else
1342 success++;
1343 }
1345 closedir (dh);
1347 if ((success == 0) && (failure > 0))
1348 return (-1);
1349 return (0);
1350 }
1352 ssize_t read_file_contents (const char *filename, char *buf, size_t bufsize)
1353 {
1354 FILE *fh;
1355 ssize_t ret;
1357 fh = fopen (filename, "r");
1358 if (fh == NULL)
1359 return (-1);
1361 ret = (ssize_t) fread (buf, 1, bufsize, fh);
1362 if ((ret == 0) && (ferror (fh) != 0))
1363 {
1364 ERROR ("read_file_contents: Reading file \"%s\" failed.",
1365 filename);
1366 ret = -1;
1367 }
1369 fclose(fh);
1370 return (ret);
1371 }
1373 counter_t counter_diff (counter_t old_value, counter_t new_value)
1374 {
1375 counter_t diff;
1377 if (old_value > new_value)
1378 {
1379 if (old_value <= 4294967295U)
1380 diff = (4294967295U - old_value) + new_value;
1381 else
1382 diff = (18446744073709551615ULL - old_value)
1383 + new_value;
1384 }
1385 else
1386 {
1387 diff = new_value - old_value;
1388 }
1390 return (diff);
1391 } /* counter_t counter_diff */
1393 int rate_to_value (value_t *ret_value, gauge_t rate, /* {{{ */
1394 rate_to_value_state_t *state,
1395 int ds_type, cdtime_t t)
1396 {
1397 gauge_t delta_gauge;
1398 cdtime_t delta_t;
1400 if (ds_type == DS_TYPE_GAUGE)
1401 {
1402 state->last_value.gauge = rate;
1403 state->last_time = t;
1405 *ret_value = state->last_value;
1406 return (0);
1407 }
1409 /* Counter and absolute can't handle negative rates. Reset "last time"
1410 * to zero, so that the next valid rate will re-initialize the
1411 * structure. */
1412 if ((rate < 0.0)
1413 && ((ds_type == DS_TYPE_COUNTER)
1414 || (ds_type == DS_TYPE_ABSOLUTE)))
1415 {
1416 memset (state, 0, sizeof (*state));
1417 return (EINVAL);
1418 }
1420 /* Another invalid state: The time is not increasing. */
1421 if (t <= state->last_time)
1422 {
1423 memset (state, 0, sizeof (*state));
1424 return (EINVAL);
1425 }
1427 delta_t = t - state->last_time;
1428 delta_gauge = (rate * CDTIME_T_TO_DOUBLE (delta_t)) + state->residual;
1430 /* Previous value is invalid. */
1431 if (state->last_time == 0) /* {{{ */
1432 {
1433 if (ds_type == DS_TYPE_DERIVE)
1434 {
1435 state->last_value.derive = (derive_t) rate;
1436 state->residual = rate - ((gauge_t) state->last_value.derive);
1437 }
1438 else if (ds_type == DS_TYPE_COUNTER)
1439 {
1440 state->last_value.counter = (counter_t) rate;
1441 state->residual = rate - ((gauge_t) state->last_value.counter);
1442 }
1443 else if (ds_type == DS_TYPE_ABSOLUTE)
1444 {
1445 state->last_value.absolute = (absolute_t) rate;
1446 state->residual = rate - ((gauge_t) state->last_value.absolute);
1447 }
1448 else
1449 {
1450 assert (23 == 42);
1451 }
1453 state->last_time = t;
1454 return (EAGAIN);
1455 } /* }}} */
1457 if (ds_type == DS_TYPE_DERIVE)
1458 {
1459 derive_t delta_derive = (derive_t) delta_gauge;
1461 state->last_value.derive += delta_derive;
1462 state->residual = delta_gauge - ((gauge_t) delta_derive);
1463 }
1464 else if (ds_type == DS_TYPE_COUNTER)
1465 {
1466 counter_t delta_counter = (counter_t) delta_gauge;
1468 state->last_value.counter += delta_counter;
1469 state->residual = delta_gauge - ((gauge_t) delta_counter);
1470 }
1471 else if (ds_type == DS_TYPE_ABSOLUTE)
1472 {
1473 absolute_t delta_absolute = (absolute_t) delta_gauge;
1475 state->last_value.absolute = delta_absolute;
1476 state->residual = delta_gauge - ((gauge_t) delta_absolute);
1477 }
1478 else
1479 {
1480 assert (23 == 42);
1481 }
1483 state->last_time = t;
1484 *ret_value = state->last_value;
1485 return (0);
1486 } /* }}} value_t rate_to_value */
1488 int value_to_rate (value_t *ret_rate, derive_t value, /* {{{ */
1489 value_to_rate_state_t *state,
1490 int ds_type, cdtime_t t)
1491 {
1492 double interval;
1494 /* Another invalid state: The time is not increasing. */
1495 if (t <= state->last_time)
1496 {
1497 memset (state, 0, sizeof (*state));
1498 return (EINVAL);
1499 }
1501 interval = CDTIME_T_TO_DOUBLE(t - state->last_time);
1503 /* Previous value is invalid. */
1504 if (state->last_time == 0) /* {{{ */
1505 {
1506 if (ds_type == DS_TYPE_DERIVE)
1507 {
1508 state->last_value.derive = value;
1509 }
1510 else if (ds_type == DS_TYPE_COUNTER)
1511 {
1512 state->last_value.counter = (counter_t) value;
1513 }
1514 else if (ds_type == DS_TYPE_ABSOLUTE)
1515 {
1516 state->last_value.absolute = (absolute_t) value;
1517 }
1518 else
1519 {
1520 assert (23 == 42);
1521 }
1523 state->last_time = t;
1524 return (EAGAIN);
1525 } /* }}} */
1527 if (ds_type == DS_TYPE_DERIVE)
1528 {
1529 ret_rate->gauge = (value - state->last_value.derive) / interval;
1530 state->last_value.derive = value;
1531 }
1532 else if (ds_type == DS_TYPE_COUNTER)
1533 {
1534 ret_rate->gauge = (((counter_t)value) - state->last_value.counter) / interval;
1535 state->last_value.counter = (counter_t) value;
1536 }
1537 else if (ds_type == DS_TYPE_ABSOLUTE)
1538 {
1539 ret_rate->gauge = (((absolute_t)value) - state->last_value.absolute) / interval;
1540 state->last_value.absolute = (absolute_t) value;
1541 }
1542 else
1543 {
1544 assert (23 == 42);
1545 }
1547 state->last_time = t;
1548 return (0);
1549 } /* }}} value_t rate_to_value */
1551 int service_name_to_port_number (const char *service_name)
1552 {
1553 struct addrinfo *ai_list;
1554 struct addrinfo *ai_ptr;
1555 struct addrinfo ai_hints;
1556 int status;
1557 int service_number;
1559 if (service_name == NULL)
1560 return (-1);
1562 ai_list = NULL;
1563 memset (&ai_hints, 0, sizeof (ai_hints));
1564 ai_hints.ai_family = AF_UNSPEC;
1566 status = getaddrinfo (/* node = */ NULL, service_name,
1567 &ai_hints, &ai_list);
1568 if (status != 0)
1569 {
1570 ERROR ("service_name_to_port_number: getaddrinfo failed: %s",
1571 gai_strerror (status));
1572 return (-1);
1573 }
1575 service_number = -1;
1576 for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next)
1577 {
1578 if (ai_ptr->ai_family == AF_INET)
1579 {
1580 struct sockaddr_in *sa;
1582 sa = (void *) ai_ptr->ai_addr;
1583 service_number = (int) ntohs (sa->sin_port);
1584 }
1585 else if (ai_ptr->ai_family == AF_INET6)
1586 {
1587 struct sockaddr_in6 *sa;
1589 sa = (void *) ai_ptr->ai_addr;
1590 service_number = (int) ntohs (sa->sin6_port);
1591 }
1593 if ((service_number > 0) && (service_number <= 65535))
1594 break;
1595 }
1597 freeaddrinfo (ai_list);
1599 if ((service_number > 0) && (service_number <= 65535))
1600 return (service_number);
1601 return (-1);
1602 } /* int service_name_to_port_number */
1604 int strtoderive (const char *string, derive_t *ret_value) /* {{{ */
1605 {
1606 derive_t tmp;
1607 char *endptr;
1609 if ((string == NULL) || (ret_value == NULL))
1610 return (EINVAL);
1612 errno = 0;
1613 endptr = NULL;
1614 tmp = (derive_t) strtoll (string, &endptr, /* base = */ 0);
1615 if ((endptr == string) || (errno != 0))
1616 return (-1);
1618 *ret_value = tmp;
1619 return (0);
1620 } /* }}} int strtoderive */
1622 int strtogauge (const char *string, gauge_t *ret_value) /* {{{ */
1623 {
1624 gauge_t tmp;
1625 char *endptr = NULL;
1627 if ((string == NULL) || (ret_value == NULL))
1628 return (EINVAL);
1630 errno = 0;
1631 endptr = NULL;
1632 tmp = (gauge_t) strtod (string, &endptr);
1633 if (errno != 0)
1634 return (errno);
1635 else if ((endptr == NULL) || (*endptr != 0))
1636 return (EINVAL);
1638 *ret_value = tmp;
1639 return (0);
1640 } /* }}} int strtogauge */
1642 int strarray_add (char ***ret_array, size_t *ret_array_len, char const *str) /* {{{ */
1643 {
1644 char **array;
1645 size_t array_len = *ret_array_len;
1647 if (str == NULL)
1648 return (EINVAL);
1650 array = realloc (*ret_array,
1651 (array_len + 1) * sizeof (*array));
1652 if (array == NULL)
1653 return (ENOMEM);
1654 *ret_array = array;
1656 array[array_len] = strdup (str);
1657 if (array[array_len] == NULL)
1658 return (ENOMEM);
1660 array_len++;
1661 *ret_array_len = array_len;
1662 return (0);
1663 } /* }}} int strarray_add */
1665 void strarray_free (char **array, size_t array_len) /* {{{ */
1666 {
1667 size_t i;
1669 for (i = 0; i < array_len; i++)
1670 sfree (array[i]);
1671 sfree (array);
1672 } /* }}} void strarray_free */