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