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 **/
24 #include "collectd.h"
26 #include "common.h"
27 #include "plugin.h"
28 #include "utils_curl_stats.h"
29 #include "utils_match.h"
30 #include "utils_time.h"
32 #include <curl/curl.h>
34 /*
35 * Data types
36 */
37 struct web_match_s;
38 typedef struct web_match_s web_match_t;
39 struct web_match_s /* {{{ */
40 {
41 char *regex;
42 char *exclude_regex;
43 int dstype;
44 char *type;
45 char *instance;
47 cu_match_t *match;
49 web_match_t *next;
50 }; /* }}} */
52 struct web_page_s;
53 typedef struct web_page_s web_page_t;
54 struct web_page_s /* {{{ */
55 {
56 char *instance;
58 char *url;
59 char *user;
60 char *pass;
61 char *credentials;
62 _Bool digest;
63 _Bool verify_peer;
64 _Bool verify_host;
65 char *cacert;
66 struct curl_slist *headers;
67 char *post_body;
68 _Bool response_time;
69 _Bool response_code;
70 int timeout;
71 curl_stats_t *stats;
73 CURL *curl;
74 char curl_errbuf[CURL_ERROR_SIZE];
75 char *buffer;
76 size_t buffer_size;
77 size_t buffer_fill;
79 web_match_t *matches;
81 web_page_t *next;
82 }; /* }}} */
84 /*
85 * Global variables;
86 */
87 /* static CURLM *curl = NULL; */
88 static web_page_t *pages_g = NULL;
90 /*
91 * Private functions
92 */
93 static size_t cc_curl_callback (void *buf, /* {{{ */
94 size_t size, size_t nmemb, void *user_data)
95 {
96 web_page_t *wp;
97 size_t len;
99 len = size * nmemb;
100 if (len == 0)
101 return (len);
103 wp = user_data;
104 if (wp == NULL)
105 return (0);
107 if ((wp->buffer_fill + len) >= wp->buffer_size)
108 {
109 char *temp;
110 size_t temp_size;
112 temp_size = wp->buffer_fill + len + 1;
113 temp = realloc (wp->buffer, temp_size);
114 if (temp == NULL)
115 {
116 ERROR ("curl plugin: realloc failed.");
117 return (0);
118 }
119 wp->buffer = temp;
120 wp->buffer_size = temp_size;
121 }
123 memcpy (wp->buffer + wp->buffer_fill, (char *) buf, len);
124 wp->buffer_fill += len;
125 wp->buffer[wp->buffer_fill] = 0;
127 return (len);
128 } /* }}} size_t cc_curl_callback */
130 static void cc_web_match_free (web_match_t *wm) /* {{{ */
131 {
132 if (wm == NULL)
133 return;
135 sfree (wm->regex);
136 sfree (wm->type);
137 sfree (wm->instance);
138 match_destroy (wm->match);
139 cc_web_match_free (wm->next);
140 sfree (wm);
141 } /* }}} void cc_web_match_free */
143 static void cc_web_page_free (web_page_t *wp) /* {{{ */
144 {
145 if (wp == NULL)
146 return;
148 if (wp->curl != NULL)
149 curl_easy_cleanup (wp->curl);
150 wp->curl = NULL;
152 sfree (wp->instance);
154 sfree (wp->url);
155 sfree (wp->user);
156 sfree (wp->pass);
157 sfree (wp->credentials);
158 sfree (wp->cacert);
159 sfree (wp->post_body);
160 curl_slist_free_all (wp->headers);
161 curl_stats_destroy (wp->stats);
163 sfree (wp->buffer);
165 cc_web_match_free (wp->matches);
166 cc_web_page_free (wp->next);
167 sfree (wp);
168 } /* }}} void cc_web_page_free */
170 static int cc_config_append_string (const char *name, struct curl_slist **dest, /* {{{ */
171 oconfig_item_t *ci)
172 {
173 struct curl_slist *temp = NULL;
174 if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING))
175 {
176 WARNING ("curl plugin: `%s' needs exactly one string argument.", name);
177 return (-1);
178 }
180 temp = curl_slist_append(*dest, ci->values[0].value.string);
181 if (temp == NULL)
182 return (-1);
184 *dest = temp;
186 return (0);
187 } /* }}} int cc_config_append_string */
189 static int cc_config_add_match_dstype (int *dstype_ret, /* {{{ */
190 oconfig_item_t *ci)
191 {
192 int dstype;
194 if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING))
195 {
196 WARNING ("curl plugin: `DSType' needs exactly one string argument.");
197 return (-1);
198 }
200 if (strncasecmp ("Gauge", ci->values[0].value.string,
201 strlen ("Gauge")) == 0)
202 {
203 dstype = UTILS_MATCH_DS_TYPE_GAUGE;
204 if (strcasecmp ("GaugeAverage", ci->values[0].value.string) == 0)
205 dstype |= UTILS_MATCH_CF_GAUGE_AVERAGE;
206 else if (strcasecmp ("GaugeMin", ci->values[0].value.string) == 0)
207 dstype |= UTILS_MATCH_CF_GAUGE_MIN;
208 else if (strcasecmp ("GaugeMax", ci->values[0].value.string) == 0)
209 dstype |= UTILS_MATCH_CF_GAUGE_MAX;
210 else if (strcasecmp ("GaugeLast", ci->values[0].value.string) == 0)
211 dstype |= UTILS_MATCH_CF_GAUGE_LAST;
212 else
213 dstype = 0;
214 }
215 else if (strncasecmp ("Counter", ci->values[0].value.string,
216 strlen ("Counter")) == 0)
217 {
218 dstype = UTILS_MATCH_DS_TYPE_COUNTER;
219 if (strcasecmp ("CounterSet", ci->values[0].value.string) == 0)
220 dstype |= UTILS_MATCH_CF_COUNTER_SET;
221 else if (strcasecmp ("CounterAdd", ci->values[0].value.string) == 0)
222 dstype |= UTILS_MATCH_CF_COUNTER_ADD;
223 else if (strcasecmp ("CounterInc", ci->values[0].value.string) == 0)
224 dstype |= UTILS_MATCH_CF_COUNTER_INC;
225 else
226 dstype = 0;
227 }
228 else if (strncasecmp ("Derive", ci->values[0].value.string,
229 strlen ("Derive")) == 0)
230 {
231 dstype = UTILS_MATCH_DS_TYPE_DERIVE;
232 if (strcasecmp ("DeriveSet", ci->values[0].value.string) == 0)
233 dstype |= UTILS_MATCH_CF_DERIVE_SET;
234 else if (strcasecmp ("DeriveAdd", ci->values[0].value.string) == 0)
235 dstype |= UTILS_MATCH_CF_DERIVE_ADD;
236 else if (strcasecmp ("DeriveInc", ci->values[0].value.string) == 0)
237 dstype |= UTILS_MATCH_CF_DERIVE_INC;
238 else
239 dstype = 0;
240 }
241 else if (strncasecmp ("Absolute", ci->values[0].value.string,
242 strlen ("Absolute")) == 0)
243 {
244 dstype = UTILS_MATCH_DS_TYPE_ABSOLUTE;
245 if (strcasecmp ("AbsoluteSet", ci->values[0].value.string) == 0) /* Absolute DS is reset-on-read so no sense doin anything else but set */
246 dstype |= UTILS_MATCH_CF_ABSOLUTE_SET;
247 else
248 dstype = 0;
249 }
251 else
252 {
253 dstype = 0;
254 }
256 if (dstype == 0)
257 {
258 WARNING ("curl plugin: `%s' is not a valid argument to `DSType'.",
259 ci->values[0].value.string);
260 return (-1);
261 }
263 *dstype_ret = dstype;
264 return (0);
265 } /* }}} int cc_config_add_match_dstype */
267 static int cc_config_add_match (web_page_t *page, /* {{{ */
268 oconfig_item_t *ci)
269 {
270 web_match_t *match;
271 int status;
273 if (ci->values_num != 0)
274 {
275 WARNING ("curl plugin: Ignoring arguments for the `Match' block.");
276 }
278 match = calloc (1, sizeof (*match));
279 if (match == NULL)
280 {
281 ERROR ("curl plugin: calloc failed.");
282 return (-1);
283 }
285 status = 0;
286 for (int i = 0; i < ci->children_num; i++)
287 {
288 oconfig_item_t *child = ci->children + i;
290 if (strcasecmp ("Regex", child->key) == 0)
291 status = cf_util_get_string (child, &match->regex);
292 else if (strcasecmp ("ExcludeRegex", child->key) == 0)
293 status = cf_util_get_string (child, &match->exclude_regex);
294 else if (strcasecmp ("DSType", child->key) == 0)
295 status = cc_config_add_match_dstype (&match->dstype, child);
296 else if (strcasecmp ("Type", child->key) == 0)
297 status = cf_util_get_string (child, &match->type);
298 else if (strcasecmp ("Instance", child->key) == 0)
299 status = cf_util_get_string (child, &match->instance);
300 else
301 {
302 WARNING ("curl plugin: Option `%s' not allowed here.", child->key);
303 status = -1;
304 }
306 if (status != 0)
307 break;
308 } /* for (i = 0; i < ci->children_num; i++) */
310 while (status == 0)
311 {
312 if (match->regex == NULL)
313 {
314 WARNING ("curl plugin: `Regex' missing in `Match' block.");
315 status = -1;
316 }
318 if (match->type == NULL)
319 {
320 WARNING ("curl plugin: `Type' missing in `Match' block.");
321 status = -1;
322 }
324 if (match->dstype == 0)
325 {
326 WARNING ("curl plugin: `DSType' missing in `Match' block.");
327 status = -1;
328 }
330 break;
331 } /* while (status == 0) */
333 if (status != 0)
334 {
335 cc_web_match_free (match);
336 return (status);
337 }
339 match->match = match_create_simple (match->regex, match->exclude_regex,
340 match->dstype);
341 if (match->match == NULL)
342 {
343 ERROR ("curl plugin: match_create_simple failed.");
344 cc_web_match_free (match);
345 return (-1);
346 }
347 else
348 {
349 web_match_t *prev;
351 prev = page->matches;
352 while ((prev != NULL) && (prev->next != NULL))
353 prev = prev->next;
355 if (prev == NULL)
356 page->matches = match;
357 else
358 prev->next = match;
359 }
361 return (0);
362 } /* }}} int cc_config_add_match */
364 static int cc_page_init_curl (web_page_t *wp) /* {{{ */
365 {
366 wp->curl = curl_easy_init ();
367 if (wp->curl == NULL)
368 {
369 ERROR ("curl plugin: curl_easy_init failed.");
370 return (-1);
371 }
373 curl_easy_setopt (wp->curl, CURLOPT_NOSIGNAL, 1L);
374 curl_easy_setopt (wp->curl, CURLOPT_WRITEFUNCTION, cc_curl_callback);
375 curl_easy_setopt (wp->curl, CURLOPT_WRITEDATA, wp);
376 curl_easy_setopt (wp->curl, CURLOPT_USERAGENT, COLLECTD_USERAGENT);
377 curl_easy_setopt (wp->curl, CURLOPT_ERRORBUFFER, wp->curl_errbuf);
378 curl_easy_setopt (wp->curl, CURLOPT_URL, wp->url);
379 curl_easy_setopt (wp->curl, CURLOPT_FOLLOWLOCATION, 1L);
380 curl_easy_setopt (wp->curl, CURLOPT_MAXREDIRS, 50L);
382 if (wp->user != NULL)
383 {
384 #ifdef HAVE_CURLOPT_USERNAME
385 curl_easy_setopt (wp->curl, CURLOPT_USERNAME, wp->user);
386 curl_easy_setopt (wp->curl, CURLOPT_PASSWORD,
387 (wp->pass == NULL) ? "" : wp->pass);
388 #else
389 size_t credentials_size;
391 credentials_size = strlen (wp->user) + 2;
392 if (wp->pass != NULL)
393 credentials_size += strlen (wp->pass);
395 wp->credentials = malloc (credentials_size);
396 if (wp->credentials == NULL)
397 {
398 ERROR ("curl plugin: malloc failed.");
399 return (-1);
400 }
402 ssnprintf (wp->credentials, credentials_size, "%s:%s",
403 wp->user, (wp->pass == NULL) ? "" : wp->pass);
404 curl_easy_setopt (wp->curl, CURLOPT_USERPWD, wp->credentials);
405 #endif
407 if (wp->digest)
408 curl_easy_setopt (wp->curl, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST);
409 }
411 curl_easy_setopt (wp->curl, CURLOPT_SSL_VERIFYPEER, (long) wp->verify_peer);
412 curl_easy_setopt (wp->curl, CURLOPT_SSL_VERIFYHOST,
413 wp->verify_host ? 2L : 0L);
414 if (wp->cacert != NULL)
415 curl_easy_setopt (wp->curl, CURLOPT_CAINFO, wp->cacert);
416 if (wp->headers != NULL)
417 curl_easy_setopt (wp->curl, CURLOPT_HTTPHEADER, wp->headers);
418 if (wp->post_body != NULL)
419 curl_easy_setopt (wp->curl, CURLOPT_POSTFIELDS, wp->post_body);
421 #ifdef HAVE_CURLOPT_TIMEOUT_MS
422 if (wp->timeout >= 0)
423 curl_easy_setopt (wp->curl, CURLOPT_TIMEOUT_MS, (long) wp->timeout);
424 else
425 curl_easy_setopt (wp->curl, CURLOPT_TIMEOUT_MS, (long) CDTIME_T_TO_MS(plugin_get_interval()));
426 #endif
428 return (0);
429 } /* }}} int cc_page_init_curl */
431 static int cc_config_add_page (oconfig_item_t *ci) /* {{{ */
432 {
433 web_page_t *page;
434 int status;
436 if ((ci->values_num != 1) || (ci->values[0].type != OCONFIG_TYPE_STRING))
437 {
438 WARNING ("curl plugin: `Page' blocks need exactly one string argument.");
439 return (-1);
440 }
442 page = calloc (1, sizeof (*page));
443 if (page == NULL)
444 {
445 ERROR ("curl plugin: calloc failed.");
446 return (-1);
447 }
448 page->url = NULL;
449 page->user = NULL;
450 page->pass = NULL;
451 page->digest = 0;
452 page->verify_peer = 1;
453 page->verify_host = 1;
454 page->response_time = 0;
455 page->response_code = 0;
456 page->timeout = -1;
457 page->stats = NULL;
459 page->instance = strdup (ci->values[0].value.string);
460 if (page->instance == NULL)
461 {
462 ERROR ("curl plugin: strdup failed.");
463 sfree (page);
464 return (-1);
465 }
467 /* Process all children */
468 status = 0;
469 for (int i = 0; i < ci->children_num; i++)
470 {
471 oconfig_item_t *child = ci->children + i;
473 if (strcasecmp ("URL", child->key) == 0)
474 status = cf_util_get_string (child, &page->url);
475 else if (strcasecmp ("User", child->key) == 0)
476 status = cf_util_get_string (child, &page->user);
477 else if (strcasecmp ("Password", child->key) == 0)
478 status = cf_util_get_string (child, &page->pass);
479 else if (strcasecmp ("Digest", child->key) == 0)
480 status = cf_util_get_boolean (child, &page->digest);
481 else if (strcasecmp ("VerifyPeer", child->key) == 0)
482 status = cf_util_get_boolean (child, &page->verify_peer);
483 else if (strcasecmp ("VerifyHost", child->key) == 0)
484 status = cf_util_get_boolean (child, &page->verify_host);
485 else if (strcasecmp ("MeasureResponseTime", child->key) == 0)
486 status = cf_util_get_boolean (child, &page->response_time);
487 else if (strcasecmp ("MeasureResponseCode", child->key) == 0)
488 status = cf_util_get_boolean (child, &page->response_code);
489 else if (strcasecmp ("CACert", child->key) == 0)
490 status = cf_util_get_string (child, &page->cacert);
491 else if (strcasecmp ("Match", child->key) == 0)
492 /* Be liberal with failing matches => don't set `status'. */
493 cc_config_add_match (page, child);
494 else if (strcasecmp ("Header", child->key) == 0)
495 status = cc_config_append_string ("Header", &page->headers, child);
496 else if (strcasecmp ("Post", child->key) == 0)
497 status = cf_util_get_string (child, &page->post_body);
498 else if (strcasecmp ("Timeout", child->key) == 0)
499 status = cf_util_get_int (child, &page->timeout);
500 else if (strcasecmp ("Statistics", child->key) == 0) {
501 page->stats = curl_stats_from_config (child);
502 if (page->stats == NULL)
503 status = -1;
504 }
505 else
506 {
507 WARNING ("curl plugin: Option `%s' not allowed here.", child->key);
508 status = -1;
509 }
511 if (status != 0)
512 break;
513 } /* for (i = 0; i < ci->children_num; i++) */
515 /* Additionial sanity checks and libCURL initialization. */
516 while (status == 0)
517 {
518 if (page->url == NULL)
519 {
520 WARNING ("curl plugin: `URL' missing in `Page' block.");
521 status = -1;
522 }
524 if (page->matches == NULL && page->stats == NULL
525 && !page->response_time && !page->response_code)
526 {
527 assert (page->instance != NULL);
528 WARNING ("curl plugin: No (valid) `Match' block "
529 "or Statistics or MeasureResponseTime or MeasureResponseCode "
530 "within `Page' block `%s'.", page->instance);
531 status = -1;
532 }
534 if (status == 0)
535 status = cc_page_init_curl (page);
537 break;
538 } /* while (status == 0) */
540 if (status != 0)
541 {
542 cc_web_page_free (page);
543 return (status);
544 }
546 /* Add the new page to the linked list */
547 if (pages_g == NULL)
548 pages_g = page;
549 else
550 {
551 web_page_t *prev;
553 prev = pages_g;
554 while (prev->next != NULL)
555 prev = prev->next;
556 prev->next = page;
557 }
559 return (0);
560 } /* }}} int cc_config_add_page */
562 static int cc_config (oconfig_item_t *ci) /* {{{ */
563 {
564 int success;
565 int errors;
566 int status;
568 success = 0;
569 errors = 0;
571 for (int i = 0; i < ci->children_num; i++)
572 {
573 oconfig_item_t *child = ci->children + i;
575 if (strcasecmp ("Page", child->key) == 0)
576 {
577 status = cc_config_add_page (child);
578 if (status == 0)
579 success++;
580 else
581 errors++;
582 }
583 else
584 {
585 WARNING ("curl plugin: Option `%s' not allowed here.", child->key);
586 errors++;
587 }
588 }
590 if ((success == 0) && (errors > 0))
591 {
592 ERROR ("curl plugin: All statements failed.");
593 return (-1);
594 }
596 return (0);
597 } /* }}} int cc_config */
599 static int cc_init (void) /* {{{ */
600 {
601 if (pages_g == NULL)
602 {
603 INFO ("curl plugin: No pages have been defined.");
604 return (-1);
605 }
606 curl_global_init (CURL_GLOBAL_SSL);
607 return (0);
608 } /* }}} int cc_init */
610 static void cc_submit (const web_page_t *wp, const web_match_t *wm, /* {{{ */
611 const cu_match_value_t *mv)
612 {
613 value_t values[1];
614 value_list_t vl = VALUE_LIST_INIT;
616 values[0] = mv->value;
618 vl.values = values;
619 vl.values_len = 1;
620 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
621 sstrncpy (vl.plugin, "curl", sizeof (vl.plugin));
622 sstrncpy (vl.plugin_instance, wp->instance, sizeof (vl.plugin_instance));
623 sstrncpy (vl.type, wm->type, sizeof (vl.type));
624 if (wm->instance != NULL)
625 sstrncpy (vl.type_instance, wm->instance, sizeof (vl.type_instance));
627 plugin_dispatch_values (&vl);
628 } /* }}} void cc_submit */
630 static void cc_submit_response_code (const web_page_t *wp, long code) /* {{{ */
631 {
632 value_t values[1];
633 value_list_t vl = VALUE_LIST_INIT;
635 values[0].gauge = code;
637 vl.values = values;
638 vl.values_len = 1;
639 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
640 sstrncpy (vl.plugin, "curl", sizeof (vl.plugin));
641 sstrncpy (vl.plugin_instance, wp->instance, sizeof (vl.plugin_instance));
642 sstrncpy (vl.type, "response_code", sizeof (vl.type));
644 plugin_dispatch_values (&vl);
645 } /* }}} void cc_submit_response_code */
647 static void cc_submit_response_time (const web_page_t *wp, /* {{{ */
648 cdtime_t response_time)
649 {
650 value_t values[1];
651 value_list_t vl = VALUE_LIST_INIT;
653 values[0].gauge = CDTIME_T_TO_DOUBLE (response_time);
655 vl.values = values;
656 vl.values_len = 1;
657 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
658 sstrncpy (vl.plugin, "curl", sizeof (vl.plugin));
659 sstrncpy (vl.plugin_instance, wp->instance, sizeof (vl.plugin_instance));
660 sstrncpy (vl.type, "response_time", sizeof (vl.type));
662 plugin_dispatch_values (&vl);
663 } /* }}} void cc_submit_response_time */
665 static int cc_read_page (web_page_t *wp) /* {{{ */
666 {
667 int status;
668 cdtime_t start = 0;
670 if (wp->response_time)
671 start = cdtime ();
673 wp->buffer_fill = 0;
674 status = curl_easy_perform (wp->curl);
675 if (status != CURLE_OK)
676 {
677 ERROR ("curl plugin: curl_easy_perform failed with status %i: %s",
678 status, wp->curl_errbuf);
679 return (-1);
680 }
682 if (wp->response_time)
683 cc_submit_response_time (wp, cdtime() - start);
684 if (wp->stats != NULL)
685 curl_stats_dispatch (wp->stats, wp->curl, hostname_g, "curl", wp->instance);
687 if(wp->response_code)
688 {
689 long response_code = 0;
690 status = curl_easy_getinfo(wp->curl, CURLINFO_RESPONSE_CODE, &response_code);
691 if(status != CURLE_OK) {
692 ERROR ("curl plugin: Fetching response code failed with status %i: %s",
693 status, wp->curl_errbuf);
694 } else {
695 cc_submit_response_code(wp, response_code);
696 }
697 }
699 for (web_match_t *wm = wp->matches; wm != NULL; wm = wm->next)
700 {
701 cu_match_value_t *mv;
703 status = match_apply (wm->match, wp->buffer);
704 if (status != 0)
705 {
706 WARNING ("curl plugin: match_apply failed.");
707 continue;
708 }
710 mv = match_get_user_data (wm->match);
711 if (mv == NULL)
712 {
713 WARNING ("curl plugin: match_get_user_data returned NULL.");
714 continue;
715 }
717 cc_submit (wp, wm, mv);
718 match_value_reset (mv);
719 } /* for (wm = wp->matches; wm != NULL; wm = wm->next) */
721 return (0);
722 } /* }}} int cc_read_page */
724 static int cc_read (void) /* {{{ */
725 {
726 for (web_page_t *wp = pages_g; wp != NULL; wp = wp->next)
727 cc_read_page (wp);
729 return (0);
730 } /* }}} int cc_read */
732 static int cc_shutdown (void) /* {{{ */
733 {
734 cc_web_page_free (pages_g);
735 pages_g = NULL;
737 return (0);
738 } /* }}} int cc_shutdown */
740 void module_register (void)
741 {
742 plugin_register_complex_config ("curl", cc_config);
743 plugin_register_init ("curl", cc_init);
744 plugin_register_read ("curl", cc_read);
745 plugin_register_shutdown ("curl", cc_shutdown);
746 } /* void module_register */
748 /* vim: set sw=2 sts=2 et fdm=marker : */