src/ipmi.c

   1 /**
   2  * collectd - src/ipmi.c
   3  * Copyright (C) 2008-2009  Florian octo Forster
   4  * Copyright (C) 2008       Peter Holik
   5  * Copyright (C) 2009       Bruno Prémont
   6  *
   7  * This program is free software; you can redistribute it and/or modify it
   8  * under the terms of the GNU General Public License as published by the
   9  * Free Software Foundation; only version 2 of the License is applicable.
  10  *
  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  * General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License along
  17  * with this program; if not, write to the Free Software Foundation, Inc.,
  18  * 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
  19  *
  20  * Authors:
  21  *   Florian octo Forster <octo at collectd.org>
  22  *   Peter Holik <peter at holik.at>
  23  *   Bruno Prémont <bonbons at linux-vserver.org>
  24  **/
  25
  26 #include "collectd.h"
  27
  28 #include "common.h"
  29 #include "plugin.h"
  30 #include "utils_ignorelist.h"
  31
  32 #include <OpenIPMI/ipmi_conn.h>
  33 #include <OpenIPMI/ipmi_err.h>
  34 #include <OpenIPMI/ipmi_posix.h>
  35 #include <OpenIPMI/ipmi_smi.h>
  36 #include <OpenIPMI/ipmiif.h>
  37
  38 /*
  39  * Private data types
  40  */
  41 struct c_ipmi_sensor_list_s;
  42 typedef struct c_ipmi_sensor_list_s c_ipmi_sensor_list_t;
  43
  44 struct c_ipmi_sensor_list_s {
  45   ipmi_sensor_id_t sensor_id;
  46   char sensor_name[DATA_MAX_NAME_LEN];
  47   char sensor_type[DATA_MAX_NAME_LEN];
  48   int sensor_not_present;
  49   c_ipmi_sensor_list_t *next;
  50 };
  51
  52 /*
  53  * Module global variables
  54  */
  55 static pthread_mutex_t sensor_list_lock = PTHREAD_MUTEX_INITIALIZER;
  56 static c_ipmi_sensor_list_t *sensor_list = NULL;
  57
  58 static int c_ipmi_init_in_progress = 0;
  59 static int c_ipmi_active = 0;
  60 static pthread_t thread_id = (pthread_t)0;
  61
  62 static const char *config_keys[] = {"Sensor", "IgnoreSelected",
  63                                     "NotifySensorAdd", "NotifySensorRemove",
  64                                     "NotifySensorNotPresent"};
  65 static int config_keys_num = STATIC_ARRAY_SIZE(config_keys);
  66
  67 static ignorelist_t *ignorelist = NULL;
  68
  69 static int c_ipmi_nofiy_add = 0;
  70 static int c_ipmi_nofiy_remove = 0;
  71 static int c_ipmi_nofiy_notpresent = 0;
  72
  73 /*
  74  * Misc private functions
  75  */
  76 static void c_ipmi_error(const char *func, int status) {
  77   char errbuf[4096] = {0};
  78
  79   if (IPMI_IS_OS_ERR(status)) {
  80     sstrerror(IPMI_GET_OS_ERR(status), errbuf, sizeof(errbuf));
  81   } else if (IPMI_IS_IPMI_ERR(status)) {
  82     ipmi_get_error_string(IPMI_GET_IPMI_ERR(status), errbuf, sizeof(errbuf));
  83   }
  84
  85   if (errbuf[0] == 0) {
  86     snprintf(errbuf, sizeof(errbuf), "Unknown error %#x", status);
  87   }
  88   errbuf[sizeof(errbuf) - 1] = 0;
  89
  90   ERROR("ipmi plugin: %s failed: %s", func, errbuf);
  91 } /* void c_ipmi_error */
  92
  93 /*
  94  * Sensor handlers
  95  */
  96 /* Prototype for sensor_list_remove, so sensor_read_handler can call it. */
  97 static int sensor_list_remove(ipmi_sensor_t *sensor);
  98
  99 static void sensor_read_handler(ipmi_sensor_t *sensor, int err,
 100                                 enum ipmi_value_present_e value_present,
 101                                 unsigned int __attribute__((unused)) raw_value,
 102                                 double value,
 103                                 ipmi_states_t __attribute__((unused)) * states,
 104                                 void *user_data) {
 105   value_list_t vl = VALUE_LIST_INIT;
 106
 107   c_ipmi_sensor_list_t *list_item = (c_ipmi_sensor_list_t *)user_data;
 108
 109   if (err != 0) {
 110     if ((err & 0xff) == IPMI_NOT_PRESENT_CC) {
 111       if (list_item->sensor_not_present == 0) {
 112         list_item->sensor_not_present = 1;
 113
 114         INFO("ipmi plugin: sensor_read_handler: sensor %s "
 115              "not present.",
 116              list_item->sensor_name);
 117
 118         if (c_ipmi_nofiy_notpresent) {
 119           notification_t n = {
 120               NOTIF_WARNING, cdtime(), "", "", "ipmi", "", "", "", NULL};
 121
 122           sstrncpy(n.host, hostname_g, sizeof(n.host));
 123           sstrncpy(n.type_instance, list_item->sensor_name,
 124                    sizeof(n.type_instance));
 125           sstrncpy(n.type, list_item->sensor_type, sizeof(n.type));
 126           snprintf(n.message, sizeof(n.message), "sensor %s not present",
 127                    list_item->sensor_name);
 128
 129           plugin_dispatch_notification(&n);
 130         }
 131       }
 132     } else if (IPMI_IS_IPMI_ERR(err) &&
 133                IPMI_GET_IPMI_ERR(err) ==
 134                    IPMI_NOT_SUPPORTED_IN_PRESENT_STATE_CC) {
 135       INFO("ipmi plugin: sensor_read_handler: Sensor %s not ready",
 136            list_item->sensor_name);
 137     } else {
 138       if (IPMI_IS_IPMI_ERR(err))
 139         INFO("ipmi plugin: sensor_read_handler: Removing sensor %s, "
 140              "because it failed with IPMI error %#x.",
 141              list_item->sensor_name, IPMI_GET_IPMI_ERR(err));
 142       else if (IPMI_IS_OS_ERR(err))
 143         INFO("ipmi plugin: sensor_read_handler: Removing sensor %s, "
 144              "because it failed with OS error %#x.",
 145              list_item->sensor_name, IPMI_GET_OS_ERR(err));
 146       else if (IPMI_IS_RMCPP_ERR(err))
 147         INFO("ipmi plugin: sensor_read_handler: Removing sensor %s, "
 148              "because it failed with RMCPP error %#x.",
 149              list_item->sensor_name, IPMI_GET_RMCPP_ERR(err));
 150       else if (IPMI_IS_SOL_ERR(err))
 151         INFO("ipmi plugin: sensor_read_handler: Removing sensor %s, "
 152              "because it failed with RMCPP error %#x.",
 153              list_item->sensor_name, IPMI_GET_SOL_ERR(err));
 154       else
 155         INFO("ipmi plugin: sensor_read_handler: Removing sensor %s, "
 156              "because it failed with error %#x. of class %#x",
 157              list_item->sensor_name, err & 0xff, err & 0xffffff00);
 158       sensor_list_remove(sensor);
 159     }
 160     return;
 161   } else if (list_item->sensor_not_present == 1) {
 162     list_item->sensor_not_present = 0;
 163
 164     INFO("ipmi plugin: sensor_read_handler: sensor %s present.",
 165          list_item->sensor_name);
 166
 167     if (c_ipmi_nofiy_notpresent) {
 168       notification_t n = {NOTIF_OKAY, cdtime(), "", "",  "ipmi",
 169                           "",         "",       "", NULL};
 170
 171       sstrncpy(n.host, hostname_g, sizeof(n.host));
 172       sstrncpy(n.type_instance, list_item->sensor_name,
 173                sizeof(n.type_instance));
 174       sstrncpy(n.type, list_item->sensor_type, sizeof(n.type));
 175       snprintf(n.message, sizeof(n.message), "sensor %s present",
 176                list_item->sensor_name);
 177
 178       plugin_dispatch_notification(&n);
 179     }
 180   }
 181
 182   if (value_present != IPMI_BOTH_VALUES_PRESENT) {
 183     INFO("ipmi plugin: sensor_read_handler: Removing sensor %s, "
 184          "because it provides %s. If you need this sensor, "
 185          "please file a bug report.",
 186          list_item->sensor_name,
 187          (value_present == IPMI_RAW_VALUE_PRESENT) ? "only the raw value"
 188                                                    : "no value");
 189     sensor_list_remove(sensor);
 190     return;
 191   }
 192
 193   vl.values = &(value_t){.gauge = value};
 194   vl.values_len = 1;
 195
 196   sstrncpy(vl.plugin, "ipmi", sizeof(vl.plugin));
 197   sstrncpy(vl.type, list_item->sensor_type, sizeof(vl.type));
 198   sstrncpy(vl.type_instance, list_item->sensor_name, sizeof(vl.type_instance));
 199
 200   plugin_dispatch_values(&vl);
 201 } /* void sensor_read_handler */
 202
 203 static int sensor_list_add(ipmi_sensor_t *sensor) {
 204   ipmi_sensor_id_t sensor_id;
 205   c_ipmi_sensor_list_t *list_item;
 206   c_ipmi_sensor_list_t *list_prev;
 207
 208   char buffer[DATA_MAX_NAME_LEN] = {0};
 209   const char *entity_id_string;
 210   char sensor_name[DATA_MAX_NAME_LEN];
 211   char *sensor_name_ptr;
 212   int sensor_type;
 213   const char *type;
 214   ipmi_entity_t *ent = ipmi_sensor_get_entity(sensor);
 215
 216   sensor_id = ipmi_sensor_convert_to_id(sensor);
 217
 218   ipmi_sensor_get_name(sensor, buffer, sizeof(buffer));
 219   buffer[sizeof(buffer) - 1] = 0;
 220
 221   entity_id_string = ipmi_entity_get_entity_id_string(ent);
 222
 223   if (entity_id_string == NULL)
 224     sstrncpy(sensor_name, buffer, sizeof(sensor_name));
 225   else
 226     snprintf(sensor_name, sizeof(sensor_name), "%s %s", buffer,
 227              entity_id_string);
 228
 229   sstrncpy(buffer, sensor_name, sizeof(buffer));
 230   sensor_name_ptr = strstr(buffer, ").");
 231   if (sensor_name_ptr != NULL) {
 232     /* If name is something like "foo (123).bar",
 233      * change that to "bar (123)".
 234      * Both, sensor_name_ptr and sensor_id_ptr point to memory within the
 235      * `buffer' array, which holds a copy of the current `sensor_name'. */
 236     char *sensor_id_ptr;
 237
 238     /* `sensor_name_ptr' points to ").bar". */
 239     sensor_name_ptr[1] = 0;
 240     /* `buffer' holds "foo (123)\0bar\0". */
 241     sensor_name_ptr += 2;
 242     /* `sensor_name_ptr' now points to "bar". */
 243
 244     sensor_id_ptr = strstr(buffer, "(");
 245     if (sensor_id_ptr != NULL) {
 246       /* `sensor_id_ptr' now points to "(123)". */
 247       snprintf(sensor_name, sizeof(sensor_name), "%s %s", sensor_name_ptr,
 248                sensor_id_ptr);
 249     }
 250     /* else: don't touch sensor_name. */
 251   }
 252   sensor_name_ptr = sensor_name;
 253
 254   /* Both `ignorelist' and `plugin_instance' may be NULL. */
 255   if (ignorelist_match(ignorelist, sensor_name_ptr) != 0)
 256     return 0;
 257
 258   /* FIXME: Use rate unit or base unit to scale the value */
 259
 260   sensor_type = ipmi_sensor_get_sensor_type(sensor);
 261   switch (sensor_type) {
 262   case IPMI_SENSOR_TYPE_TEMPERATURE:
 263     type = "temperature";
 264     break;
 265
 266   case IPMI_SENSOR_TYPE_VOLTAGE:
 267     type = "voltage";
 268     break;
 269
 270   case IPMI_SENSOR_TYPE_CURRENT:
 271     type = "current";
 272     break;
 273
 274   case IPMI_SENSOR_TYPE_FAN:
 275     type = "fanspeed";
 276     break;
 277
 278   default: {
 279     const char *sensor_type_str;
 280
 281     sensor_type_str = ipmi_sensor_get_sensor_type_string(sensor);
 282     INFO("ipmi plugin: sensor_list_add: Ignore sensor %s, "
 283          "because I don't know how to handle its type (%#x, %s). "
 284          "If you need this sensor, please file a bug report.",
 285          sensor_name_ptr, sensor_type, sensor_type_str);
 286     return -1;
 287   }
 288   } /* switch (sensor_type) */
 289
 290   pthread_mutex_lock(&sensor_list_lock);
 291
 292   list_prev = NULL;
 293   for (list_item = sensor_list; list_item != NULL;
 294        list_item = list_item->next) {
 295     if (ipmi_cmp_sensor_id(sensor_id, list_item->sensor_id) == 0)
 296       break;
 297     list_prev = list_item;
 298   } /* for (list_item) */
 299
 300   if (list_item != NULL) {
 301     pthread_mutex_unlock(&sensor_list_lock);
 302     return 0;
 303   }
 304
 305   list_item = (c_ipmi_sensor_list_t *)calloc(1, sizeof(c_ipmi_sensor_list_t));
 306   if (list_item == NULL) {
 307     pthread_mutex_unlock(&sensor_list_lock);
 308     return -1;
 309   }
 310
 311   list_item->sensor_id = ipmi_sensor_convert_to_id(sensor);
 312
 313   if (list_prev != NULL)
 314     list_prev->next = list_item;
 315   else
 316     sensor_list = list_item;
 317
 318   sstrncpy(list_item->sensor_name, sensor_name_ptr,
 319            sizeof(list_item->sensor_name));
 320   sstrncpy(list_item->sensor_type, type, sizeof(list_item->sensor_type));
 321
 322   pthread_mutex_unlock(&sensor_list_lock);
 323
 324   if (c_ipmi_nofiy_add && (c_ipmi_init_in_progress == 0)) {
 325     notification_t n = {NOTIF_OKAY, cdtime(), "", "", "ipmi", "", "", "", NULL};
 326
 327     sstrncpy(n.host, hostname_g, sizeof(n.host));
 328     sstrncpy(n.type_instance, list_item->sensor_name, sizeof(n.type_instance));
 329     sstrncpy(n.type, list_item->sensor_type, sizeof(n.type));
 330     snprintf(n.message, sizeof(n.message), "sensor %s added",
 331              list_item->sensor_name);
 332
 333     plugin_dispatch_notification(&n);
 334   }
 335
 336   return 0;
 337 } /* int sensor_list_add */
 338
 339 static int sensor_list_remove(ipmi_sensor_t *sensor) {
 340   ipmi_sensor_id_t sensor_id;
 341   c_ipmi_sensor_list_t *list_item;
 342   c_ipmi_sensor_list_t *list_prev;
 343
 344   sensor_id = ipmi_sensor_convert_to_id(sensor);
 345
 346   pthread_mutex_lock(&sensor_list_lock);
 347
 348   list_prev = NULL;
 349   for (list_item = sensor_list; list_item != NULL;
 350        list_item = list_item->next) {
 351     if (ipmi_cmp_sensor_id(sensor_id, list_item->sensor_id) == 0)
 352       break;
 353     list_prev = list_item;
 354   } /* for (list_item) */
 355
 356   if (list_item == NULL) {
 357     pthread_mutex_unlock(&sensor_list_lock);
 358     return -1;
 359   }
 360
 361   if (list_prev == NULL)
 362     sensor_list = list_item->next;
 363   else
 364     list_prev->next = list_item->next;
 365
 366   list_prev = NULL;
 367   list_item->next = NULL;
 368
 369   pthread_mutex_unlock(&sensor_list_lock);
 370
 371   if (c_ipmi_nofiy_remove && c_ipmi_active) {
 372     notification_t n = {NOTIF_WARNING, cdtime(), "", "", "ipmi", "", "", "",
 373                         NULL};
 374
 375     sstrncpy(n.host, hostname_g, sizeof(n.host));
 376     sstrncpy(n.type_instance, list_item->sensor_name, sizeof(n.type_instance));
 377     sstrncpy(n.type, list_item->sensor_type, sizeof(n.type));
 378     snprintf(n.message, sizeof(n.message), "sensor %s removed",
 379              list_item->sensor_name);
 380
 381     plugin_dispatch_notification(&n);
 382   }
 383
 384   free(list_item);
 385   return 0;
 386 } /* int sensor_list_remove */
 387
 388 static int sensor_list_read_all(void) {
 389   pthread_mutex_lock(&sensor_list_lock);
 390
 391   for (c_ipmi_sensor_list_t *list_item = sensor_list; list_item != NULL;
 392        list_item = list_item->next) {
 393     ipmi_sensor_id_get_reading(list_item->sensor_id, sensor_read_handler,
 394                                /* user data = */ list_item);
 395   } /* for (list_item) */
 396
 397   pthread_mutex_unlock(&sensor_list_lock);
 398
 399   return 0;
 400 } /* int sensor_list_read_all */
 401
 402 static int sensor_list_remove_all(void) {
 403   c_ipmi_sensor_list_t *list_item;
 404
 405   pthread_mutex_lock(&sensor_list_lock);
 406
 407   list_item = sensor_list;
 408   sensor_list = NULL;
 409
 410   pthread_mutex_unlock(&sensor_list_lock);
 411
 412   while (list_item != NULL) {
 413     c_ipmi_sensor_list_t *list_next = list_item->next;
 414
 415     free(list_item);
 416
 417     list_item = list_next;
 418   } /* while (list_item) */
 419
 420   return 0;
 421 } /* int sensor_list_remove_all */
 422
 423 /*
 424  * Entity handlers
 425  */
 426 static void entity_sensor_update_handler(
 427     enum ipmi_update_e op, ipmi_entity_t __attribute__((unused)) * entity,
 428     ipmi_sensor_t *sensor, void __attribute__((unused)) * user_data) {
 429   /* TODO: Ignore sensors we cannot read */
 430
 431   if ((op == IPMI_ADDED) || (op == IPMI_CHANGED)) {
 432     /* Will check for duplicate entries.. */
 433     sensor_list_add(sensor);
 434   } else if (op == IPMI_DELETED) {
 435     sensor_list_remove(sensor);
 436   }
 437 } /* void entity_sensor_update_handler */
 438
 439 /*
 440  * Domain handlers
 441  */
 442 static void domain_entity_update_handler(
 443     enum ipmi_update_e op, ipmi_domain_t __attribute__((unused)) * domain,
 444     ipmi_entity_t *entity, void __attribute__((unused)) * user_data) {
 445   int status;
 446
 447   if (op == IPMI_ADDED) {
 448     status = ipmi_entity_add_sensor_update_handler(
 449         entity, entity_sensor_update_handler, /* user data = */ NULL);
 450     if (status != 0) {
 451       c_ipmi_error("ipmi_entity_add_sensor_update_handler", status);
 452     }
 453   } else if (op == IPMI_DELETED) {
 454     status = ipmi_entity_remove_sensor_update_handler(
 455         entity, entity_sensor_update_handler, /* user data = */ NULL);
 456     if (status != 0) {
 457       c_ipmi_error("ipmi_entity_remove_sensor_update_handler", status);
 458     }
 459   }
 460 } /* void domain_entity_update_handler */
 461
 462 static void domain_connection_change_handler(ipmi_domain_t *domain, int err,
 463                                              unsigned int conn_num,
 464                                              unsigned int port_num,
 465                                              int still_connected,
 466                                              void *user_data) {
 467   int status;
 468
 469   DEBUG("domain_connection_change_handler (domain = %p, err = %i, "
 470         "conn_num = %u, port_num = %u, still_connected = %i, "
 471         "user_data = %p);\n",
 472         (void *)domain, err, conn_num, port_num, still_connected, user_data);
 473
 474   status = ipmi_domain_add_entity_update_handler(
 475       domain, domain_entity_update_handler, /* user data = */ NULL);
 476   if (status != 0) {
 477     c_ipmi_error("ipmi_domain_add_entity_update_handler", status);
 478   }
 479 } /* void domain_connection_change_handler */
 480
 481 static int thread_init(os_handler_t **ret_os_handler) {
 482   os_handler_t *os_handler;
 483   ipmi_con_t *smi_connection = NULL;
 484   ipmi_domain_id_t domain_id;
 485   int status;
 486
 487   os_handler = ipmi_posix_thread_setup_os_handler(SIGIO);
 488   if (os_handler == NULL) {
 489     ERROR("ipmi plugin: ipmi_posix_thread_setup_os_handler failed.");
 490     return -1;
 491   }
 492
 493   ipmi_init(os_handler);
 494
 495   status = ipmi_smi_setup_con(/* if_num = */ 0, os_handler,
 496                               /* user data = */ NULL, &smi_connection);
 497   if (status != 0) {
 498     c_ipmi_error("ipmi_smi_setup_con", status);
 499     return -1;
 500   }
 501
 502   ipmi_open_option_t open_option[1] = {[0] = {.option = IPMI_OPEN_OPTION_ALL,
 503                                               {.ival = 1}}};
 504
 505   status = ipmi_open_domain(
 506       "mydomain", &smi_connection, /* num_con = */ 1,
 507       domain_connection_change_handler, /* user data = */ NULL,
 508       /* domain_fully_up_handler = */ NULL, /* user data = */ NULL, open_option,
 509       sizeof(open_option) / sizeof(open_option[0]), &domain_id);
 510   if (status != 0) {
 511     c_ipmi_error("ipmi_open_domain", status);
 512     return -1;
 513   }
 514
 515   *ret_os_handler = os_handler;
 516   return 0;
 517 } /* int thread_init */
 518
 519 static void *thread_main(void __attribute__((unused)) * user_data) {
 520   int status;
 521   os_handler_t *os_handler = NULL;
 522
 523   status = thread_init(&os_handler);
 524   if (status != 0) {
 525     ERROR("ipmi plugin: thread_init failed.\n");
 526     return (void *)-1;
 527   }
 528
 529   while (c_ipmi_active != 0) {
 530     struct timeval tv = {1, 0};
 531     os_handler->perform_one_op(os_handler, &tv);
 532   }
 533
 534   ipmi_posix_thread_free_os_handler(os_handler);
 535
 536   return (void *)0;
 537 } /* void *thread_main */
 538
 539 static int c_ipmi_config(const char *key, const char *value) {
 540   if (ignorelist == NULL)
 541     ignorelist = ignorelist_create(/* invert = */ 1);
 542   if (ignorelist == NULL)
 543     return 1;
 544
 545   if (strcasecmp("Sensor", key) == 0) {
 546     ignorelist_add(ignorelist, value);
 547   } else if (strcasecmp("IgnoreSelected", key) == 0) {
 548     int invert = 1;
 549     if (IS_TRUE(value))
 550       invert = 0;
 551     ignorelist_set_invert(ignorelist, invert);
 552   } else if (strcasecmp("NotifySensorAdd", key) == 0) {
 553     if (IS_TRUE(value))
 554       c_ipmi_nofiy_add = 1;
 555   } else if (strcasecmp("NotifySensorRemove", key) == 0) {
 556     if (IS_TRUE(value))
 557       c_ipmi_nofiy_remove = 1;
 558   } else if (strcasecmp("NotifySensorNotPresent", key) == 0) {
 559     if (IS_TRUE(value))
 560       c_ipmi_nofiy_notpresent = 1;
 561   } else {
 562     return -1;
 563   }
 564
 565   return 0;
 566 } /* int c_ipmi_config */
 567
 568 static int c_ipmi_init(void) {
 569   int status;
 570
 571   /* Don't send `ADD' notifications during startup (~ 1 minute) */
 572   time_t iv = CDTIME_T_TO_TIME_T(plugin_get_interval());
 573   c_ipmi_init_in_progress = 1 + (60 / iv);
 574
 575   c_ipmi_active = 1;
 576
 577   status = plugin_thread_create(&thread_id, /* attr = */ NULL, thread_main,
 578                                 /* user data = */ NULL, "ipmi");
 579   if (status != 0) {
 580     c_ipmi_active = 0;
 581     thread_id = (pthread_t)0;
 582     ERROR("ipmi plugin: pthread_create failed.");
 583     return -1;
 584   }
 585
 586   return 0;
 587 } /* int c_ipmi_init */
 588
 589 static int c_ipmi_read(void) {
 590   if ((c_ipmi_active == 0) || (thread_id == (pthread_t)0)) {
 591     INFO("ipmi plugin: c_ipmi_read: I'm not active, returning false.");
 592     return -1;
 593   }
 594
 595   sensor_list_read_all();
 596
 597   if (c_ipmi_init_in_progress > 0)
 598     c_ipmi_init_in_progress--;
 599   else
 600     c_ipmi_init_in_progress = 0;
 601
 602   return 0;
 603 } /* int c_ipmi_read */
 604
 605 static int c_ipmi_shutdown(void) {
 606   c_ipmi_active = 0;
 607
 608   if (thread_id != (pthread_t)0) {
 609     pthread_join(thread_id, NULL);
 610     thread_id = (pthread_t)0;
 611   }
 612
 613   sensor_list_remove_all();
 614
 615   return 0;
 616 } /* int c_ipmi_shutdown */
 617
 618 void module_register(void) {
 619   plugin_register_config("ipmi", c_ipmi_config, config_keys, config_keys_num);
 620   plugin_register_init("ipmi", c_ipmi_init);
 621   plugin_register_read("ipmi", c_ipmi_read);
 622   plugin_register_shutdown("ipmi", c_ipmi_shutdown);
 623 } /* void module_register */