2 * collectd - src/network.c
3 * Copyright (C) 2005-2013 Florian octo Forster
4 * Copyright (C) 2009 Aman Gupta
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU Lesser General Public License as published by
8 * the Free Software Foundation; only version 2.1 of the License is
11 * This program is distributed in the hope that it will be useful, but
12 * WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public License
17 * along with this program; if not, write to the Free Software Foundation,
18 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
21 * Florian octo Forster <octo at collectd.org>
22 * Aman Gupta <aman at tmm1.net>
25 #define _DEFAULT_SOURCE
26 #define _BSD_SOURCE /* For struct ip_mreq */
31 #include "configfile.h"
32 #include "utils_fbhash.h"
33 #include "utils_cache.h"
34 #include "utils_complain.h"
42 # include <netinet/in.h>
45 # include <arpa/inet.h>
55 # if defined __APPLE__
56 /* default xcode compiler throws warnings even when deprecated functionality
57 * is not used. -Werror breaks the build because of erroneous warnings.
58 * http://stackoverflow.com/questions/10556299/compiler-warnings-with-libgcrypt-v1-5-0/12830209#12830209
60 # pragma GCC diagnostic ignored "-Wdeprecated-declarations"
62 /* FreeBSD's copy of libgcrypt extends the existing GCRYPT_NO_DEPRECATED
63 * to properly hide all deprecated functionality.
64 * http://svnweb.freebsd.org/ports/head/security/libgcrypt/files/patch-src__gcrypt.h.in
66 # define GCRYPT_NO_DEPRECATED
68 # if defined __APPLE__
69 /* Re enable deprecation warnings */
70 # pragma GCC diagnostic warning "-Wdeprecated-declarations"
72 # if GCRYPT_VERSION_NUMBER < 0x010600
73 GCRY_THREAD_OPTION_PTHREAD_IMPL;
77 #ifndef IPV6_ADD_MEMBERSHIP
78 # ifdef IPV6_JOIN_GROUP
79 # define IPV6_ADD_MEMBERSHIP IPV6_JOIN_GROUP
81 # error "Neither IP_ADD_MEMBERSHIP nor IPV6_JOIN_GROUP is defined"
83 #endif /* !IP_ADD_MEMBERSHIP */
86 * Maximum size required for encryption / signing:
88 * 42 bytes for the encryption header
89 * + 64 bytes for the username
93 #define BUFF_SIG_SIZE 106
98 #define SECURITY_LEVEL_NONE 0
100 # define SECURITY_LEVEL_SIGN 1
101 # define SECURITY_LEVEL_ENCRYPT 2
103 struct sockent_client
106 struct sockaddr_storage *addr;
112 gcry_cipher_hd_t cypher;
113 unsigned char password_hash[32];
115 cdtime_t next_resolve_reconnect;
116 cdtime_t resolve_interval;
119 struct sockent_server
127 gcry_cipher_hd_t cypher;
131 typedef struct sockent
133 #define SOCKENT_TYPE_CLIENT 1
134 #define SOCKENT_TYPE_SERVER 2
143 struct sockent_client client;
144 struct sockent_server server;
147 struct sockent *next;
150 /* 1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3
151 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
152 * +-------+-----------------------+-------------------------------+
153 * ! Ver. ! ! Length !
154 * +-------+-----------------------+-------------------------------+
161 typedef struct part_header_s part_header_t;
163 /* 1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3
164 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
165 * +-------------------------------+-------------------------------+
167 * +-------------------------------+-------------------------------+
168 * : (Length - 4) Bytes :
169 * +---------------------------------------------------------------+
176 typedef struct part_string_s part_string_t;
178 /* 1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3
179 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
180 * +-------------------------------+-------------------------------+
182 * +-------------------------------+-------------------------------+
183 * : (Length - 4 == 2 || 4 || 8) Bytes :
184 * +---------------------------------------------------------------+
191 typedef struct part_number_s part_number_t;
193 /* 1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3
194 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
195 * +-------------------------------+-------------------------------+
197 * +-------------------------------+---------------+---------------+
198 * ! Num of values ! Type0 ! Type1 !
199 * +-------------------------------+---------------+---------------+
202 * +---------------------------------------------------------------+
205 * +---------------------------------------------------------------+
210 uint16_t *num_values;
211 uint8_t *values_types;
214 typedef struct part_values_s part_values_t;
216 /* 1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3
217 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
218 * +-------------------------------+-------------------------------+
220 * +-------------------------------+-------------------------------+
221 * ! Hash (Bits 0 - 31) !
223 * ! Hash (Bits 224 - 255) !
224 * +---------------------------------------------------------------+
227 #define PART_SIGNATURE_SHA256_SIZE 36
228 struct part_signature_sha256_s
231 unsigned char hash[32];
234 typedef struct part_signature_sha256_s part_signature_sha256_t;
236 /* 1 1 1 1 1 1 1 1 1 1 2 2 2 2 2 2 2 2 2 2 3 3
237 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
238 * +-------------------------------+-------------------------------+
240 * +-------------------------------+-------------------------------+
241 * ! Original length ! Padding (0 - 15 bytes) !
242 * +-------------------------------+-------------------------------+
243 * ! Hash (Bits 0 - 31) !
245 * ! Hash (Bits 128 - 159) !
246 * +---------------------------------------------------------------+
249 #define PART_ENCRYPTION_AES256_SIZE 42
250 struct part_encryption_aes256_s
253 uint16_t username_length;
255 unsigned char iv[16];
257 unsigned char hash[20];
261 typedef struct part_encryption_aes256_s part_encryption_aes256_t;
263 struct receive_list_entry_s
268 struct receive_list_entry_s *next;
270 typedef struct receive_list_entry_s receive_list_entry_t;
275 static int network_config_ttl = 0;
276 /* Ethernet - (IPv6 + UDP) = 1500 - (40 + 8) = 1452 */
277 static size_t network_config_packet_size = 1452;
278 static _Bool network_config_forward = 0;
279 static _Bool network_config_stats = 0;
281 static sockent_t *sending_sockets = NULL;
283 static receive_list_entry_t *receive_list_head = NULL;
284 static receive_list_entry_t *receive_list_tail = NULL;
285 static pthread_mutex_t receive_list_lock = PTHREAD_MUTEX_INITIALIZER;
286 static pthread_cond_t receive_list_cond = PTHREAD_COND_INITIALIZER;
287 static uint64_t receive_list_length = 0;
289 static sockent_t *listen_sockets = NULL;
290 static struct pollfd *listen_sockets_pollfd = NULL;
291 static size_t listen_sockets_num = 0;
293 /* The receive and dispatch threads will run as long as `listen_loop' is set to
295 static int listen_loop = 0;
296 static int receive_thread_running = 0;
297 static pthread_t receive_thread_id;
298 static int dispatch_thread_running = 0;
299 static pthread_t dispatch_thread_id;
301 /* Buffer in which to-be-sent network packets are constructed. */
302 static char *send_buffer;
303 static char *send_buffer_ptr;
304 static int send_buffer_fill;
305 static cdtime_t send_buffer_last_update;
306 static value_list_t send_buffer_vl = VALUE_LIST_STATIC;
307 static pthread_mutex_t send_buffer_lock = PTHREAD_MUTEX_INITIALIZER;
309 /* XXX: These counters are incremented from one place only. The spot in which
310 * the values are incremented is either only reachable by one thread (the
311 * dispatch thread, for example) or locked by some lock (send_buffer_lock for
312 * example). Only if neither is true, the stats_lock is acquired. The counters
313 * are always read without holding a lock in the hope that writing 8 bytes to
314 * memory is an atomic operation. */
315 static derive_t stats_octets_rx = 0;
316 static derive_t stats_octets_tx = 0;
317 static derive_t stats_packets_rx = 0;
318 static derive_t stats_packets_tx = 0;
319 static derive_t stats_values_dispatched = 0;
320 static derive_t stats_values_not_dispatched = 0;
321 static derive_t stats_values_sent = 0;
322 static derive_t stats_values_not_sent = 0;
323 static pthread_mutex_t stats_lock = PTHREAD_MUTEX_INITIALIZER;
328 static _Bool check_receive_okay (const value_list_t *vl) /* {{{ */
330 uint64_t time_sent = 0;
333 status = uc_meta_data_get_unsigned_int (vl,
334 "network:time_sent", &time_sent);
336 /* This is a value we already sent. Don't allow it to be received again in
337 * order to avoid looping. */
338 if ((status == 0) && (time_sent >= ((uint64_t) vl->time)))
342 } /* }}} _Bool check_receive_okay */
344 static _Bool check_send_okay (const value_list_t *vl) /* {{{ */
349 if (network_config_forward)
352 if (vl->meta == NULL)
355 status = meta_data_get_boolean (vl->meta, "network:received", &received);
356 if (status == -ENOENT)
358 else if (status != 0)
360 ERROR ("network plugin: check_send_okay: meta_data_get_boolean failed "
361 "with status %i.", status);
365 /* By default, only *send* value lists that were not *received* by the
368 } /* }}} _Bool check_send_okay */
370 static _Bool check_notify_received (const notification_t *n) /* {{{ */
372 notification_meta_t *ptr;
374 for (ptr = n->meta; ptr != NULL; ptr = ptr->next)
375 if ((strcmp ("network:received", ptr->name) == 0)
376 && (ptr->type == NM_TYPE_BOOLEAN))
377 return ((_Bool) ptr->nm_value.nm_boolean);
380 } /* }}} _Bool check_notify_received */
382 static _Bool check_send_notify_okay (const notification_t *n) /* {{{ */
384 static c_complain_t complain_forwarding = C_COMPLAIN_INIT_STATIC;
390 received = check_notify_received (n);
392 if (network_config_forward && received)
394 c_complain_once (LOG_ERR, &complain_forwarding,
395 "network plugin: A notification has been received via the network "
396 "and forwarding is enabled. Forwarding of notifications is currently "
397 "not supported, because there is not loop-deteciton available. "
398 "Please contact the collectd mailing list if you need this "
402 /* By default, only *send* value lists that were not *received* by the
405 } /* }}} _Bool check_send_notify_okay */
407 static int network_dispatch_values (value_list_t *vl, /* {{{ */
408 const char *username)
413 || (strlen (vl->host) == 0)
414 || (strlen (vl->plugin) == 0)
415 || (strlen (vl->type) == 0))
418 if (!check_receive_okay (vl))
421 char name[6*DATA_MAX_NAME_LEN];
422 FORMAT_VL (name, sizeof (name), vl);
423 name[sizeof (name) - 1] = 0;
424 DEBUG ("network plugin: network_dispatch_values: "
425 "NOT dispatching %s.", name);
427 stats_values_not_dispatched++;
431 assert (vl->meta == NULL);
433 vl->meta = meta_data_create ();
434 if (vl->meta == NULL)
436 ERROR ("network plugin: meta_data_create failed.");
440 status = meta_data_add_boolean (vl->meta, "network:received", 1);
443 ERROR ("network plugin: meta_data_add_boolean failed.");
444 meta_data_destroy (vl->meta);
449 if (username != NULL)
451 status = meta_data_add_string (vl->meta, "network:username", username);
454 ERROR ("network plugin: meta_data_add_string failed.");
455 meta_data_destroy (vl->meta);
461 plugin_dispatch_values (vl);
462 stats_values_dispatched++;
464 meta_data_destroy (vl->meta);
468 } /* }}} int network_dispatch_values */
470 static int network_dispatch_notification (notification_t *n) /* {{{ */
474 assert (n->meta == NULL);
476 status = plugin_notification_meta_add_boolean (n, "network:received", 1);
479 ERROR ("network plugin: plugin_notification_meta_add_boolean failed.");
480 plugin_notification_meta_free (n->meta);
485 status = plugin_dispatch_notification (n);
487 plugin_notification_meta_free (n->meta);
491 } /* }}} int network_dispatch_notification */
494 static void network_init_gcrypt (void) /* {{{ */
498 /* http://lists.gnupg.org/pipermail/gcrypt-devel/2003-August/000458.html
499 * Because you can't know in a library whether another library has
500 * already initialized the library */
501 if (gcry_control (GCRYCTL_ANY_INITIALIZATION_P))
504 /* http://www.gnupg.org/documentation/manuals/gcrypt/Multi_002dThreading.html
505 * To ensure thread-safety, it's important to set GCRYCTL_SET_THREAD_CBS
506 * *before* initalizing Libgcrypt with gcry_check_version(), which itself must
507 * be called before any other gcry_* function. GCRYCTL_ANY_INITIALIZATION_P
508 * above doesn't count, as it doesn't implicitly initalize Libgcrypt.
510 * tl;dr: keep all these gry_* statements in this exact order please. */
511 # if GCRYPT_VERSION_NUMBER < 0x010600
512 err = gcry_control (GCRYCTL_SET_THREAD_CBS, &gcry_threads_pthread);
515 ERROR ("network plugin: gcry_control (GCRYCTL_SET_THREAD_CBS) failed: %s", gcry_strerror (err));
520 gcry_check_version (NULL);
522 err = gcry_control (GCRYCTL_INIT_SECMEM, 32768);
525 ERROR ("network plugin: gcry_control (GCRYCTL_INIT_SECMEM) failed: %s", gcry_strerror (err));
529 gcry_control (GCRYCTL_INITIALIZATION_FINISHED);
530 } /* }}} void network_init_gcrypt */
532 static gcry_cipher_hd_t network_get_aes256_cypher (sockent_t *se, /* {{{ */
533 const void *iv, size_t iv_size, const char *username)
536 gcry_cipher_hd_t *cyper_ptr;
537 unsigned char password_hash[32];
539 if (se->type == SOCKENT_TYPE_CLIENT)
541 cyper_ptr = &se->data.client.cypher;
542 memcpy (password_hash, se->data.client.password_hash,
543 sizeof (password_hash));
549 cyper_ptr = &se->data.server.cypher;
551 if (username == NULL)
554 secret = fbh_get (se->data.server.userdb, username);
558 gcry_md_hash_buffer (GCRY_MD_SHA256,
560 secret, strlen (secret));
565 if (*cyper_ptr == NULL)
567 err = gcry_cipher_open (cyper_ptr,
568 GCRY_CIPHER_AES256, GCRY_CIPHER_MODE_OFB, /* flags = */ 0);
571 ERROR ("network plugin: gcry_cipher_open returned: %s",
572 gcry_strerror (err));
579 gcry_cipher_reset (*cyper_ptr);
581 assert (*cyper_ptr != NULL);
583 err = gcry_cipher_setkey (*cyper_ptr,
584 password_hash, sizeof (password_hash));
587 ERROR ("network plugin: gcry_cipher_setkey returned: %s",
588 gcry_strerror (err));
589 gcry_cipher_close (*cyper_ptr);
594 err = gcry_cipher_setiv (*cyper_ptr, iv, iv_size);
597 ERROR ("network plugin: gcry_cipher_setkey returned: %s",
598 gcry_strerror (err));
599 gcry_cipher_close (*cyper_ptr);
605 } /* }}} int network_get_aes256_cypher */
606 #endif /* HAVE_LIBGCRYPT */
608 static int write_part_values (char **ret_buffer, size_t *ret_buffer_len,
609 const data_set_t *ds, const value_list_t *vl)
615 part_header_t pkg_ph;
616 uint16_t pkg_num_values;
617 uint8_t *pkg_values_types;
623 num_values = vl->values_len;
624 packet_len = sizeof (part_header_t) + sizeof (uint16_t)
625 + (num_values * sizeof (uint8_t))
626 + (num_values * sizeof (value_t));
628 if (*ret_buffer_len < packet_len)
631 pkg_values_types = malloc (num_values * sizeof (*pkg_values_types));
632 if (pkg_values_types == NULL)
634 ERROR ("network plugin: write_part_values: malloc failed.");
638 pkg_values = malloc (num_values * sizeof (*pkg_values));
639 if (pkg_values == NULL)
641 free (pkg_values_types);
642 ERROR ("network plugin: write_part_values: malloc failed.");
646 pkg_ph.type = htons (TYPE_VALUES);
647 pkg_ph.length = htons (packet_len);
649 pkg_num_values = htons ((uint16_t) vl->values_len);
651 for (i = 0; i < num_values; i++)
653 pkg_values_types[i] = (uint8_t) ds->ds[i].type;
654 switch (ds->ds[i].type)
656 case DS_TYPE_COUNTER:
657 pkg_values[i].counter = htonll (vl->values[i].counter);
661 pkg_values[i].gauge = htond (vl->values[i].gauge);
665 pkg_values[i].derive = htonll (vl->values[i].derive);
668 case DS_TYPE_ABSOLUTE:
669 pkg_values[i].absolute = htonll (vl->values[i].absolute);
673 free (pkg_values_types);
675 ERROR ("network plugin: write_part_values: "
676 "Unknown data source type: %i",
679 } /* switch (ds->ds[i].type) */
680 } /* for (num_values) */
683 * Use `memcpy' to write everything to the buffer, because the pointer
684 * may be unaligned and some architectures, such as SPARC, can't handle
687 packet_ptr = *ret_buffer;
689 memcpy (packet_ptr + offset, &pkg_ph, sizeof (pkg_ph));
690 offset += sizeof (pkg_ph);
691 memcpy (packet_ptr + offset, &pkg_num_values, sizeof (pkg_num_values));
692 offset += sizeof (pkg_num_values);
693 memcpy (packet_ptr + offset, pkg_values_types, num_values * sizeof (uint8_t));
694 offset += num_values * sizeof (uint8_t);
695 memcpy (packet_ptr + offset, pkg_values, num_values * sizeof (value_t));
696 offset += num_values * sizeof (value_t);
698 assert (offset == packet_len);
700 *ret_buffer = packet_ptr + packet_len;
701 *ret_buffer_len -= packet_len;
703 free (pkg_values_types);
707 } /* int write_part_values */
709 static int write_part_number (char **ret_buffer, size_t *ret_buffer_len,
710 int type, uint64_t value)
715 part_header_t pkg_head;
720 packet_len = sizeof (pkg_head) + sizeof (pkg_value);
722 if (*ret_buffer_len < packet_len)
725 pkg_head.type = htons (type);
726 pkg_head.length = htons (packet_len);
727 pkg_value = htonll (value);
729 packet_ptr = *ret_buffer;
731 memcpy (packet_ptr + offset, &pkg_head, sizeof (pkg_head));
732 offset += sizeof (pkg_head);
733 memcpy (packet_ptr + offset, &pkg_value, sizeof (pkg_value));
734 offset += sizeof (pkg_value);
736 assert (offset == packet_len);
738 *ret_buffer = packet_ptr + packet_len;
739 *ret_buffer_len -= packet_len;
742 } /* int write_part_number */
744 static int write_part_string (char **ret_buffer, size_t *ret_buffer_len,
745 int type, const char *str, size_t str_len)
755 buffer_len = 2 * sizeof (uint16_t) + str_len + 1;
756 if (*ret_buffer_len < buffer_len)
759 pkg_type = htons (type);
760 pkg_length = htons (buffer_len);
762 buffer = *ret_buffer;
764 memcpy (buffer + offset, (void *) &pkg_type, sizeof (pkg_type));
765 offset += sizeof (pkg_type);
766 memcpy (buffer + offset, (void *) &pkg_length, sizeof (pkg_length));
767 offset += sizeof (pkg_length);
768 memcpy (buffer + offset, str, str_len);
770 memset (buffer + offset, '\0', 1);
773 assert (offset == buffer_len);
775 *ret_buffer = buffer + buffer_len;
776 *ret_buffer_len -= buffer_len;
779 } /* int write_part_string */
781 static int parse_part_values (void **ret_buffer, size_t *ret_buffer_len,
782 value_t **ret_values, size_t *ret_num_values)
784 char *buffer = *ret_buffer;
785 size_t buffer_len = *ret_buffer_len;
800 NOTICE ("network plugin: packet is too short: "
801 "buffer_len = %zu", buffer_len);
805 memcpy ((void *) &tmp16, buffer, sizeof (tmp16));
806 buffer += sizeof (tmp16);
807 pkg_type = ntohs (tmp16);
809 memcpy ((void *) &tmp16, buffer, sizeof (tmp16));
810 buffer += sizeof (tmp16);
811 pkg_length = ntohs (tmp16);
813 memcpy ((void *) &tmp16, buffer, sizeof (tmp16));
814 buffer += sizeof (tmp16);
815 pkg_numval = (size_t) ntohs (tmp16);
817 assert (pkg_type == TYPE_VALUES);
819 exp_size = 3 * sizeof (uint16_t)
820 + pkg_numval * (sizeof (uint8_t) + sizeof (value_t));
821 if (buffer_len < exp_size)
823 WARNING ("network plugin: parse_part_values: "
825 "Chunk of size %zu expected, "
826 "but buffer has only %zu bytes left.",
827 exp_size, buffer_len);
830 assert (pkg_numval <= ((buffer_len - 6) / 9));
832 if (pkg_length != exp_size)
834 WARNING ("network plugin: parse_part_values: "
835 "Length and number of values "
836 "in the packet don't match.");
840 pkg_types = calloc (pkg_numval, sizeof (*pkg_types));
841 pkg_values = calloc (pkg_numval, sizeof (*pkg_values));
842 if ((pkg_types == NULL) || (pkg_values == NULL))
846 ERROR ("network plugin: parse_part_values: calloc failed.");
850 memcpy (pkg_types, buffer, pkg_numval * sizeof (*pkg_types));
851 buffer += pkg_numval * sizeof (*pkg_types);
852 memcpy (pkg_values, buffer, pkg_numval * sizeof (*pkg_values));
853 buffer += pkg_numval * sizeof (*pkg_values);
855 for (i = 0; i < pkg_numval; i++)
857 switch (pkg_types[i])
859 case DS_TYPE_COUNTER:
860 pkg_values[i].counter = (counter_t) ntohll (pkg_values[i].counter);
864 pkg_values[i].gauge = (gauge_t) ntohd (pkg_values[i].gauge);
868 pkg_values[i].derive = (derive_t) ntohll (pkg_values[i].derive);
871 case DS_TYPE_ABSOLUTE:
872 pkg_values[i].absolute = (absolute_t) ntohll (pkg_values[i].absolute);
876 NOTICE ("network plugin: parse_part_values: "
877 "Don't know how to handle data source type %"PRIu8,
882 } /* switch (pkg_types[i]) */
885 *ret_buffer = buffer;
886 *ret_buffer_len = buffer_len - pkg_length;
887 *ret_num_values = pkg_numval;
888 *ret_values = pkg_values;
893 } /* int parse_part_values */
895 static int parse_part_number (void **ret_buffer, size_t *ret_buffer_len,
898 char *buffer = *ret_buffer;
899 size_t buffer_len = *ret_buffer_len;
903 size_t exp_size = 2 * sizeof (uint16_t) + sizeof (uint64_t);
907 if (buffer_len < exp_size)
909 WARNING ("network plugin: parse_part_number: "
911 "Chunk of size %zu expected, "
912 "but buffer has only %zu bytes left.",
913 exp_size, buffer_len);
917 memcpy ((void *) &tmp16, buffer, sizeof (tmp16));
918 buffer += sizeof (tmp16);
919 /* pkg_type = ntohs (tmp16); */
921 memcpy ((void *) &tmp16, buffer, sizeof (tmp16));
922 buffer += sizeof (tmp16);
923 pkg_length = ntohs (tmp16);
925 memcpy ((void *) &tmp64, buffer, sizeof (tmp64));
926 buffer += sizeof (tmp64);
927 *value = ntohll (tmp64);
929 *ret_buffer = buffer;
930 *ret_buffer_len = buffer_len - pkg_length;
933 } /* int parse_part_number */
935 static int parse_part_string (void **ret_buffer, size_t *ret_buffer_len,
936 char *output, size_t const output_len)
938 char *buffer = *ret_buffer;
939 size_t buffer_len = *ret_buffer_len;
942 size_t const header_size = 2 * sizeof (uint16_t);
950 if (buffer_len < header_size)
952 WARNING ("network plugin: parse_part_string: "
954 "Chunk of at least size %zu expected, "
955 "but buffer has only %zu bytes left.",
956 header_size, buffer_len);
960 memcpy ((void *) &tmp16, buffer, sizeof (tmp16));
961 buffer += sizeof (tmp16);
962 /* pkg_type = ntohs (tmp16); */
964 memcpy ((void *) &tmp16, buffer, sizeof (tmp16));
965 buffer += sizeof (tmp16);
966 pkg_length = ntohs (tmp16);
967 payload_size = ((size_t) pkg_length) - header_size;
969 /* Check that packet fits in the input buffer */
970 if (pkg_length > buffer_len)
972 WARNING ("network plugin: parse_part_string: "
974 "Chunk of size %"PRIu16" received, "
975 "but buffer has only %zu bytes left.",
976 pkg_length, buffer_len);
980 /* Check that pkg_length is in the valid range */
981 if (pkg_length <= header_size)
983 WARNING ("network plugin: parse_part_string: "
985 "Header claims this packet is only %hu "
986 "bytes long.", pkg_length);
990 /* Check that the package data fits into the output buffer.
991 * The previous if-statement ensures that:
992 * `pkg_length > header_size' */
993 if (output_len < payload_size)
995 WARNING ("network plugin: parse_part_string: "
997 "Output buffer holds %zu bytes, "
998 "which is too small to hold the received "
1000 output_len, payload_size);
1004 /* All sanity checks successfull, let's copy the data over */
1005 memcpy ((void *) output, (void *) buffer, payload_size);
1006 buffer += payload_size;
1008 /* For some very weird reason '\0' doesn't do the trick on SPARC in
1009 * this statement. */
1010 if (output[payload_size - 1] != 0)
1012 WARNING ("network plugin: parse_part_string: "
1013 "Received string does not end "
1014 "with a NULL-byte.");
1018 *ret_buffer = buffer;
1019 *ret_buffer_len = buffer_len - pkg_length;
1022 } /* int parse_part_string */
1024 /* Forward declaration: parse_part_sign_sha256 and parse_part_encr_aes256 call
1025 * parse_packet and vice versa. */
1026 #define PP_SIGNED 0x01
1027 #define PP_ENCRYPTED 0x02
1028 static int parse_packet (sockent_t *se,
1029 void *buffer, size_t buffer_size, int flags,
1030 const char *username);
1032 #define BUFFER_READ(p,s) do { \
1033 memcpy ((p), buffer + buffer_offset, (s)); \
1034 buffer_offset += (s); \
1038 static int parse_part_sign_sha256 (sockent_t *se, /* {{{ */
1039 void **ret_buffer, size_t *ret_buffer_len, int flags)
1041 static c_complain_t complain_no_users = C_COMPLAIN_INIT_STATIC;
1045 size_t buffer_offset;
1047 size_t username_len;
1050 part_signature_sha256_t pss;
1051 uint16_t pss_head_length;
1052 char hash[sizeof (pss.hash)];
1056 unsigned char *hash_ptr;
1058 buffer = *ret_buffer;
1059 buffer_len = *ret_buffer_len;
1062 if (se->data.server.userdb == NULL)
1064 c_complain (LOG_NOTICE, &complain_no_users,
1065 "network plugin: Received signed network packet but can't verify it "
1066 "because no user DB has been configured. Will accept it.");
1070 /* Check if the buffer has enough data for this structure. */
1071 if (buffer_len <= PART_SIGNATURE_SHA256_SIZE)
1074 /* Read type and length header */
1075 BUFFER_READ (&pss.head.type, sizeof (pss.head.type));
1076 BUFFER_READ (&pss.head.length, sizeof (pss.head.length));
1077 pss_head_length = ntohs (pss.head.length);
1079 /* Check if the `pss_head_length' is within bounds. */
1080 if ((pss_head_length <= PART_SIGNATURE_SHA256_SIZE)
1081 || (pss_head_length > buffer_len))
1083 ERROR ("network plugin: HMAC-SHA-256 with invalid length received.");
1087 /* Copy the hash. */
1088 BUFFER_READ (pss.hash, sizeof (pss.hash));
1090 /* Calculate username length (without null byte) and allocate memory */
1091 username_len = pss_head_length - PART_SIGNATURE_SHA256_SIZE;
1092 pss.username = malloc (username_len + 1);
1093 if (pss.username == NULL)
1096 /* Read the username */
1097 BUFFER_READ (pss.username, username_len);
1098 pss.username[username_len] = 0;
1100 assert (buffer_offset == pss_head_length);
1102 /* Query the password */
1103 secret = fbh_get (se->data.server.userdb, pss.username);
1106 ERROR ("network plugin: Unknown user: %s", pss.username);
1107 sfree (pss.username);
1111 /* Create a hash device and check the HMAC */
1113 err = gcry_md_open (&hd, GCRY_MD_SHA256, GCRY_MD_FLAG_HMAC);
1116 ERROR ("network plugin: Creating HMAC-SHA-256 object failed: %s",
1117 gcry_strerror (err));
1119 sfree (pss.username);
1123 err = gcry_md_setkey (hd, secret, strlen (secret));
1126 ERROR ("network plugin: gcry_md_setkey failed: %s", gcry_strerror (err));
1129 sfree (pss.username);
1134 buffer + PART_SIGNATURE_SHA256_SIZE,
1135 buffer_len - PART_SIGNATURE_SHA256_SIZE);
1136 hash_ptr = gcry_md_read (hd, GCRY_MD_SHA256);
1137 if (hash_ptr == NULL)
1139 ERROR ("network plugin: gcry_md_read failed.");
1142 sfree (pss.username);
1145 memcpy (hash, hash_ptr, sizeof (hash));
1151 if (memcmp (pss.hash, hash, sizeof (pss.hash)) != 0)
1153 WARNING ("network plugin: Verifying HMAC-SHA-256 signature failed: "
1158 parse_packet (se, buffer + buffer_offset, buffer_len - buffer_offset,
1159 flags | PP_SIGNED, pss.username);
1163 sfree (pss.username);
1165 *ret_buffer = buffer + buffer_len;
1166 *ret_buffer_len = 0;
1169 } /* }}} int parse_part_sign_sha256 */
1170 /* #endif HAVE_LIBGCRYPT */
1172 #else /* if !HAVE_LIBGCRYPT */
1173 static int parse_part_sign_sha256 (sockent_t *se, /* {{{ */
1174 void **ret_buffer, size_t *ret_buffer_size, int flags)
1176 static int warning_has_been_printed = 0;
1180 size_t buffer_offset;
1183 part_signature_sha256_t pss;
1185 buffer = *ret_buffer;
1186 buffer_size = *ret_buffer_size;
1189 if (buffer_size <= PART_SIGNATURE_SHA256_SIZE)
1192 BUFFER_READ (&pss.head.type, sizeof (pss.head.type));
1193 BUFFER_READ (&pss.head.length, sizeof (pss.head.length));
1194 part_len = ntohs (pss.head.length);
1196 if ((part_len <= PART_SIGNATURE_SHA256_SIZE)
1197 || (part_len > buffer_size))
1200 if (warning_has_been_printed == 0)
1202 WARNING ("network plugin: Received signed packet, but the network "
1203 "plugin was not linked with libgcrypt, so I cannot "
1204 "verify the signature. The packet will be accepted.");
1205 warning_has_been_printed = 1;
1208 parse_packet (se, buffer + part_len, buffer_size - part_len, flags,
1209 /* username = */ NULL);
1211 *ret_buffer = buffer + buffer_size;
1212 *ret_buffer_size = 0;
1215 } /* }}} int parse_part_sign_sha256 */
1216 #endif /* !HAVE_LIBGCRYPT */
1219 static int parse_part_encr_aes256 (sockent_t *se, /* {{{ */
1220 void **ret_buffer, size_t *ret_buffer_len,
1223 char *buffer = *ret_buffer;
1224 size_t buffer_len = *ret_buffer_len;
1227 size_t buffer_offset;
1228 uint16_t username_len;
1229 part_encryption_aes256_t pea;
1230 unsigned char hash[sizeof (pea.hash)] = { 0 };
1232 gcry_cipher_hd_t cypher;
1235 /* Make sure at least the header if available. */
1236 if (buffer_len <= PART_ENCRYPTION_AES256_SIZE)
1238 NOTICE ("network plugin: parse_part_encr_aes256: "
1239 "Discarding short packet.");
1245 /* Copy the unencrypted information into `pea'. */
1246 BUFFER_READ (&pea.head.type, sizeof (pea.head.type));
1247 BUFFER_READ (&pea.head.length, sizeof (pea.head.length));
1249 /* Check the `part size'. */
1250 part_size = ntohs (pea.head.length);
1251 if ((part_size <= PART_ENCRYPTION_AES256_SIZE)
1252 || (part_size > buffer_len))
1254 NOTICE ("network plugin: parse_part_encr_aes256: "
1255 "Discarding part with invalid size.");
1259 /* Read the username */
1260 BUFFER_READ (&username_len, sizeof (username_len));
1261 username_len = ntohs (username_len);
1263 if ((username_len == 0)
1264 || (username_len > (part_size - (PART_ENCRYPTION_AES256_SIZE + 1))))
1266 NOTICE ("network plugin: parse_part_encr_aes256: "
1267 "Discarding part with invalid username length.");
1271 assert (username_len > 0);
1272 pea.username = malloc (username_len + 1);
1273 if (pea.username == NULL)
1275 BUFFER_READ (pea.username, username_len);
1276 pea.username[username_len] = 0;
1278 /* Last but not least, the initialization vector */
1279 BUFFER_READ (pea.iv, sizeof (pea.iv));
1281 /* Make sure we are at the right position */
1282 assert (buffer_offset == (username_len +
1283 PART_ENCRYPTION_AES256_SIZE - sizeof (pea.hash)));
1285 cypher = network_get_aes256_cypher (se, pea.iv, sizeof (pea.iv),
1289 sfree (pea.username);
1293 payload_len = part_size - (PART_ENCRYPTION_AES256_SIZE + username_len);
1294 assert (payload_len > 0);
1296 /* Decrypt the packet in-place */
1297 err = gcry_cipher_decrypt (cypher,
1298 buffer + buffer_offset,
1299 part_size - buffer_offset,
1300 /* in = */ NULL, /* in len = */ 0);
1303 sfree (pea.username);
1304 ERROR ("network plugin: gcry_cipher_decrypt returned: %s",
1305 gcry_strerror (err));
1310 BUFFER_READ (pea.hash, sizeof (pea.hash));
1312 /* Make sure we're at the right position - again */
1313 assert (buffer_offset == (username_len + PART_ENCRYPTION_AES256_SIZE));
1314 assert (buffer_offset == (part_size - payload_len));
1316 /* Check hash sum */
1317 gcry_md_hash_buffer (GCRY_MD_SHA1, hash,
1318 buffer + buffer_offset, payload_len);
1319 if (memcmp (hash, pea.hash, sizeof (hash)) != 0)
1321 sfree (pea.username);
1322 ERROR ("network plugin: Decryption failed: Checksum mismatch.");
1326 parse_packet (se, buffer + buffer_offset, payload_len,
1327 flags | PP_ENCRYPTED, pea.username);
1329 /* XXX: Free pea.username?!? */
1331 /* Update return values */
1332 *ret_buffer = buffer + part_size;
1333 *ret_buffer_len = buffer_len - part_size;
1335 sfree (pea.username);
1338 } /* }}} int parse_part_encr_aes256 */
1339 /* #endif HAVE_LIBGCRYPT */
1341 #else /* if !HAVE_LIBGCRYPT */
1342 static int parse_part_encr_aes256 (sockent_t *se, /* {{{ */
1343 void **ret_buffer, size_t *ret_buffer_size, int flags)
1345 static int warning_has_been_printed = 0;
1349 size_t buffer_offset;
1354 buffer = *ret_buffer;
1355 buffer_size = *ret_buffer_size;
1358 /* parse_packet assures this minimum size. */
1359 assert (buffer_size >= (sizeof (ph.type) + sizeof (ph.length)));
1361 BUFFER_READ (&ph.type, sizeof (ph.type));
1362 BUFFER_READ (&ph.length, sizeof (ph.length));
1363 ph_length = ntohs (ph.length);
1365 if ((ph_length <= PART_ENCRYPTION_AES256_SIZE)
1366 || (ph_length > buffer_size))
1368 ERROR ("network plugin: AES-256 encrypted part "
1369 "with invalid length received.");
1373 if (warning_has_been_printed == 0)
1375 WARNING ("network plugin: Received encrypted packet, but the network "
1376 "plugin was not linked with libgcrypt, so I cannot "
1377 "decrypt it. The part will be discarded.");
1378 warning_has_been_printed = 1;
1381 *ret_buffer = (void *) (((char *) *ret_buffer) + ph_length);
1382 *ret_buffer_size -= ph_length;
1385 } /* }}} int parse_part_encr_aes256 */
1386 #endif /* !HAVE_LIBGCRYPT */
1390 static int parse_packet (sockent_t *se, /* {{{ */
1391 void *buffer, size_t buffer_size, int flags,
1392 const char *username)
1396 value_list_t vl = VALUE_LIST_INIT;
1397 notification_t n = { 0 };
1400 int packet_was_signed = (flags & PP_SIGNED);
1401 int packet_was_encrypted = (flags & PP_ENCRYPTED);
1402 int printed_ignore_warning = 0;
1403 #endif /* HAVE_LIBGCRYPT */
1406 memset (&vl, '\0', sizeof (vl));
1409 while ((status == 0) && (0 < buffer_size)
1410 && ((unsigned int) buffer_size > sizeof (part_header_t)))
1412 uint16_t pkg_length;
1415 memcpy ((void *) &pkg_type,
1418 memcpy ((void *) &pkg_length,
1419 (void *) (((char *) buffer) + sizeof (pkg_type)),
1420 sizeof (pkg_length));
1422 pkg_length = ntohs (pkg_length);
1423 pkg_type = ntohs (pkg_type);
1425 if (pkg_length > buffer_size)
1427 /* Ensure that this loop terminates eventually */
1428 if (pkg_length < (2 * sizeof (uint16_t)))
1431 if (pkg_type == TYPE_ENCR_AES256)
1433 status = parse_part_encr_aes256 (se,
1434 &buffer, &buffer_size, flags);
1437 ERROR ("network plugin: Decrypting AES256 "
1439 "with status %i.", status);
1444 else if ((se->data.server.security_level == SECURITY_LEVEL_ENCRYPT)
1445 && (packet_was_encrypted == 0))
1447 if (printed_ignore_warning == 0)
1449 INFO ("network plugin: Unencrypted packet or "
1450 "part has been ignored.");
1451 printed_ignore_warning = 1;
1453 buffer = ((char *) buffer) + pkg_length;
1454 buffer_size -= (size_t) pkg_length;
1457 #endif /* HAVE_LIBGCRYPT */
1458 else if (pkg_type == TYPE_SIGN_SHA256)
1460 status = parse_part_sign_sha256 (se,
1461 &buffer, &buffer_size, flags);
1464 ERROR ("network plugin: Verifying HMAC-SHA-256 "
1466 "with status %i.", status);
1471 else if ((se->data.server.security_level == SECURITY_LEVEL_SIGN)
1472 && (packet_was_encrypted == 0)
1473 && (packet_was_signed == 0))
1475 if (printed_ignore_warning == 0)
1477 INFO ("network plugin: Unsigned packet or "
1478 "part has been ignored.");
1479 printed_ignore_warning = 1;
1481 buffer = ((char *) buffer) + pkg_length;
1482 buffer_size -= (size_t) pkg_length;
1485 #endif /* HAVE_LIBGCRYPT */
1486 else if (pkg_type == TYPE_VALUES)
1488 status = parse_part_values (&buffer, &buffer_size,
1489 &vl.values, &vl.values_len);
1493 network_dispatch_values (&vl, username);
1497 else if (pkg_type == TYPE_TIME)
1500 status = parse_part_number (&buffer, &buffer_size,
1504 vl.time = TIME_T_TO_CDTIME_T (tmp);
1505 n.time = TIME_T_TO_CDTIME_T (tmp);
1508 else if (pkg_type == TYPE_TIME_HR)
1511 status = parse_part_number (&buffer, &buffer_size,
1515 vl.time = (cdtime_t) tmp;
1516 n.time = (cdtime_t) tmp;
1519 else if (pkg_type == TYPE_INTERVAL)
1522 status = parse_part_number (&buffer, &buffer_size,
1525 vl.interval = TIME_T_TO_CDTIME_T (tmp);
1527 else if (pkg_type == TYPE_INTERVAL_HR)
1530 status = parse_part_number (&buffer, &buffer_size,
1533 vl.interval = (cdtime_t) tmp;
1535 else if (pkg_type == TYPE_HOST)
1537 status = parse_part_string (&buffer, &buffer_size,
1538 vl.host, sizeof (vl.host));
1540 sstrncpy (n.host, vl.host, sizeof (n.host));
1542 else if (pkg_type == TYPE_PLUGIN)
1544 status = parse_part_string (&buffer, &buffer_size,
1545 vl.plugin, sizeof (vl.plugin));
1547 sstrncpy (n.plugin, vl.plugin,
1550 else if (pkg_type == TYPE_PLUGIN_INSTANCE)
1552 status = parse_part_string (&buffer, &buffer_size,
1554 sizeof (vl.plugin_instance));
1556 sstrncpy (n.plugin_instance,
1558 sizeof (n.plugin_instance));
1560 else if (pkg_type == TYPE_TYPE)
1562 status = parse_part_string (&buffer, &buffer_size,
1563 vl.type, sizeof (vl.type));
1565 sstrncpy (n.type, vl.type, sizeof (n.type));
1567 else if (pkg_type == TYPE_TYPE_INSTANCE)
1569 status = parse_part_string (&buffer, &buffer_size,
1571 sizeof (vl.type_instance));
1573 sstrncpy (n.type_instance, vl.type_instance,
1574 sizeof (n.type_instance));
1576 else if (pkg_type == TYPE_MESSAGE)
1578 status = parse_part_string (&buffer, &buffer_size,
1579 n.message, sizeof (n.message));
1585 else if ((n.severity != NOTIF_FAILURE)
1586 && (n.severity != NOTIF_WARNING)
1587 && (n.severity != NOTIF_OKAY))
1589 INFO ("network plugin: "
1590 "Ignoring notification with "
1591 "unknown severity %i.",
1594 else if (n.time == 0)
1596 INFO ("network plugin: "
1597 "Ignoring notification with "
1600 else if (strlen (n.message) == 0)
1602 INFO ("network plugin: "
1603 "Ignoring notification with "
1604 "an empty message.");
1608 network_dispatch_notification (&n);
1611 else if (pkg_type == TYPE_SEVERITY)
1614 status = parse_part_number (&buffer, &buffer_size,
1617 n.severity = (int) tmp;
1621 DEBUG ("network plugin: parse_packet: Unknown part"
1622 " type: 0x%04hx", pkg_type);
1623 buffer = ((char *) buffer) + pkg_length;
1624 buffer_size -= (size_t) pkg_length;
1626 } /* while (buffer_size > sizeof (part_header_t)) */
1628 if (status == 0 && buffer_size > 0)
1629 WARNING ("network plugin: parse_packet: Received truncated "
1630 "packet, try increasing `MaxPacketSize'");
1633 } /* }}} int parse_packet */
1635 static void free_sockent_client (struct sockent_client *sec) /* {{{ */
1644 sfree (sec->username);
1645 sfree (sec->password);
1646 if (sec->cypher != NULL)
1647 gcry_cipher_close (sec->cypher);
1649 } /* }}} void free_sockent_client */
1651 static void free_sockent_server (struct sockent_server *ses) /* {{{ */
1655 for (i = 0; i < ses->fd_num; i++)
1657 if (ses->fd[i] >= 0)
1666 sfree (ses->auth_file);
1667 fbh_destroy (ses->userdb);
1668 if (ses->cypher != NULL)
1669 gcry_cipher_close (ses->cypher);
1671 } /* }}} void free_sockent_server */
1673 static void sockent_destroy (sockent_t *se) /* {{{ */
1677 DEBUG ("network plugin: sockent_destroy (se = %p);", (void *) se);
1684 sfree (se->service);
1686 if (se->type == SOCKENT_TYPE_CLIENT)
1687 free_sockent_client (&se->data.client);
1689 free_sockent_server (&se->data.server);
1694 } /* }}} void sockent_destroy */
1697 * int network_set_ttl
1699 * Set the `IP_MULTICAST_TTL', `IP_TTL', `IPV6_MULTICAST_HOPS' or
1700 * `IPV6_UNICAST_HOPS', depending on which option is applicable.
1702 * The `struct addrinfo' is used to destinguish between unicast and multicast
1705 static int network_set_ttl (const sockent_t *se, const struct addrinfo *ai)
1707 DEBUG ("network plugin: network_set_ttl: network_config_ttl = %i;",
1708 network_config_ttl);
1710 assert (se->type == SOCKENT_TYPE_CLIENT);
1712 if ((network_config_ttl < 1) || (network_config_ttl > 255))
1715 if (ai->ai_family == AF_INET)
1717 struct sockaddr_in *addr = (struct sockaddr_in *) ai->ai_addr;
1720 if (IN_MULTICAST (ntohl (addr->sin_addr.s_addr)))
1721 optname = IP_MULTICAST_TTL;
1725 if (setsockopt (se->data.client.fd, IPPROTO_IP, optname,
1726 &network_config_ttl,
1727 sizeof (network_config_ttl)) != 0)
1730 ERROR ("network plugin: setsockopt (ipv4-ttl): %s",
1731 sstrerror (errno, errbuf, sizeof (errbuf)));
1735 else if (ai->ai_family == AF_INET6)
1737 /* Useful example: http://gsyc.escet.urjc.es/~eva/IPv6-web/examples/mcast.html */
1738 struct sockaddr_in6 *addr = (struct sockaddr_in6 *) ai->ai_addr;
1741 if (IN6_IS_ADDR_MULTICAST (&addr->sin6_addr))
1742 optname = IPV6_MULTICAST_HOPS;
1744 optname = IPV6_UNICAST_HOPS;
1746 if (setsockopt (se->data.client.fd, IPPROTO_IPV6, optname,
1747 &network_config_ttl,
1748 sizeof (network_config_ttl)) != 0)
1751 ERROR ("network plugin: setsockopt(ipv6-ttl): %s",
1752 sstrerror (errno, errbuf,
1759 } /* int network_set_ttl */
1761 static int network_set_interface (const sockent_t *se, const struct addrinfo *ai) /* {{{ */
1763 DEBUG ("network plugin: network_set_interface: interface index = %i;",
1766 assert (se->type == SOCKENT_TYPE_CLIENT);
1768 if (ai->ai_family == AF_INET)
1770 struct sockaddr_in *addr = (struct sockaddr_in *) ai->ai_addr;
1772 if (IN_MULTICAST (ntohl (addr->sin_addr.s_addr)))
1774 #if HAVE_STRUCT_IP_MREQN_IMR_IFINDEX
1775 /* If possible, use the "ip_mreqn" structure which has
1776 * an "interface index" member. Using the interface
1777 * index is preferred here, because of its similarity
1778 * to the way IPv6 handles this. Unfortunately, it
1779 * appears not to be portable. */
1780 struct ip_mreqn mreq = {
1781 .imr_multiaddr.s_addr = addr->sin_addr.s_addr,
1782 .imr_address.s_addr = ntohl (INADDR_ANY),
1783 .imr_ifindex = se->interface
1786 struct ip_mreq mreq = {
1787 .imr_multiaddr.s_addr = addr->sin_addr.s_addr,
1788 .imr_interface.s_addr = ntohl (INADDR_ANY)
1792 if (setsockopt (se->data.client.fd, IPPROTO_IP, IP_MULTICAST_IF,
1793 &mreq, sizeof (mreq)) != 0)
1796 ERROR ("network plugin: setsockopt (ipv4-multicast-if): %s",
1797 sstrerror (errno, errbuf, sizeof (errbuf)));
1804 else if (ai->ai_family == AF_INET6)
1806 struct sockaddr_in6 *addr = (struct sockaddr_in6 *) ai->ai_addr;
1808 if (IN6_IS_ADDR_MULTICAST (&addr->sin6_addr))
1810 if (setsockopt (se->data.client.fd, IPPROTO_IPV6, IPV6_MULTICAST_IF,
1812 sizeof (se->interface)) != 0)
1815 ERROR ("network plugin: setsockopt (ipv6-multicast-if): %s",
1816 sstrerror (errno, errbuf,
1825 /* else: Not a multicast interface. */
1826 if (se->interface != 0)
1828 #if defined(HAVE_IF_INDEXTONAME) && HAVE_IF_INDEXTONAME && defined(SO_BINDTODEVICE)
1829 char interface_name[IFNAMSIZ];
1831 if (if_indextoname (se->interface, interface_name) == NULL)
1834 DEBUG ("network plugin: Binding socket to interface %s", interface_name);
1836 if (setsockopt (se->data.client.fd, SOL_SOCKET, SO_BINDTODEVICE,
1838 sizeof(interface_name)) == -1 )
1841 ERROR ("network plugin: setsockopt (bind-if): %s",
1842 sstrerror (errno, errbuf, sizeof (errbuf)));
1845 /* #endif HAVE_IF_INDEXTONAME && SO_BINDTODEVICE */
1848 WARNING ("network plugin: Cannot set the interface on a unicast "
1850 # if !defined(SO_BINDTODEVICE)
1851 "the \"SO_BINDTODEVICE\" socket option "
1853 "the \"if_indextoname\" function "
1855 "is not available on your system.");
1861 } /* }}} network_set_interface */
1863 static int network_bind_socket (int fd, const struct addrinfo *ai, const int interface_idx)
1872 /* allow multiple sockets to use the same PORT number */
1873 if (setsockopt (fd, SOL_SOCKET, SO_REUSEADDR,
1874 &yes, sizeof(yes)) == -1) {
1876 ERROR ("network plugin: setsockopt (reuseaddr): %s",
1877 sstrerror (errno, errbuf, sizeof (errbuf)));
1881 DEBUG ("fd = %i; calling `bind'", fd);
1883 if (bind (fd, ai->ai_addr, ai->ai_addrlen) == -1)
1887 sstrerror (errno, errbuf, sizeof (errbuf)));
1891 if (ai->ai_family == AF_INET)
1893 struct sockaddr_in *addr = (struct sockaddr_in *) ai->ai_addr;
1894 if (IN_MULTICAST (ntohl (addr->sin_addr.s_addr)))
1896 #if HAVE_STRUCT_IP_MREQN_IMR_IFINDEX
1897 struct ip_mreqn mreq;
1899 struct ip_mreq mreq;
1902 DEBUG ("fd = %i; IPv4 multicast address found", fd);
1904 mreq.imr_multiaddr.s_addr = addr->sin_addr.s_addr;
1905 #if HAVE_STRUCT_IP_MREQN_IMR_IFINDEX
1906 /* Set the interface using the interface index if
1907 * possible (available). Unfortunately, the struct
1908 * ip_mreqn is not portable. */
1909 mreq.imr_address.s_addr = ntohl (INADDR_ANY);
1910 mreq.imr_ifindex = interface_idx;
1912 mreq.imr_interface.s_addr = ntohl (INADDR_ANY);
1915 if (setsockopt (fd, IPPROTO_IP, IP_MULTICAST_LOOP,
1916 &loop, sizeof (loop)) == -1)
1919 ERROR ("network plugin: setsockopt (multicast-loop): %s",
1920 sstrerror (errno, errbuf,
1925 if (setsockopt (fd, IPPROTO_IP, IP_ADD_MEMBERSHIP,
1926 &mreq, sizeof (mreq)) == -1)
1929 ERROR ("network plugin: setsockopt (add-membership): %s",
1930 sstrerror (errno, errbuf,
1938 else if (ai->ai_family == AF_INET6)
1940 /* Useful example: http://gsyc.escet.urjc.es/~eva/IPv6-web/examples/mcast.html */
1941 struct sockaddr_in6 *addr = (struct sockaddr_in6 *) ai->ai_addr;
1942 if (IN6_IS_ADDR_MULTICAST (&addr->sin6_addr))
1944 struct ipv6_mreq mreq;
1946 DEBUG ("fd = %i; IPv6 multicast address found", fd);
1948 memcpy (&mreq.ipv6mr_multiaddr,
1950 sizeof (addr->sin6_addr));
1952 /* http://developer.apple.com/documentation/Darwin/Reference/ManPages/man4/ip6.4.html
1953 * ipv6mr_interface may be set to zeroes to
1954 * choose the default multicast interface or to
1955 * the index of a particular multicast-capable
1956 * interface if the host is multihomed.
1957 * Membership is associ-associated with a
1958 * single interface; programs running on
1959 * multihomed hosts may need to join the same
1960 * group on more than one interface.*/
1961 mreq.ipv6mr_interface = interface_idx;
1963 if (setsockopt (fd, IPPROTO_IPV6, IPV6_MULTICAST_LOOP,
1964 &loop, sizeof (loop)) == -1)
1967 ERROR ("network plugin: setsockopt (ipv6-multicast-loop): %s",
1968 sstrerror (errno, errbuf,
1973 if (setsockopt (fd, IPPROTO_IPV6, IPV6_ADD_MEMBERSHIP,
1974 &mreq, sizeof (mreq)) == -1)
1977 ERROR ("network plugin: setsockopt (ipv6-add-membership): %s",
1978 sstrerror (errno, errbuf,
1987 #if defined(HAVE_IF_INDEXTONAME) && HAVE_IF_INDEXTONAME && defined(SO_BINDTODEVICE)
1988 /* if a specific interface was set, bind the socket to it. But to avoid
1989 * possible problems with multicast routing, only do that for non-multicast
1991 if (interface_idx != 0)
1993 char interface_name[IFNAMSIZ];
1995 if (if_indextoname (interface_idx, interface_name) == NULL)
1998 DEBUG ("fd = %i; Binding socket to interface %s", fd, interface_name);
2000 if (setsockopt (fd, SOL_SOCKET, SO_BINDTODEVICE,
2002 sizeof(interface_name)) == -1 )
2005 ERROR ("network plugin: setsockopt (bind-if): %s",
2006 sstrerror (errno, errbuf, sizeof (errbuf)));
2010 #endif /* HAVE_IF_INDEXTONAME && SO_BINDTODEVICE */
2013 } /* int network_bind_socket */
2015 /* Initialize a sockent structure. `type' must be either `SOCKENT_TYPE_CLIENT'
2016 * or `SOCKENT_TYPE_SERVER' */
2017 static sockent_t *sockent_create (int type) /* {{{ */
2021 if ((type != SOCKENT_TYPE_CLIENT) && (type != SOCKENT_TYPE_SERVER))
2024 se = calloc (1, sizeof (*se));
2034 if (type == SOCKENT_TYPE_SERVER)
2036 se->data.server.fd = NULL;
2037 se->data.server.fd_num = 0;
2039 se->data.server.security_level = SECURITY_LEVEL_NONE;
2040 se->data.server.auth_file = NULL;
2041 se->data.server.userdb = NULL;
2042 se->data.server.cypher = NULL;
2047 se->data.client.fd = -1;
2048 se->data.client.addr = NULL;
2049 se->data.client.resolve_interval = 0;
2050 se->data.client.next_resolve_reconnect = 0;
2052 se->data.client.security_level = SECURITY_LEVEL_NONE;
2053 se->data.client.username = NULL;
2054 se->data.client.password = NULL;
2055 se->data.client.cypher = NULL;
2060 } /* }}} sockent_t *sockent_create */
2062 static int sockent_init_crypto (sockent_t *se) /* {{{ */
2064 #if HAVE_LIBGCRYPT /* {{{ */
2065 if (se->type == SOCKENT_TYPE_CLIENT)
2067 if (se->data.client.security_level > SECURITY_LEVEL_NONE)
2069 network_init_gcrypt ();
2071 if ((se->data.client.username == NULL)
2072 || (se->data.client.password == NULL))
2074 ERROR ("network plugin: Client socket with "
2075 "security requested, but no "
2076 "credentials are configured.");
2079 gcry_md_hash_buffer (GCRY_MD_SHA256,
2080 se->data.client.password_hash,
2081 se->data.client.password,
2082 strlen (se->data.client.password));
2085 else /* (se->type == SOCKENT_TYPE_SERVER) */
2087 if (se->data.server.security_level > SECURITY_LEVEL_NONE)
2089 network_init_gcrypt ();
2091 if (se->data.server.auth_file == NULL)
2093 ERROR ("network plugin: Server socket with "
2094 "security requested, but no "
2095 "password file is configured.");
2099 if (se->data.server.auth_file != NULL)
2101 se->data.server.userdb = fbh_create (se->data.server.auth_file);
2102 if (se->data.server.userdb == NULL)
2104 ERROR ("network plugin: Reading password file "
2106 se->data.server.auth_file);
2107 if (se->data.server.security_level > SECURITY_LEVEL_NONE)
2112 #endif /* }}} HAVE_LIBGCRYPT */
2115 } /* }}} int sockent_init_crypto */
2117 static int sockent_client_disconnect (sockent_t *se) /* {{{ */
2119 struct sockent_client *client;
2121 if ((se == NULL) || (se->type != SOCKENT_TYPE_CLIENT))
2124 client = &se->data.client;
2125 if (client->fd >= 0) /* connected */
2131 sfree (client->addr);
2132 client->addrlen = 0;
2135 } /* }}} int sockent_client_disconnect */
2137 static int sockent_client_connect (sockent_t *se) /* {{{ */
2139 static c_complain_t complaint = C_COMPLAIN_INIT_STATIC;
2141 struct sockent_client *client;
2142 struct addrinfo ai_hints = { 0 };
2143 struct addrinfo *ai_list = NULL, *ai_ptr;
2145 _Bool reconnect = 0;
2148 if ((se == NULL) || (se->type != SOCKENT_TYPE_CLIENT))
2151 client = &se->data.client;
2154 if (client->resolve_interval != 0 && client->next_resolve_reconnect < now) {
2155 DEBUG("network plugin: Reconnecting socket, resolve_interval = %lf, next_resolve_reconnect = %lf",
2156 CDTIME_T_TO_DOUBLE(client->resolve_interval), CDTIME_T_TO_DOUBLE(client->next_resolve_reconnect));
2160 if (client->fd >= 0 && !reconnect) /* already connected and not stale*/
2163 ai_hints.ai_flags = AI_ADDRCONFIG;
2164 ai_hints.ai_family = AF_UNSPEC;
2165 ai_hints.ai_socktype = SOCK_DGRAM;
2166 ai_hints.ai_protocol = IPPROTO_UDP;
2168 status = getaddrinfo (se->node,
2169 (se->service != NULL) ? se->service : NET_DEFAULT_PORT,
2170 &ai_hints, &ai_list);
2173 c_complain (LOG_ERR, &complaint,
2174 "network plugin: getaddrinfo (%s, %s) failed: %s",
2175 (se->node == NULL) ? "(null)" : se->node,
2176 (se->service == NULL) ? "(null)" : se->service,
2177 gai_strerror (status));
2182 c_release (LOG_NOTICE, &complaint,
2183 "network plugin: Successfully resolved \"%s\".",
2187 for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next)
2189 if (client->fd >= 0) /* when we reconnect */
2190 sockent_client_disconnect(se);
2192 client->fd = socket (ai_ptr->ai_family,
2193 ai_ptr->ai_socktype,
2194 ai_ptr->ai_protocol);
2198 ERROR ("network plugin: socket(2) failed: %s",
2199 sstrerror (errno, errbuf,
2204 client->addr = calloc (1, sizeof (*client->addr));
2205 if (client->addr == NULL)
2207 ERROR ("network plugin: calloc failed.");
2213 assert (sizeof (*client->addr) >= ai_ptr->ai_addrlen);
2214 memcpy (client->addr, ai_ptr->ai_addr, ai_ptr->ai_addrlen);
2215 client->addrlen = ai_ptr->ai_addrlen;
2217 network_set_ttl (se, ai_ptr);
2218 network_set_interface (se, ai_ptr);
2220 /* We don't open more than one write-socket per
2221 * node/service pair.. */
2225 freeaddrinfo (ai_list);
2229 if (client->resolve_interval > 0)
2230 client->next_resolve_reconnect = now + client->resolve_interval;
2232 } /* }}} int sockent_client_connect */
2234 /* Open the file descriptors for a initialized sockent structure. */
2235 static int sockent_server_listen (sockent_t *se) /* {{{ */
2237 struct addrinfo ai_hints = { 0 };
2238 struct addrinfo *ai_list, *ai_ptr;
2242 const char *service;
2247 assert (se->data.server.fd == NULL);
2248 assert (se->data.server.fd_num == 0);
2251 service = se->service;
2253 if (service == NULL)
2254 service = NET_DEFAULT_PORT;
2256 DEBUG ("network plugin: sockent_server_listen: node = %s; service = %s;",
2259 ai_hints.ai_flags = AI_ADDRCONFIG;
2261 ai_hints.ai_flags |= AI_PASSIVE;
2263 ai_hints.ai_family = AF_UNSPEC;
2264 ai_hints.ai_socktype = SOCK_DGRAM;
2265 ai_hints.ai_protocol = IPPROTO_UDP;
2267 status = getaddrinfo (node, service, &ai_hints, &ai_list);
2270 ERROR ("network plugin: getaddrinfo (%s, %s) failed: %s",
2271 (se->node == NULL) ? "(null)" : se->node,
2272 (se->service == NULL) ? "(null)" : se->service,
2273 gai_strerror (status));
2277 for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next)
2281 tmp = realloc (se->data.server.fd,
2282 sizeof (*tmp) * (se->data.server.fd_num + 1));
2285 ERROR ("network plugin: realloc failed.");
2288 se->data.server.fd = tmp;
2289 tmp = se->data.server.fd + se->data.server.fd_num;
2291 *tmp = socket (ai_ptr->ai_family, ai_ptr->ai_socktype,
2292 ai_ptr->ai_protocol);
2296 ERROR ("network plugin: socket(2) failed: %s",
2297 sstrerror (errno, errbuf,
2302 status = network_bind_socket (*tmp, ai_ptr, se->interface);
2310 se->data.server.fd_num++;
2312 } /* for (ai_list) */
2314 freeaddrinfo (ai_list);
2316 if (se->data.server.fd_num == 0)
2319 } /* }}} int sockent_server_listen */
2321 /* Add a sockent to the global list of sockets */
2322 static int sockent_add (sockent_t *se) /* {{{ */
2324 sockent_t *last_ptr;
2329 if (se->type == SOCKENT_TYPE_SERVER)
2334 tmp = realloc (listen_sockets_pollfd,
2335 sizeof (*tmp) * (listen_sockets_num
2336 + se->data.server.fd_num));
2339 ERROR ("network plugin: realloc failed.");
2342 listen_sockets_pollfd = tmp;
2343 tmp = listen_sockets_pollfd + listen_sockets_num;
2345 for (i = 0; i < se->data.server.fd_num; i++)
2347 memset (tmp + i, 0, sizeof (*tmp));
2348 tmp[i].fd = se->data.server.fd[i];
2349 tmp[i].events = POLLIN | POLLPRI;
2353 listen_sockets_num += se->data.server.fd_num;
2355 if (listen_sockets == NULL)
2357 listen_sockets = se;
2360 last_ptr = listen_sockets;
2362 else /* if (se->type == SOCKENT_TYPE_CLIENT) */
2364 if (sending_sockets == NULL)
2366 sending_sockets = se;
2369 last_ptr = sending_sockets;
2372 while (last_ptr->next != NULL)
2373 last_ptr = last_ptr->next;
2374 last_ptr->next = se;
2377 } /* }}} int sockent_add */
2379 static void *dispatch_thread (void __attribute__((unused)) *arg) /* {{{ */
2383 receive_list_entry_t *ent;
2386 /* Lock and wait for more data to come in */
2387 pthread_mutex_lock (&receive_list_lock);
2388 while ((listen_loop == 0)
2389 && (receive_list_head == NULL))
2390 pthread_cond_wait (&receive_list_cond, &receive_list_lock);
2392 /* Remove the head entry and unlock */
2393 ent = receive_list_head;
2395 receive_list_head = ent->next;
2396 receive_list_length--;
2397 pthread_mutex_unlock (&receive_list_lock);
2399 /* Check whether we are supposed to exit. We do NOT check `listen_loop'
2400 * because we dispatch all missing packets before shutting down. */
2404 /* Look for the correct `sockent_t' */
2405 se = listen_sockets;
2410 for (i = 0; i < se->data.server.fd_num; i++)
2411 if (se->data.server.fd[i] == ent->fd)
2414 if (i < se->data.server.fd_num)
2422 ERROR ("network plugin: Got packet from FD %i, but can't "
2423 "find an appropriate socket entry.",
2430 parse_packet (se, ent->data, ent->data_len, /* flags = */ 0,
2431 /* username = */ NULL);
2437 } /* }}} void *dispatch_thread */
2439 static int network_receive (void) /* {{{ */
2441 char buffer[network_config_packet_size];
2447 receive_list_entry_t *private_list_head;
2448 receive_list_entry_t *private_list_tail;
2449 uint64_t private_list_length;
2451 assert (listen_sockets_num > 0);
2453 private_list_head = NULL;
2454 private_list_tail = NULL;
2455 private_list_length = 0;
2457 while (listen_loop == 0)
2459 status = poll (listen_sockets_pollfd, listen_sockets_num, -1);
2465 ERROR ("network plugin: poll(2) failed: %s",
2466 sstrerror (errno, errbuf, sizeof (errbuf)));
2470 for (i = 0; (i < listen_sockets_num) && (status > 0); i++)
2472 receive_list_entry_t *ent;
2474 if ((listen_sockets_pollfd[i].revents
2475 & (POLLIN | POLLPRI)) == 0)
2479 buffer_len = recv (listen_sockets_pollfd[i].fd,
2480 buffer, sizeof (buffer),
2485 status = (errno != 0) ? errno : -1;
2486 ERROR ("network plugin: recv(2) failed: %s",
2487 sstrerror (errno, errbuf, sizeof (errbuf)));
2491 stats_octets_rx += ((uint64_t) buffer_len);
2494 /* TODO: Possible performance enhancement: Do not free
2495 * these entries in the dispatch thread but put them in
2496 * another list, so we don't have to allocate more and
2497 * more of these structures. */
2498 ent = calloc (1, sizeof (*ent));
2501 ERROR ("network plugin: calloc failed.");
2506 ent->data = malloc (network_config_packet_size);
2507 if (ent->data == NULL)
2510 ERROR ("network plugin: malloc failed.");
2514 ent->fd = listen_sockets_pollfd[i].fd;
2517 memcpy (ent->data, buffer, buffer_len);
2518 ent->data_len = buffer_len;
2520 if (private_list_head == NULL)
2521 private_list_head = ent;
2523 private_list_tail->next = ent;
2524 private_list_tail = ent;
2525 private_list_length++;
2527 /* Do not block here. Blocking here has led to
2528 * insufficient performance in the past. */
2529 if (pthread_mutex_trylock (&receive_list_lock) == 0)
2531 assert (((receive_list_head == NULL) && (receive_list_length == 0))
2532 || ((receive_list_head != NULL) && (receive_list_length != 0)));
2534 if (receive_list_head == NULL)
2535 receive_list_head = private_list_head;
2537 receive_list_tail->next = private_list_head;
2538 receive_list_tail = private_list_tail;
2539 receive_list_length += private_list_length;
2541 pthread_cond_signal (&receive_list_cond);
2542 pthread_mutex_unlock (&receive_list_lock);
2544 private_list_head = NULL;
2545 private_list_tail = NULL;
2546 private_list_length = 0;
2550 } /* for (listen_sockets_pollfd) */
2554 } /* while (listen_loop == 0) */
2556 /* Make sure everything is dispatched before exiting. */
2557 if (private_list_head != NULL)
2559 pthread_mutex_lock (&receive_list_lock);
2561 if (receive_list_head == NULL)
2562 receive_list_head = private_list_head;
2564 receive_list_tail->next = private_list_head;
2565 receive_list_tail = private_list_tail;
2566 receive_list_length += private_list_length;
2568 pthread_cond_signal (&receive_list_cond);
2569 pthread_mutex_unlock (&receive_list_lock);
2573 } /* }}} int network_receive */
2575 static void *receive_thread (void __attribute__((unused)) *arg)
2577 return (network_receive () ? (void *) 1 : (void *) 0);
2578 } /* void *receive_thread */
2580 static void network_init_buffer (void)
2582 memset (send_buffer, 0, network_config_packet_size);
2583 send_buffer_ptr = send_buffer;
2584 send_buffer_fill = 0;
2585 send_buffer_last_update = 0;
2587 memset (&send_buffer_vl, 0, sizeof (send_buffer_vl));
2588 } /* int network_init_buffer */
2590 static void network_send_buffer_plain (sockent_t *se, /* {{{ */
2591 const char *buffer, size_t buffer_size)
2597 status = sockent_client_connect (se);
2601 status = sendto (se->data.client.fd, buffer, buffer_size,
2603 (struct sockaddr *) se->data.client.addr,
2604 se->data.client.addrlen);
2609 if ((errno == EINTR) || (errno == EAGAIN))
2612 ERROR ("network plugin: sendto failed: %s. Closing sending socket.",
2613 sstrerror (errno, errbuf, sizeof (errbuf)));
2614 sockent_client_disconnect (se);
2620 } /* }}} void network_send_buffer_plain */
2623 #define BUFFER_ADD(p,s) do { \
2624 memcpy (buffer + buffer_offset, (p), (s)); \
2625 buffer_offset += (s); \
2628 static void network_send_buffer_signed (sockent_t *se, /* {{{ */
2629 const char *in_buffer, size_t in_buffer_size)
2631 char buffer[BUFF_SIG_SIZE + in_buffer_size];
2632 size_t buffer_offset;
2633 size_t username_len;
2637 unsigned char *hash;
2640 err = gcry_md_open (&hd, GCRY_MD_SHA256, GCRY_MD_FLAG_HMAC);
2643 ERROR ("network plugin: Creating HMAC object failed: %s",
2644 gcry_strerror (err));
2648 err = gcry_md_setkey (hd, se->data.client.password,
2649 strlen (se->data.client.password));
2652 ERROR ("network plugin: gcry_md_setkey failed: %s",
2653 gcry_strerror (err));
2658 username_len = strlen (se->data.client.username);
2659 if (username_len > (BUFF_SIG_SIZE - PART_SIGNATURE_SHA256_SIZE))
2661 ERROR ("network plugin: Username too long: %s",
2662 se->data.client.username);
2666 memcpy (buffer + PART_SIGNATURE_SHA256_SIZE,
2667 se->data.client.username, username_len);
2668 memcpy (buffer + PART_SIGNATURE_SHA256_SIZE + username_len,
2669 in_buffer, in_buffer_size);
2671 /* Initialize the `ps' structure. */
2672 part_signature_sha256_t ps = {
2673 .head.type = htons (TYPE_SIGN_SHA256),
2674 .head.length = htons (PART_SIGNATURE_SHA256_SIZE + username_len)
2677 /* Calculate the hash value. */
2678 gcry_md_write (hd, buffer + PART_SIGNATURE_SHA256_SIZE,
2679 username_len + in_buffer_size);
2680 hash = gcry_md_read (hd, GCRY_MD_SHA256);
2683 ERROR ("network plugin: gcry_md_read failed.");
2687 memcpy (ps.hash, hash, sizeof (ps.hash));
2689 /* Add the header */
2692 BUFFER_ADD (&ps.head.type, sizeof (ps.head.type));
2693 BUFFER_ADD (&ps.head.length, sizeof (ps.head.length));
2694 BUFFER_ADD (ps.hash, sizeof (ps.hash));
2696 assert (buffer_offset == PART_SIGNATURE_SHA256_SIZE);
2701 buffer_offset = PART_SIGNATURE_SHA256_SIZE + username_len + in_buffer_size;
2702 network_send_buffer_plain (se, buffer, buffer_offset);
2703 } /* }}} void network_send_buffer_signed */
2705 static void network_send_buffer_encrypted (sockent_t *se, /* {{{ */
2706 const char *in_buffer, size_t in_buffer_size)
2708 char buffer[BUFF_SIG_SIZE + in_buffer_size];
2710 size_t buffer_offset;
2712 size_t username_len;
2714 gcry_cipher_hd_t cypher;
2716 /* Initialize the header fields */
2717 part_encryption_aes256_t pea = {
2718 .head.type = htons (TYPE_ENCR_AES256),
2719 .username = se->data.client.username
2722 username_len = strlen (pea.username);
2723 if ((PART_ENCRYPTION_AES256_SIZE + username_len) > BUFF_SIG_SIZE)
2725 ERROR ("network plugin: Username too long: %s", pea.username);
2729 buffer_size = PART_ENCRYPTION_AES256_SIZE + username_len + in_buffer_size;
2730 header_size = PART_ENCRYPTION_AES256_SIZE + username_len
2731 - sizeof (pea.hash);
2733 assert (buffer_size <= sizeof (buffer));
2734 DEBUG ("network plugin: network_send_buffer_encrypted: "
2735 "buffer_size = %zu;", buffer_size);
2737 pea.head.length = htons ((uint16_t) (PART_ENCRYPTION_AES256_SIZE
2738 + username_len + in_buffer_size));
2739 pea.username_length = htons ((uint16_t) username_len);
2741 /* Chose a random initialization vector. */
2742 gcry_randomize ((void *) &pea.iv, sizeof (pea.iv), GCRY_STRONG_RANDOM);
2744 /* Create hash of the payload */
2745 gcry_md_hash_buffer (GCRY_MD_SHA1, pea.hash, in_buffer, in_buffer_size);
2747 /* Initialize the buffer */
2749 memset (buffer, 0, sizeof (buffer));
2752 BUFFER_ADD (&pea.head.type, sizeof (pea.head.type));
2753 BUFFER_ADD (&pea.head.length, sizeof (pea.head.length));
2754 BUFFER_ADD (&pea.username_length, sizeof (pea.username_length));
2755 BUFFER_ADD (pea.username, username_len);
2756 BUFFER_ADD (pea.iv, sizeof (pea.iv));
2757 assert (buffer_offset == header_size);
2758 BUFFER_ADD (pea.hash, sizeof (pea.hash));
2759 BUFFER_ADD (in_buffer, in_buffer_size);
2761 assert (buffer_offset == buffer_size);
2763 cypher = network_get_aes256_cypher (se, pea.iv, sizeof (pea.iv),
2764 se->data.client.password);
2768 /* Encrypt the buffer in-place */
2769 err = gcry_cipher_encrypt (cypher,
2770 buffer + header_size,
2771 buffer_size - header_size,
2772 /* in = */ NULL, /* in len = */ 0);
2775 ERROR ("network plugin: gcry_cipher_encrypt returned: %s",
2776 gcry_strerror (err));
2780 /* Send it out without further modifications */
2781 network_send_buffer_plain (se, buffer, buffer_size);
2782 } /* }}} void network_send_buffer_encrypted */
2784 #endif /* HAVE_LIBGCRYPT */
2786 static void network_send_buffer (char *buffer, size_t buffer_len) /* {{{ */
2790 DEBUG ("network plugin: network_send_buffer: buffer_len = %zu", buffer_len);
2792 for (se = sending_sockets; se != NULL; se = se->next)
2795 if (se->data.client.security_level == SECURITY_LEVEL_ENCRYPT)
2796 network_send_buffer_encrypted (se, buffer, buffer_len);
2797 else if (se->data.client.security_level == SECURITY_LEVEL_SIGN)
2798 network_send_buffer_signed (se, buffer, buffer_len);
2799 else /* if (se->data.client.security_level == SECURITY_LEVEL_NONE) */
2800 #endif /* HAVE_LIBGCRYPT */
2801 network_send_buffer_plain (se, buffer, buffer_len);
2802 } /* for (sending_sockets) */
2803 } /* }}} void network_send_buffer */
2805 static int add_to_buffer (char *buffer, size_t buffer_size, /* {{{ */
2806 value_list_t *vl_def,
2807 const data_set_t *ds, const value_list_t *vl)
2809 char *buffer_orig = buffer;
2811 if (strcmp (vl_def->host, vl->host) != 0)
2813 if (write_part_string (&buffer, &buffer_size, TYPE_HOST,
2814 vl->host, strlen (vl->host)) != 0)
2816 sstrncpy (vl_def->host, vl->host, sizeof (vl_def->host));
2819 if (vl_def->time != vl->time)
2821 if (write_part_number (&buffer, &buffer_size, TYPE_TIME_HR,
2822 (uint64_t) vl->time))
2824 vl_def->time = vl->time;
2827 if (vl_def->interval != vl->interval)
2829 if (write_part_number (&buffer, &buffer_size, TYPE_INTERVAL_HR,
2830 (uint64_t) vl->interval))
2832 vl_def->interval = vl->interval;
2835 if (strcmp (vl_def->plugin, vl->plugin) != 0)
2837 if (write_part_string (&buffer, &buffer_size, TYPE_PLUGIN,
2838 vl->plugin, strlen (vl->plugin)) != 0)
2840 sstrncpy (vl_def->plugin, vl->plugin, sizeof (vl_def->plugin));
2843 if (strcmp (vl_def->plugin_instance, vl->plugin_instance) != 0)
2845 if (write_part_string (&buffer, &buffer_size, TYPE_PLUGIN_INSTANCE,
2846 vl->plugin_instance,
2847 strlen (vl->plugin_instance)) != 0)
2849 sstrncpy (vl_def->plugin_instance, vl->plugin_instance, sizeof (vl_def->plugin_instance));
2852 if (strcmp (vl_def->type, vl->type) != 0)
2854 if (write_part_string (&buffer, &buffer_size, TYPE_TYPE,
2855 vl->type, strlen (vl->type)) != 0)
2857 sstrncpy (vl_def->type, ds->type, sizeof (vl_def->type));
2860 if (strcmp (vl_def->type_instance, vl->type_instance) != 0)
2862 if (write_part_string (&buffer, &buffer_size, TYPE_TYPE_INSTANCE,
2864 strlen (vl->type_instance)) != 0)
2866 sstrncpy (vl_def->type_instance, vl->type_instance, sizeof (vl_def->type_instance));
2869 if (write_part_values (&buffer, &buffer_size, ds, vl) != 0)
2872 return (buffer - buffer_orig);
2873 } /* }}} int add_to_buffer */
2875 static void flush_buffer (void)
2877 DEBUG ("network plugin: flush_buffer: send_buffer_fill = %i",
2880 network_send_buffer (send_buffer, (size_t) send_buffer_fill);
2882 stats_octets_tx += ((uint64_t) send_buffer_fill);
2885 network_init_buffer ();
2888 static int network_write (const data_set_t *ds, const value_list_t *vl,
2889 user_data_t __attribute__((unused)) *user_data)
2893 if (!check_send_okay (vl))
2896 char name[6*DATA_MAX_NAME_LEN];
2897 FORMAT_VL (name, sizeof (name), vl);
2898 name[sizeof (name) - 1] = 0;
2899 DEBUG ("network plugin: network_write: "
2900 "NOT sending %s.", name);
2902 /* Counter is not protected by another lock and may be reached by
2903 * multiple threads */
2904 pthread_mutex_lock (&stats_lock);
2905 stats_values_not_sent++;
2906 pthread_mutex_unlock (&stats_lock);
2910 uc_meta_data_add_unsigned_int (vl,
2911 "network:time_sent", (uint64_t) vl->time);
2913 pthread_mutex_lock (&send_buffer_lock);
2915 status = add_to_buffer (send_buffer_ptr,
2916 network_config_packet_size - (send_buffer_fill + BUFF_SIG_SIZE),
2921 /* status == bytes added to the buffer */
2922 send_buffer_fill += status;
2923 send_buffer_ptr += status;
2924 send_buffer_last_update = cdtime();
2926 stats_values_sent++;
2932 status = add_to_buffer (send_buffer_ptr,
2933 network_config_packet_size - (send_buffer_fill + BUFF_SIG_SIZE),
2939 send_buffer_fill += status;
2940 send_buffer_ptr += status;
2942 stats_values_sent++;
2948 ERROR ("network plugin: Unable to append to the "
2949 "buffer for some weird reason");
2951 else if ((network_config_packet_size - send_buffer_fill) < 15)
2956 pthread_mutex_unlock (&send_buffer_lock);
2958 return ((status < 0) ? -1 : 0);
2959 } /* int network_write */
2961 static int network_config_set_ttl (const oconfig_item_t *ci) /* {{{ */
2965 if (cf_util_get_int (ci, &tmp) != 0)
2967 else if ((tmp > 0) && (tmp <= 255))
2968 network_config_ttl = tmp;
2970 WARNING ("network plugin: The `TimeToLive' must be between 1 and 255.");
2975 } /* }}} int network_config_set_ttl */
2977 static int network_config_set_interface (const oconfig_item_t *ci, /* {{{ */
2982 if (cf_util_get_string_buffer (ci, if_name, sizeof (if_name)) != 0)
2985 *interface = if_nametoindex (if_name);
2987 } /* }}} int network_config_set_interface */
2989 static int network_config_set_buffer_size (const oconfig_item_t *ci) /* {{{ */
2993 if (cf_util_get_int (ci, &tmp) != 0)
2995 else if ((tmp >= 1024) && (tmp <= 65535))
2996 network_config_packet_size = tmp;
2998 WARNING ("network plugin: The `MaxPacketSize' must be between 1024 and 65535.");
3003 } /* }}} int network_config_set_buffer_size */
3006 static int network_config_set_security_level (oconfig_item_t *ci, /* {{{ */
3010 if ((ci->values_num != 1)
3011 || (ci->values[0].type != OCONFIG_TYPE_STRING))
3013 WARNING ("network plugin: The `SecurityLevel' config option needs exactly "
3014 "one string argument.");
3018 str = ci->values[0].value.string;
3019 if (strcasecmp ("Encrypt", str) == 0)
3020 *retval = SECURITY_LEVEL_ENCRYPT;
3021 else if (strcasecmp ("Sign", str) == 0)
3022 *retval = SECURITY_LEVEL_SIGN;
3023 else if (strcasecmp ("None", str) == 0)
3024 *retval = SECURITY_LEVEL_NONE;
3027 WARNING ("network plugin: Unknown security level: %s.", str);
3032 } /* }}} int network_config_set_security_level */
3033 #endif /* HAVE_LIBGCRYPT */
3035 static int network_config_add_listen (const oconfig_item_t *ci) /* {{{ */
3041 if ((ci->values_num < 1) || (ci->values_num > 2)
3042 || (ci->values[0].type != OCONFIG_TYPE_STRING)
3043 || ((ci->values_num > 1) && (ci->values[1].type != OCONFIG_TYPE_STRING)))
3045 ERROR ("network plugin: The `%s' config option needs "
3046 "one or two string arguments.", ci->key);
3050 se = sockent_create (SOCKENT_TYPE_SERVER);
3053 ERROR ("network plugin: sockent_create failed.");
3057 se->node = strdup (ci->values[0].value.string);
3058 if (ci->values_num >= 2)
3059 se->service = strdup (ci->values[1].value.string);
3061 for (i = 0; i < ci->children_num; i++)
3063 oconfig_item_t *child = ci->children + i;
3066 if (strcasecmp ("AuthFile", child->key) == 0)
3067 cf_util_get_string (child, &se->data.server.auth_file);
3068 else if (strcasecmp ("SecurityLevel", child->key) == 0)
3069 network_config_set_security_level (child,
3070 &se->data.server.security_level);
3072 #endif /* HAVE_LIBGCRYPT */
3073 if (strcasecmp ("Interface", child->key) == 0)
3074 network_config_set_interface (child, &se->interface);
3077 WARNING ("network plugin: Option `%s' is not allowed here.",
3083 if ((se->data.server.security_level > SECURITY_LEVEL_NONE)
3084 && (se->data.server.auth_file == NULL))
3086 ERROR ("network plugin: A security level higher than `none' was "
3087 "requested, but no AuthFile option was given. Cowardly refusing to "
3088 "open this socket!");
3089 sockent_destroy (se);
3092 #endif /* HAVE_LIBGCRYPT */
3094 status = sockent_init_crypto (se);
3097 ERROR ("network plugin: network_config_add_listen: sockent_init_crypto() failed.");
3098 sockent_destroy (se);
3102 status = sockent_server_listen (se);
3105 ERROR ("network plugin: network_config_add_listen: sockent_server_listen failed.");
3106 sockent_destroy (se);
3110 status = sockent_add (se);
3113 ERROR ("network plugin: network_config_add_listen: sockent_add failed.");
3114 sockent_destroy (se);
3119 } /* }}} int network_config_add_listen */
3121 static int network_config_add_server (const oconfig_item_t *ci) /* {{{ */
3127 if ((ci->values_num < 1) || (ci->values_num > 2)
3128 || (ci->values[0].type != OCONFIG_TYPE_STRING)
3129 || ((ci->values_num > 1) && (ci->values[1].type != OCONFIG_TYPE_STRING)))
3131 ERROR ("network plugin: The `%s' config option needs "
3132 "one or two string arguments.", ci->key);
3136 se = sockent_create (SOCKENT_TYPE_CLIENT);
3139 ERROR ("network plugin: sockent_create failed.");
3143 se->node = strdup (ci->values[0].value.string);
3144 if (ci->values_num >= 2)
3145 se->service = strdup (ci->values[1].value.string);
3147 for (i = 0; i < ci->children_num; i++)
3149 oconfig_item_t *child = ci->children + i;
3152 if (strcasecmp ("Username", child->key) == 0)
3153 cf_util_get_string (child, &se->data.client.username);
3154 else if (strcasecmp ("Password", child->key) == 0)
3155 cf_util_get_string (child, &se->data.client.password);
3156 else if (strcasecmp ("SecurityLevel", child->key) == 0)
3157 network_config_set_security_level (child,
3158 &se->data.client.security_level);
3160 #endif /* HAVE_LIBGCRYPT */
3161 if (strcasecmp ("Interface", child->key) == 0)
3162 network_config_set_interface (child, &se->interface);
3163 else if (strcasecmp ("ResolveInterval", child->key) == 0)
3164 cf_util_get_cdtime(child, &se->data.client.resolve_interval);
3167 WARNING ("network plugin: Option `%s' is not allowed here.",
3173 if ((se->data.client.security_level > SECURITY_LEVEL_NONE)
3174 && ((se->data.client.username == NULL)
3175 || (se->data.client.password == NULL)))
3177 ERROR ("network plugin: A security level higher than `none' was "
3178 "requested, but no Username or Password option was given. "
3179 "Cowardly refusing to open this socket!");
3180 sockent_destroy (se);
3183 #endif /* HAVE_LIBGCRYPT */
3185 status = sockent_init_crypto (se);
3188 ERROR ("network plugin: network_config_add_server: sockent_init_crypto() failed.");
3189 sockent_destroy (se);
3193 /* No call to sockent_client_connect() here -- it is called from
3194 * network_send_buffer_plain(). */
3196 status = sockent_add (se);
3199 ERROR ("network plugin: network_config_add_server: sockent_add failed.");
3200 sockent_destroy (se);
3205 } /* }}} int network_config_add_server */
3207 static int network_config (oconfig_item_t *ci) /* {{{ */
3211 /* The options need to be applied first */
3212 for (i = 0; i < ci->children_num; i++)
3214 oconfig_item_t *child = ci->children + i;
3215 if (strcasecmp ("TimeToLive", child->key) == 0)
3216 network_config_set_ttl (child);
3219 for (i = 0; i < ci->children_num; i++)
3221 oconfig_item_t *child = ci->children + i;
3223 if (strcasecmp ("Listen", child->key) == 0)
3224 network_config_add_listen (child);
3225 else if (strcasecmp ("Server", child->key) == 0)
3226 network_config_add_server (child);
3227 else if (strcasecmp ("TimeToLive", child->key) == 0) {
3228 /* Handled earlier */
3230 else if (strcasecmp ("MaxPacketSize", child->key) == 0)
3231 network_config_set_buffer_size (child);
3232 else if (strcasecmp ("Forward", child->key) == 0)
3233 cf_util_get_boolean (child, &network_config_forward);
3234 else if (strcasecmp ("ReportStats", child->key) == 0)
3235 cf_util_get_boolean (child, &network_config_stats);
3238 WARNING ("network plugin: Option `%s' is not allowed here.",
3244 } /* }}} int network_config */
3246 static int network_notification (const notification_t *n,
3247 user_data_t __attribute__((unused)) *user_data)
3249 char buffer[network_config_packet_size];
3250 char *buffer_ptr = buffer;
3251 size_t buffer_free = sizeof (buffer);
3254 if (!check_send_notify_okay (n))
3257 memset (buffer, 0, sizeof (buffer));
3259 status = write_part_number (&buffer_ptr, &buffer_free, TYPE_TIME_HR,
3260 (uint64_t) n->time);
3264 status = write_part_number (&buffer_ptr, &buffer_free, TYPE_SEVERITY,
3265 (uint64_t) n->severity);
3269 if (strlen (n->host) > 0)
3271 status = write_part_string (&buffer_ptr, &buffer_free, TYPE_HOST,
3272 n->host, strlen (n->host));
3277 if (strlen (n->plugin) > 0)
3279 status = write_part_string (&buffer_ptr, &buffer_free, TYPE_PLUGIN,
3280 n->plugin, strlen (n->plugin));
3285 if (strlen (n->plugin_instance) > 0)
3287 status = write_part_string (&buffer_ptr, &buffer_free,
3288 TYPE_PLUGIN_INSTANCE,
3289 n->plugin_instance, strlen (n->plugin_instance));
3294 if (strlen (n->type) > 0)
3296 status = write_part_string (&buffer_ptr, &buffer_free, TYPE_TYPE,
3297 n->type, strlen (n->type));
3302 if (strlen (n->type_instance) > 0)
3304 status = write_part_string (&buffer_ptr, &buffer_free, TYPE_TYPE_INSTANCE,
3305 n->type_instance, strlen (n->type_instance));
3310 status = write_part_string (&buffer_ptr, &buffer_free, TYPE_MESSAGE,
3311 n->message, strlen (n->message));
3315 network_send_buffer (buffer, sizeof (buffer) - buffer_free);
3318 } /* int network_notification */
3320 static int network_shutdown (void)
3326 /* Kill the listening thread */
3327 if (receive_thread_running != 0)
3329 INFO ("network plugin: Stopping receive thread.");
3330 pthread_kill (receive_thread_id, SIGTERM);
3331 pthread_join (receive_thread_id, NULL /* no return value */);
3332 memset (&receive_thread_id, 0, sizeof (receive_thread_id));
3333 receive_thread_running = 0;
3336 /* Shutdown the dispatching thread */
3337 if (dispatch_thread_running != 0)
3339 INFO ("network plugin: Stopping dispatch thread.");
3340 pthread_mutex_lock (&receive_list_lock);
3341 pthread_cond_broadcast (&receive_list_cond);
3342 pthread_mutex_unlock (&receive_list_lock);
3343 pthread_join (dispatch_thread_id, /* ret = */ NULL);
3344 dispatch_thread_running = 0;
3347 sockent_destroy (listen_sockets);
3349 if (send_buffer_fill > 0)
3352 sfree (send_buffer);
3354 for (se = sending_sockets; se != NULL; se = se->next)
3355 sockent_client_disconnect (se);
3356 sockent_destroy (sending_sockets);
3358 plugin_unregister_config ("network");
3359 plugin_unregister_init ("network");
3360 plugin_unregister_write ("network");
3361 plugin_unregister_shutdown ("network");
3364 } /* int network_shutdown */
3366 static int network_stats_read (void) /* {{{ */
3368 derive_t copy_octets_rx;
3369 derive_t copy_octets_tx;
3370 derive_t copy_packets_rx;
3371 derive_t copy_packets_tx;
3372 derive_t copy_values_dispatched;
3373 derive_t copy_values_not_dispatched;
3374 derive_t copy_values_sent;
3375 derive_t copy_values_not_sent;
3376 derive_t copy_receive_list_length;
3377 value_list_t vl = VALUE_LIST_INIT;
3380 copy_octets_rx = stats_octets_rx;
3381 copy_octets_tx = stats_octets_tx;
3382 copy_packets_rx = stats_packets_rx;
3383 copy_packets_tx = stats_packets_tx;
3384 copy_values_dispatched = stats_values_dispatched;
3385 copy_values_not_dispatched = stats_values_not_dispatched;
3386 copy_values_sent = stats_values_sent;
3387 copy_values_not_sent = stats_values_not_sent;
3388 copy_receive_list_length = receive_list_length;
3390 /* Initialize `vl' */
3394 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
3395 sstrncpy (vl.plugin, "network", sizeof (vl.plugin));
3397 /* Octets received / sent */
3398 vl.values[0].derive = (derive_t) copy_octets_rx;
3399 vl.values[1].derive = (derive_t) copy_octets_tx;
3400 sstrncpy (vl.type, "if_octets", sizeof (vl.type));
3401 plugin_dispatch_values (&vl);
3403 /* Packets received / send */
3404 vl.values[0].derive = (derive_t) copy_packets_rx;
3405 vl.values[1].derive = (derive_t) copy_packets_tx;
3406 sstrncpy (vl.type, "if_packets", sizeof (vl.type));
3407 plugin_dispatch_values (&vl);
3409 /* Values (not) dispatched and (not) send */
3410 sstrncpy (vl.type, "total_values", sizeof (vl.type));
3413 vl.values[0].derive = (derive_t) copy_values_dispatched;
3414 sstrncpy (vl.type_instance, "dispatch-accepted",
3415 sizeof (vl.type_instance));
3416 plugin_dispatch_values (&vl);
3418 vl.values[0].derive = (derive_t) copy_values_not_dispatched;
3419 sstrncpy (vl.type_instance, "dispatch-rejected",
3420 sizeof (vl.type_instance));
3421 plugin_dispatch_values (&vl);
3423 vl.values[0].derive = (derive_t) copy_values_sent;
3424 sstrncpy (vl.type_instance, "send-accepted",
3425 sizeof (vl.type_instance));
3426 plugin_dispatch_values (&vl);
3428 vl.values[0].derive = (derive_t) copy_values_not_sent;
3429 sstrncpy (vl.type_instance, "send-rejected",
3430 sizeof (vl.type_instance));
3431 plugin_dispatch_values (&vl);
3433 /* Receive queue length */
3434 vl.values[0].gauge = (gauge_t) copy_receive_list_length;
3435 sstrncpy (vl.type, "queue_length", sizeof (vl.type));
3436 vl.type_instance[0] = 0;
3437 plugin_dispatch_values (&vl);
3440 } /* }}} int network_stats_read */
3442 static int network_init (void)
3444 static _Bool have_init = 0;
3446 /* Check if we were already initialized. If so, just return - there's
3447 * nothing more to do (for now, that is). */
3453 network_init_gcrypt ();
3456 if (network_config_stats)
3457 plugin_register_read ("network", network_stats_read);
3459 plugin_register_shutdown ("network", network_shutdown);
3461 send_buffer = malloc (network_config_packet_size);
3462 if (send_buffer == NULL)
3464 ERROR ("network plugin: malloc failed.");
3467 network_init_buffer ();
3469 /* setup socket(s) and so on */
3470 if (sending_sockets != NULL)
3472 plugin_register_write ("network", network_write,
3473 /* user_data = */ NULL);
3474 plugin_register_notification ("network", network_notification,
3475 /* user_data = */ NULL);
3478 /* If no threads need to be started, return here. */
3479 if ((listen_sockets_num == 0)
3480 || ((dispatch_thread_running != 0)
3481 && (receive_thread_running != 0)))
3484 if (dispatch_thread_running == 0)
3487 status = plugin_thread_create (&dispatch_thread_id,
3488 NULL /* no attributes */,
3490 NULL /* no argument */);
3494 ERROR ("network: pthread_create failed: %s",
3495 sstrerror (errno, errbuf,
3500 dispatch_thread_running = 1;
3504 if (receive_thread_running == 0)
3507 status = plugin_thread_create (&receive_thread_id,
3508 NULL /* no attributes */,
3510 NULL /* no argument */);
3514 ERROR ("network: pthread_create failed: %s",
3515 sstrerror (errno, errbuf,
3520 receive_thread_running = 1;
3525 } /* int network_init */
3528 * The flush option of the network plugin cannot flush individual identifiers.
3529 * All the values are added to a buffer and sent when the buffer is full, the
3530 * requested value may or may not be in there, it's not worth finding out. We
3531 * just send the buffer if `flush' is called - if the requested value was in
3532 * there, good. If not, well, then there is nothing to flush.. -octo
3534 static int network_flush (cdtime_t timeout,
3535 __attribute__((unused)) const char *identifier,
3536 __attribute__((unused)) user_data_t *user_data)
3538 pthread_mutex_lock (&send_buffer_lock);
3540 if (send_buffer_fill > 0)
3544 cdtime_t now = cdtime ();
3545 if ((send_buffer_last_update + timeout) > now)
3547 pthread_mutex_unlock (&send_buffer_lock);
3553 pthread_mutex_unlock (&send_buffer_lock);
3556 } /* int network_flush */
3558 void module_register (void)
3560 plugin_register_complex_config ("network", network_config);
3561 plugin_register_init ("network", network_init);
3562 plugin_register_flush ("network", network_flush,
3563 /* user_data = */ NULL);
3564 } /* void module_register */
3566 /* vim: set fdm=marker : */