503153913052b2943ad1451d2d95439be1f48160
[collectd.git] / src / curl.c
1 /**
2  * collectd - src/curl.c
3  * Copyright (C) 2006-2009  Florian octo Forster
4  * Copyright (C) 2009       Aman Gupta
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms of the GNU General Public License as published by the
8  * Free Software Foundation; only version 2 of the License is applicable.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License along
16  * with this program; if not, write to the Free Software Foundation, Inc.,
17  * 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
18  *
19  * Authors:
20  *   Florian octo Forster <octo at collectd.org>
21  *   Aman Gupta <aman at tmm1.net>
22  **/
23
24 #include "collectd.h"
25 #include "common.h"
26 #include "plugin.h"
27 #include "configfile.h"
28 #include "utils_match.h"
29 #include "utils_time.h"
30
31 #include <curl/curl.h>
32
33 /*
34  * Data types
35  */
36 struct web_match_s;
37 typedef struct web_match_s web_match_t;
38 struct web_match_s /* {{{ */
39 {
40   char *regex;
41   char *exclude_regex;
42   int dstype;
43   char *type;
44   char *instance;
45
46   cu_match_t *match;
47
48   web_match_t *next;
49 }; /* }}} */
50
51 struct web_page_s;
52 typedef struct web_page_s web_page_t;
53 struct web_page_s /* {{{ */
54 {
55   char *instance;
56
57   char *url;
58   char *user;
59   char *pass;
60   char *credentials;
61   _Bool digest;
62   _Bool verify_peer;
63   _Bool verify_host;
64   char *cacert;
65   struct curl_slist *headers;
66   char *post_body;
67   _Bool response_time;
68   _Bool response_code;
69   int timeout;
70
71   CURL *curl;
72   char curl_errbuf[CURL_ERROR_SIZE];
73   char *buffer;
74   size_t buffer_size;
75   size_t buffer_fill;
76
77   web_match_t *matches;
78
79   web_page_t *next;
80 }; /* }}} */
81
82 /*
83  * Global variables;
84  */
85 /* static CURLM *curl = NULL; */
86 static web_page_t *pages_g = NULL;
87
88 /*
89  * Private functions
90  */
91 static size_t cc_curl_callback (void *buf, /* {{{ */
92     size_t size, size_t nmemb, void *user_data)
93 {
94   web_page_t *wp;
95   size_t len;
96
97   len = size * nmemb;
98   if (len <= 0)
99     return (len);
100
101   wp = user_data;
102   if (wp == NULL)
103     return (0);
104
105   if ((wp->buffer_fill + len) >= wp->buffer_size)
106   {
107     char *temp;
108     size_t temp_size;
109
110     temp_size = wp->buffer_fill + len + 1;
111     temp = (char *) realloc (wp->buffer, temp_size);
112     if (temp == NULL)
113     {
114       ERROR ("curl plugin: realloc failed.");
115       return (0);
116     }
117     wp->buffer = temp;
118     wp->buffer_size = temp_size;
119   }
120
121   memcpy (wp->buffer + wp->buffer_fill, (char *) buf, len);
122   wp->buffer_fill += len;
123   wp->buffer[wp->buffer_fill] = 0;
124
125   return (len);
126 } /* }}} size_t cc_curl_callback */
127
128 static void cc_web_match_free (web_match_t *wm) /* {{{ */
129 {
130   if (wm == NULL)
131     return;
132
133   sfree (wm->regex);
134   sfree (wm->type);
135   sfree (wm->instance);
136   match_destroy (wm->match);
137   cc_web_match_free (wm->next);
138   sfree (wm);
139 } /* }}} void cc_web_match_free */
140
141 static void cc_web_page_free (web_page_t *wp) /* {{{ */
142 {
143   if (wp == NULL)
144     return;
145
146   if (wp->curl != NULL)
147     curl_easy_cleanup (wp->curl);
148   wp->curl = NULL;
149
150   sfree (wp->instance);
151
152   sfree (wp->url);
153   sfree (wp->user);
154   sfree (wp->pass);
155   sfree (wp->credentials);
156   sfree (wp->cacert);
157   sfree (wp->post_body);
158   curl_slist_free_all (wp->headers);
159
160   sfree (wp->buffer);
161
162   cc_web_match_free (wp->matches);
163   cc_web_page_free (wp->next);
164   sfree (wp);
165 } /* }}} void cc_web_page_free */
166
167 static int cc_config_append_string (const char *name, struct curl_slist **dest, /* {{{ */
168     oconfig_item_t *ci)
169 {
170   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING))
171   {
172     WARNING ("curl plugin: `%s' needs exactly one string argument.", name);
173     return (-1);
174   }
175
176   *dest = curl_slist_append(*dest, ci->values[0].value.string);
177   if (*dest == NULL)
178     return (-1);
179
180   return (0);
181 } /* }}} int cc_config_append_string */
182
183 static int cc_config_add_match_dstype (int *dstype_ret, /* {{{ */
184     oconfig_item_t *ci)
185 {
186   int dstype;
187
188   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING))
189   {
190     WARNING ("curl plugin: `DSType' needs exactly one string argument.");
191     return (-1);
192   }
193
194   if (strncasecmp ("Gauge", ci->values[0].value.string,
195         strlen ("Gauge")) == 0)
196   {
197     dstype = UTILS_MATCH_DS_TYPE_GAUGE;
198     if (strcasecmp ("GaugeAverage", ci->values[0].value.string) == 0)
199       dstype |= UTILS_MATCH_CF_GAUGE_AVERAGE;
200     else if (strcasecmp ("GaugeMin", ci->values[0].value.string) == 0)
201       dstype |= UTILS_MATCH_CF_GAUGE_MIN;
202     else if (strcasecmp ("GaugeMax", ci->values[0].value.string) == 0)
203       dstype |= UTILS_MATCH_CF_GAUGE_MAX;
204     else if (strcasecmp ("GaugeLast", ci->values[0].value.string) == 0)
205       dstype |= UTILS_MATCH_CF_GAUGE_LAST;
206     else
207       dstype = 0;
208   }
209   else if (strncasecmp ("Counter", ci->values[0].value.string,
210         strlen ("Counter")) == 0)
211   {
212     dstype = UTILS_MATCH_DS_TYPE_COUNTER;
213     if (strcasecmp ("CounterSet", ci->values[0].value.string) == 0)
214       dstype |= UTILS_MATCH_CF_COUNTER_SET;
215     else if (strcasecmp ("CounterAdd", ci->values[0].value.string) == 0)
216       dstype |= UTILS_MATCH_CF_COUNTER_ADD;
217     else if (strcasecmp ("CounterInc", ci->values[0].value.string) == 0)
218       dstype |= UTILS_MATCH_CF_COUNTER_INC;
219     else
220       dstype = 0;
221   }
222 else if (strncasecmp ("Derive", ci->values[0].value.string,
223         strlen ("Derive")) == 0)
224   {
225     dstype = UTILS_MATCH_DS_TYPE_DERIVE;
226     if (strcasecmp ("DeriveSet", ci->values[0].value.string) == 0)
227       dstype |= UTILS_MATCH_CF_DERIVE_SET;
228     else if (strcasecmp ("DeriveAdd", ci->values[0].value.string) == 0)
229       dstype |= UTILS_MATCH_CF_DERIVE_ADD;
230     else if (strcasecmp ("DeriveInc", ci->values[0].value.string) == 0)
231       dstype |= UTILS_MATCH_CF_DERIVE_INC;
232     else
233       dstype = 0;
234   }
235 else if (strncasecmp ("Absolute", ci->values[0].value.string,
236         strlen ("Absolute")) == 0)
237   {
238     dstype = UTILS_MATCH_DS_TYPE_ABSOLUTE;
239     if (strcasecmp ("AbsoluteSet", ci->values[0].value.string) == 0) /* Absolute DS is reset-on-read so no sense doin anything else but set */
240       dstype |= UTILS_MATCH_CF_ABSOLUTE_SET;
241     else
242       dstype = 0;
243   }
244
245   else
246   {
247     dstype = 0;
248   }
249
250   if (dstype == 0)
251   {
252     WARNING ("curl plugin: `%s' is not a valid argument to `DSType'.",
253         ci->values[0].value.string);
254     return (-1);
255   }
256
257   *dstype_ret = dstype;
258   return (0);
259 } /* }}} int cc_config_add_match_dstype */
260
261 static int cc_config_add_match (web_page_t *page, /* {{{ */
262     oconfig_item_t *ci)
263 {
264   web_match_t *match;
265   int status;
266   int i;
267
268   if (ci->values_num != 0)
269   {
270     WARNING ("curl plugin: Ignoring arguments for the `Match' block.");
271   }
272
273   match = (web_match_t *) malloc (sizeof (*match));
274   if (match == NULL)
275   {
276     ERROR ("curl plugin: malloc failed.");
277     return (-1);
278   }
279   memset (match, 0, sizeof (*match));
280
281   status = 0;
282   for (i = 0; i < ci->children_num; i++)
283   {
284     oconfig_item_t *child = ci->children + i;
285
286     if (strcasecmp ("Regex", child->key) == 0)
287       status = cf_util_get_string (child, &match->regex);
288     else if (strcasecmp ("ExcludeRegex", child->key) == 0)
289       status = cf_util_get_string (child, &match->exclude_regex);
290     else if (strcasecmp ("DSType", child->key) == 0)
291       status = cc_config_add_match_dstype (&match->dstype, child);
292     else if (strcasecmp ("Type", child->key) == 0)
293       status = cf_util_get_string (child, &match->type);
294     else if (strcasecmp ("Instance", child->key) == 0)
295       status = cf_util_get_string (child, &match->instance);
296     else
297     {
298       WARNING ("curl plugin: Option `%s' not allowed here.", child->key);
299       status = -1;
300     }
301
302     if (status != 0)
303       break;
304   } /* for (i = 0; i < ci->children_num; i++) */
305
306   while (status == 0)
307   {
308     if (match->regex == NULL)
309     {
310       WARNING ("curl plugin: `Regex' missing in `Match' block.");
311       status = -1;
312     }
313
314     if (match->type == NULL)
315     {
316       WARNING ("curl plugin: `Type' missing in `Match' block.");
317       status = -1;
318     }
319
320     if (match->dstype == 0)
321     {
322       WARNING ("curl plugin: `DSType' missing in `Match' block.");
323       status = -1;
324     }
325
326     break;
327   } /* while (status == 0) */
328
329   if (status != 0)
330     return (status);
331
332   match->match = match_create_simple (match->regex, match->exclude_regex,
333       match->dstype);
334   if (match->match == NULL)
335   {
336     ERROR ("curl plugin: tail_match_add_match_simple failed.");
337     cc_web_match_free (match);
338     return (-1);
339   }
340   else
341   {
342     web_match_t *prev;
343
344     prev = page->matches;
345     while ((prev != NULL) && (prev->next != NULL))
346       prev = prev->next;
347
348     if (prev == NULL)
349       page->matches = match;
350     else
351       prev->next = match;
352   }
353
354   return (0);
355 } /* }}} int cc_config_add_match */
356
357 static int cc_page_init_curl (web_page_t *wp) /* {{{ */
358 {
359   wp->curl = curl_easy_init ();
360   if (wp->curl == NULL)
361   {
362     ERROR ("curl plugin: curl_easy_init failed.");
363     return (-1);
364   }
365
366   curl_easy_setopt (wp->curl, CURLOPT_NOSIGNAL, 1L);
367   curl_easy_setopt (wp->curl, CURLOPT_WRITEFUNCTION, cc_curl_callback);
368   curl_easy_setopt (wp->curl, CURLOPT_WRITEDATA, wp);
369   curl_easy_setopt (wp->curl, CURLOPT_USERAGENT, COLLECTD_USERAGENT);
370   curl_easy_setopt (wp->curl, CURLOPT_ERRORBUFFER, wp->curl_errbuf);
371   curl_easy_setopt (wp->curl, CURLOPT_URL, wp->url);
372   curl_easy_setopt (wp->curl, CURLOPT_FOLLOWLOCATION, 1L);
373   curl_easy_setopt (wp->curl, CURLOPT_MAXREDIRS, 50L);
374
375   if (wp->user != NULL)
376   {
377 #ifdef HAVE_CURLOPT_USERNAME
378     curl_easy_setopt (wp->curl, CURLOPT_USERNAME, wp->user);
379     curl_easy_setopt (wp->curl, CURLOPT_PASSWORD,
380         (wp->pass == NULL) ? "" : wp->pass);
381 #else
382     size_t credentials_size;
383
384     credentials_size = strlen (wp->user) + 2;
385     if (wp->pass != NULL)
386       credentials_size += strlen (wp->pass);
387
388     wp->credentials = (char *) malloc (credentials_size);
389     if (wp->credentials == NULL)
390     {
391       ERROR ("curl plugin: malloc failed.");
392       return (-1);
393     }
394
395     ssnprintf (wp->credentials, credentials_size, "%s:%s",
396         wp->user, (wp->pass == NULL) ? "" : wp->pass);
397     curl_easy_setopt (wp->curl, CURLOPT_USERPWD, wp->credentials);
398 #endif
399
400     if (wp->digest)
401       curl_easy_setopt (wp->curl, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST);
402   }
403
404   curl_easy_setopt (wp->curl, CURLOPT_SSL_VERIFYPEER, (long) wp->verify_peer);
405   curl_easy_setopt (wp->curl, CURLOPT_SSL_VERIFYHOST,
406       wp->verify_host ? 2L : 0L);
407   if (wp->cacert != NULL)
408     curl_easy_setopt (wp->curl, CURLOPT_CAINFO, wp->cacert);
409   if (wp->headers != NULL)
410     curl_easy_setopt (wp->curl, CURLOPT_HTTPHEADER, wp->headers);
411   if (wp->post_body != NULL)
412     curl_easy_setopt (wp->curl, CURLOPT_POSTFIELDS, wp->post_body);
413   curl_easy_setopt (wp->curl, CURLOPT_TIMEOUT_MS, wp->timeout > 0 ? wp->timeout : cf_get_default_interval ());
414
415   return (0);
416 } /* }}} int cc_page_init_curl */
417
418 static int cc_config_add_page (oconfig_item_t *ci) /* {{{ */
419 {
420   web_page_t *page;
421   int status;
422   int i;
423
424   if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING))
425   {
426     WARNING ("curl plugin: `Page' blocks need exactly one string argument.");
427     return (-1);
428   }
429
430   page = (web_page_t *) malloc (sizeof (*page));
431   if (page == NULL)
432   {
433     ERROR ("curl plugin: malloc failed.");
434     return (-1);
435   }
436   memset (page, 0, sizeof (*page));
437   page->url = NULL;
438   page->user = NULL;
439   page->pass = NULL;
440   page->digest = 0;
441   page->verify_peer = 1;
442   page->verify_host = 1;
443   page->response_time = 0;
444   page->response_code = 0;
445   page->timeout = 0;
446
447   page->instance = strdup (ci->values[0].value.string);
448   if (page->instance == NULL)
449   {
450     ERROR ("curl plugin: strdup failed.");
451     sfree (page);
452     return (-1);
453   }
454
455   /* Process all children */
456   status = 0;
457   for (i = 0; i < ci->children_num; i++)
458   {
459     oconfig_item_t *child = ci->children + i;
460
461     if (strcasecmp ("URL", child->key) == 0)
462       status = cf_util_get_string (child, &page->url);
463     else if (strcasecmp ("User", child->key) == 0)
464       status = cf_util_get_string (child, &page->user);
465     else if (strcasecmp ("Password", child->key) == 0)
466       status = cf_util_get_string (child, &page->pass);
467     else if (strcasecmp ("Digest", child->key) == 0)
468       status = cf_util_get_boolean (child, &page->digest);
469     else if (strcasecmp ("VerifyPeer", child->key) == 0)
470       status = cf_util_get_boolean (child, &page->verify_peer);
471     else if (strcasecmp ("VerifyHost", child->key) == 0)
472       status = cf_util_get_boolean (child, &page->verify_host);
473     else if (strcasecmp ("MeasureResponseTime", child->key) == 0)
474       status = cf_util_get_boolean (child, &page->response_time);
475     else if (strcasecmp ("MeasureResponseCode", child->key) == 0)
476       status = cf_util_get_boolean (child, &page->response_code);
477     else if (strcasecmp ("CACert", child->key) == 0)
478       status = cf_util_get_string (child, &page->cacert);
479     else if (strcasecmp ("Match", child->key) == 0)
480       /* Be liberal with failing matches => don't set `status'. */
481       cc_config_add_match (page, child);
482     else if (strcasecmp ("Header", child->key) == 0)
483       status = cc_config_append_string ("Header", &page->headers, child);
484     else if (strcasecmp ("Post", child->key) == 0)
485       status = cf_util_get_string (child, &page->post_body);
486     else if (strcasecmp ("Timeout", child->key) == 0)
487       status = cf_util_get_int (child, &page->timeout);
488     else
489     {
490       WARNING ("curl plugin: Option `%s' not allowed here.", child->key);
491       status = -1;
492     }
493
494     if (status != 0)
495       break;
496   } /* for (i = 0; i < ci->children_num; i++) */
497
498   /* Additionial sanity checks and libCURL initialization. */
499   while (status == 0)
500   {
501     if (page->url == NULL)
502     {
503       WARNING ("curl plugin: `URL' missing in `Page' block.");
504       status = -1;
505     }
506
507     if (page->matches == NULL && !page->response_time && !page->response_code)
508     {
509       assert (page->instance != NULL);
510       WARNING ("curl plugin: No (valid) `Match' block "
511           "or MeasureResponseTime or MeasureResponseCode within "
512           "`Page' block `%s'.", page->instance);
513       status = -1;
514     }
515
516     if (status == 0)
517       status = cc_page_init_curl (page);
518
519     break;
520   } /* while (status == 0) */
521
522   if (status != 0)
523   {
524     cc_web_page_free (page);
525     return (status);
526   }
527
528   /* Add the new page to the linked list */
529   if (pages_g == NULL)
530     pages_g = page;
531   else
532   {
533     web_page_t *prev;
534
535     prev = pages_g;
536     while ((prev != NULL) && (prev->next != NULL))
537       prev = prev->next;
538     prev->next = page;
539   }
540
541   return (0);
542 } /* }}} int cc_config_add_page */
543
544 static int cc_config (oconfig_item_t *ci) /* {{{ */
545 {
546   int success;
547   int errors;
548   int status;
549   int i;
550
551   success = 0;
552   errors = 0;
553
554   for (i = 0; i < ci->children_num; i++)
555   {
556     oconfig_item_t *child = ci->children + i;
557
558     if (strcasecmp ("Page", child->key) == 0)
559     {
560       status = cc_config_add_page (child);
561       if (status == 0)
562         success++;
563       else
564         errors++;
565     }
566     else
567     {
568       WARNING ("curl plugin: Option `%s' not allowed here.", child->key);
569       errors++;
570     }
571   }
572
573   if ((success == 0) && (errors > 0))
574   {
575     ERROR ("curl plugin: All statements failed.");
576     return (-1);
577   }
578
579   return (0);
580 } /* }}} int cc_config */
581
582 static int cc_init (void) /* {{{ */
583 {
584   if (pages_g == NULL)
585   {
586     INFO ("curl plugin: No pages have been defined.");
587     return (-1);
588   }
589   curl_global_init (CURL_GLOBAL_SSL);
590   return (0);
591 } /* }}} int cc_init */
592
593 static void cc_submit (const web_page_t *wp, const web_match_t *wm, /* {{{ */
594     const cu_match_value_t *mv)
595 {
596   value_t values[1];
597   value_list_t vl = VALUE_LIST_INIT;
598
599   values[0] = mv->value;
600
601   vl.values = values;
602   vl.values_len = 1;
603   sstrncpy (vl.host, hostname_g, sizeof (vl.host));
604   sstrncpy (vl.plugin, "curl", sizeof (vl.plugin));
605   sstrncpy (vl.plugin_instance, wp->instance, sizeof (vl.plugin_instance));
606   sstrncpy (vl.type, wm->type, sizeof (vl.type));
607   if (wm->instance != NULL)
608     sstrncpy (vl.type_instance, wm->instance, sizeof (vl.type_instance));
609
610   plugin_dispatch_values (&vl);
611 } /* }}} void cc_submit */
612
613 static void cc_submit_response_code (const web_page_t *wp, long code) /* {{{ */
614 {
615   value_t values[1];
616   value_list_t vl = VALUE_LIST_INIT;
617
618   values[0].gauge = code;
619
620   vl.values = values;
621   vl.values_len = 1;
622   sstrncpy (vl.host, hostname_g, sizeof (vl.host));
623   sstrncpy (vl.plugin, "curl", sizeof (vl.plugin));
624   sstrncpy (vl.plugin_instance, wp->instance, sizeof (vl.plugin_instance));
625   sstrncpy (vl.type, "response_code", sizeof (vl.type));
626
627   plugin_dispatch_values (&vl);
628 } /* }}} void cc_submit_response_code */
629
630 static void cc_submit_response_time (const web_page_t *wp, /* {{{ */
631     cdtime_t response_time)
632 {
633   value_t values[1];
634   value_list_t vl = VALUE_LIST_INIT;
635
636   values[0].gauge = CDTIME_T_TO_DOUBLE (response_time);
637
638   vl.values = values;
639   vl.values_len = 1;
640   sstrncpy (vl.host, hostname_g, sizeof (vl.host));
641   sstrncpy (vl.plugin, "curl", sizeof (vl.plugin));
642   sstrncpy (vl.plugin_instance, wp->instance, sizeof (vl.plugin_instance));
643   sstrncpy (vl.type, "response_time", sizeof (vl.type));
644
645   plugin_dispatch_values (&vl);
646 } /* }}} void cc_submit_response_time */
647
648 static int cc_read_page (web_page_t *wp) /* {{{ */
649 {
650   web_match_t *wm;
651   int status;
652   cdtime_t start = 0;
653
654   if (wp->response_time)
655     start = cdtime ();
656
657   wp->buffer_fill = 0;
658   status = curl_easy_perform (wp->curl);
659   if (status != CURLE_OK)
660   {
661     ERROR ("curl plugin: curl_easy_perform failed with staus %i: %s",
662         status, wp->curl_errbuf);
663     return (-1);
664   }
665
666   if (wp->response_time)
667     cc_submit_response_time (wp, cdtime() - start);
668
669   if(wp->response_code)
670   {
671     long response_code = 0;
672     status = curl_easy_getinfo(wp->curl, CURLINFO_RESPONSE_CODE, &response_code);
673     if(status != CURLE_OK) {
674       ERROR ("curl plugin: Fetching response code failed with staus %i: %s",
675         status, wp->curl_errbuf);
676     } else {
677       cc_submit_response_code(wp, response_code);
678     }
679   }
680
681   for (wm = wp->matches; wm != NULL; wm = wm->next)
682   {
683     cu_match_value_t *mv;
684
685     status = match_apply (wm->match, wp->buffer);
686     if (status != 0)
687     {
688       WARNING ("curl plugin: match_apply failed.");
689       continue;
690     }
691
692     mv = match_get_user_data (wm->match);
693     if (mv == NULL)
694     {
695       WARNING ("curl plugin: match_get_user_data returned NULL.");
696       continue;
697     }
698
699     cc_submit (wp, wm, mv);
700     match_value_reset (mv);
701   } /* for (wm = wp->matches; wm != NULL; wm = wm->next) */
702
703   return (0);
704 } /* }}} int cc_read_page */
705
706 static int cc_read (void) /* {{{ */
707 {
708   web_page_t *wp;
709
710   for (wp = pages_g; wp != NULL; wp = wp->next)
711     cc_read_page (wp);
712
713   return (0);
714 } /* }}} int cc_read */
715
716 static int cc_shutdown (void) /* {{{ */
717 {
718   cc_web_page_free (pages_g);
719   pages_g = NULL;
720
721   return (0);
722 } /* }}} int cc_shutdown */
723
724 void module_register (void)
725 {
726   plugin_register_complex_config ("curl", cc_config);
727   plugin_register_init ("curl", cc_init);
728   plugin_register_read ("curl", cc_read);
729   plugin_register_shutdown ("curl", cc_shutdown);
730 } /* void module_register */
731
732 /* vim: set sw=2 sts=2 et fdm=marker : */