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