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  *   Pavel Rochnyak <pavel2000 ngs.ru>
  25  **/
  26
  27 #include "collectd.h"
  28
  29 #include "common.h"
  30 #include "plugin.h"
  31 #include "utils_ignorelist.h"
  32
  33 #include <OpenIPMI/ipmi_auth.h>
  34 #include <OpenIPMI/ipmi_conn.h>
  35 #include <OpenIPMI/ipmi_err.h>
  36 #include <OpenIPMI/ipmi_lan.h>
  37 #include <OpenIPMI/ipmi_posix.h>
  38 #include <OpenIPMI/ipmi_smi.h>
  39 #include <OpenIPMI/ipmiif.h>
  40
  41 #define ERR_BUF_SIZE 1024
  42
  43 /*
  44  * Private data types
  45  */
  46 struct c_ipmi_sensor_list_s;
  47 typedef struct c_ipmi_sensor_list_s c_ipmi_sensor_list_t;
  48
  49 struct c_ipmi_instance_s {
  50   char *name;
  51   ignorelist_t *ignorelist;
  52   _Bool notify_add;
  53   _Bool notify_remove;
  54   _Bool notify_notpresent;
  55   _Bool notify_conn;
  56   _Bool sel_enabled;
  57   _Bool sel_clear_event;
  58
  59   char *host;
  60   char *connaddr;
  61   char *username;
  62   char *password;
  63   unsigned int authtype;
  64
  65   _Bool connected;
  66   ipmi_con_t *connection;
  67   pthread_mutex_t sensor_list_lock;
  68   c_ipmi_sensor_list_t *sensor_list;
  69
  70   _Bool active;
  71   pthread_t thread_id;
  72   int init_in_progress;
  73
  74   struct c_ipmi_instance_s *next;
  75 };
  76 typedef struct c_ipmi_instance_s c_ipmi_instance_t;
  77
  78 struct c_ipmi_sensor_list_s {
  79   ipmi_sensor_id_t sensor_id;
  80   char sensor_name[DATA_MAX_NAME_LEN];
  81   char sensor_type[DATA_MAX_NAME_LEN];
  82   char type_instance[DATA_MAX_NAME_LEN];
  83   int sensor_not_present;
  84   c_ipmi_sensor_list_t *next;
  85   c_ipmi_instance_t *instance;
  86   unsigned int use;
  87 };
  88
  89 struct c_ipmi_db_type_map_s {
  90   enum ipmi_unit_type_e type;
  91   const char *type_name;
  92 };
  93 typedef struct c_ipmi_db_type_map_s c_ipmi_db_type_map_t;
  94
  95 /*
  96  * Module global variables
  97  */
  98 static os_handler_t *os_handler = NULL;
  99 static c_ipmi_instance_t *instances = NULL;
 100
 101 /*
 102  * Misc private functions
 103  */
 104 static void c_ipmi_error(c_ipmi_instance_t *st, const char *func, int status) {
 105   char errbuf[ERR_BUF_SIZE] = {0};
 106
 107   if (IPMI_IS_OS_ERR(status) || IPMI_IS_RMCPP_ERR(status) ||
 108       IPMI_IS_IPMI_ERR(status)) {
 109     ipmi_get_error_string(status, errbuf, sizeof(errbuf));
 110   }
 111
 112   if (errbuf[0] == 0) {
 113     snprintf(errbuf, sizeof(errbuf), "Unknown error %#x", status);
 114   }
 115   errbuf[sizeof(errbuf) - 1] = 0;
 116
 117   ERROR("ipmi plugin: %s failed for `%s`: %s", func, st->name, errbuf);
 118 } /* void c_ipmi_error */
 119
 120 static void c_ipmi_log(os_handler_t *handler, const char *format,
 121                        enum ipmi_log_type_e log_type, va_list ap) {
 122   char msg[ERR_BUF_SIZE];
 123
 124   vsnprintf(msg, sizeof(msg), format, ap);
 125
 126   switch (log_type) {
 127   case IPMI_LOG_INFO:
 128     INFO("ipmi plugin: %s", msg);
 129     break;
 130   case IPMI_LOG_WARNING:
 131     NOTICE("ipmi plugin: %s", msg);
 132     break;
 133   case IPMI_LOG_SEVERE:
 134     WARNING("ipmi plugin: %s", msg);
 135     break;
 136   case IPMI_LOG_FATAL:
 137     ERROR("ipmi plugin: %s", msg);
 138     break;
 139   case IPMI_LOG_ERR_INFO:
 140     ERROR("ipmi plugin: %s", msg);
 141     break;
 142 #if COLLECT_DEBUG
 143   case IPMI_LOG_DEBUG_START:
 144   case IPMI_LOG_DEBUG:
 145     DEBUG("ipmi plugin: %s", msg);
 146     break;
 147   case IPMI_LOG_DEBUG_CONT:
 148   case IPMI_LOG_DEBUG_END:
 149     DEBUG("%s", msg);
 150     break;
 151 #else
 152   case IPMI_LOG_DEBUG_START:
 153   case IPMI_LOG_DEBUG:
 154   case IPMI_LOG_DEBUG_CONT:
 155   case IPMI_LOG_DEBUG_END:
 156     break;
 157 #endif
 158   }
 159 } /* void c_ipmi_log */
 160
 161 static notification_t c_ipmi_notification_init(c_ipmi_instance_t const *st,
 162                                                int severity) {
 163   notification_t n = {severity, cdtime(), "", "", "ipmi", "", "", "", NULL};
 164
 165   sstrncpy(n.host, (st->host != NULL) ? st->host : hostname_g, sizeof(n.host));
 166   return n;
 167 } /* notification_t c_ipmi_notification_init */
 168
 169 /*
 170  * Sensor handlers
 171  */
 172 /* Prototype for sensor_list_remove, so sensor_read_handler can call it. */
 173 static int sensor_list_remove(c_ipmi_instance_t *st, ipmi_sensor_t *sensor);
 174
 175 static void sensor_read_handler(ipmi_sensor_t *sensor, int err,
 176                                 enum ipmi_value_present_e value_present,
 177                                 unsigned int __attribute__((unused)) raw_value,
 178                                 double value, ipmi_states_t *states,
 179                                 void *user_data) {
 180   value_list_t vl = VALUE_LIST_INIT;
 181
 182   c_ipmi_sensor_list_t *list_item = user_data;
 183   c_ipmi_instance_t *st = list_item->instance;
 184
 185   list_item->use--;
 186
 187   if (err != 0) {
 188     if (IPMI_IS_IPMI_ERR(err) &&
 189         IPMI_GET_IPMI_ERR(err) == IPMI_NOT_PRESENT_CC) {
 190       if (list_item->sensor_not_present == 0) {
 191         list_item->sensor_not_present = 1;
 192
 193         INFO("ipmi plugin: sensor_read_handler: sensor `%s` of `%s` "
 194              "not present.",
 195              list_item->sensor_name, st->name);
 196
 197         if (st->notify_notpresent) {
 198           notification_t n = c_ipmi_notification_init(st, NOTIF_WARNING);
 199
 200           sstrncpy(n.type_instance, list_item->type_instance,
 201                    sizeof(n.type_instance));
 202           sstrncpy(n.type, list_item->sensor_type, sizeof(n.type));
 203           snprintf(n.message, sizeof(n.message), "sensor %s not present",
 204                    list_item->sensor_name);
 205
 206           plugin_dispatch_notification(&n);
 207         }
 208       }
 209     } else if (IPMI_IS_IPMI_ERR(err) &&
 210                IPMI_GET_IPMI_ERR(err) ==
 211                    IPMI_NOT_SUPPORTED_IN_PRESENT_STATE_CC) {
 212       INFO("ipmi plugin: sensor_read_handler: Sensor `%s` of `%s` not ready.",
 213            list_item->sensor_name, st->name);
 214     } else if (IPMI_IS_IPMI_ERR(err) &&
 215                IPMI_GET_IPMI_ERR(err) == IPMI_TIMEOUT_CC) {
 216       INFO("ipmi plugin: sensor_read_handler: Sensor `%s` of `%s` timed out.",
 217            list_item->sensor_name, st->name);
 218     } else {
 219       char errbuf[ERR_BUF_SIZE] = {0};
 220       ipmi_get_error_string(err, errbuf, sizeof(errbuf) - 1);
 221
 222       if (IPMI_IS_IPMI_ERR(err))
 223         INFO("ipmi plugin: sensor_read_handler: Sensor `%s` of `%s` failed: "
 224              "%s.",
 225              list_item->sensor_name, st->name, errbuf);
 226       else if (IPMI_IS_OS_ERR(err))
 227         INFO("ipmi plugin: sensor_read_handler: Sensor `%s` of `%s` failed: "
 228              "%s (%#x).",
 229              list_item->sensor_name, st->name, errbuf, IPMI_GET_OS_ERR(err));
 230       else if (IPMI_IS_RMCPP_ERR(err))
 231         INFO("ipmi plugin: sensor_read_handler: Sensor `%s` of `%s` failed: "
 232              "%s.",
 233              list_item->sensor_name, st->name, errbuf);
 234       else if (IPMI_IS_SOL_ERR(err))
 235         INFO("ipmi plugin: sensor_read_handler: Sensor `%s` of `%s` failed: "
 236              "%s (%#x).",
 237              list_item->sensor_name, st->name, errbuf, IPMI_GET_SOL_ERR(err));
 238       else
 239         INFO("ipmi plugin: sensor_read_handler: Sensor `%s` of `%s` failed "
 240              "with error %#x. of class %#x",
 241              list_item->sensor_name, st->name, err & 0xff, err & 0xffffff00);
 242     }
 243     return;
 244   } else if (list_item->sensor_not_present == 1) {
 245     list_item->sensor_not_present = 0;
 246
 247     INFO("ipmi plugin: sensor_read_handler: sensor `%s` of `%s` present.",
 248          list_item->sensor_name, st->name);
 249
 250     if (st->notify_notpresent) {
 251       notification_t n = c_ipmi_notification_init(st, NOTIF_OKAY);
 252
 253       sstrncpy(n.type_instance, list_item->type_instance,
 254                sizeof(n.type_instance));
 255       sstrncpy(n.type, list_item->sensor_type, sizeof(n.type));
 256       snprintf(n.message, sizeof(n.message), "sensor %s present",
 257                list_item->sensor_name);
 258
 259       plugin_dispatch_notification(&n);
 260     }
 261   }
 262
 263   if (value_present != IPMI_BOTH_VALUES_PRESENT) {
 264     INFO("ipmi plugin: sensor_read_handler: Removing sensor `%s` of `%s`, "
 265          "because it provides %s. If you need this sensor, "
 266          "please file a bug report.",
 267          list_item->sensor_name, st->name,
 268          (value_present == IPMI_RAW_VALUE_PRESENT) ? "only the raw value"
 269                                                    : "no value");
 270     sensor_list_remove(st, sensor);
 271     return;
 272   }
 273
 274   if (!ipmi_is_sensor_scanning_enabled(states)) {
 275     DEBUG("ipmi plugin: sensor_read_handler: Skipping sensor `%s` of `%s`, "
 276           "it is in 'scanning disabled' state.",
 277           list_item->sensor_name, st->name);
 278     return;
 279   }
 280
 281   if (ipmi_is_initial_update_in_progress(states)) {
 282     DEBUG("ipmi plugin: sensor_read_handler: Skipping sensor `%s` of `%s`, "
 283           "it is in 'initial update in progress' state.",
 284           list_item->sensor_name, st->name);
 285     return;
 286   }
 287
 288   vl.values = &(value_t){.gauge = value};
 289   vl.values_len = 1;
 290
 291   if (st->host != NULL)
 292     sstrncpy(vl.host, st->host, sizeof(vl.host));
 293   sstrncpy(vl.plugin, "ipmi", sizeof(vl.plugin));
 294   sstrncpy(vl.type, list_item->sensor_type, sizeof(vl.type));
 295   sstrncpy(vl.type_instance, list_item->type_instance,
 296            sizeof(vl.type_instance));
 297
 298   plugin_dispatch_values(&vl);
 299 } /* void sensor_read_handler */
 300
 301 static void sensor_get_name(ipmi_sensor_t *sensor, char *buffer, int buf_len) {
 302   char temp[DATA_MAX_NAME_LEN] = {0};
 303   ipmi_entity_t *ent = ipmi_sensor_get_entity(sensor);
 304   const char *entity_id_string = ipmi_entity_get_entity_id_string(ent);
 305   char sensor_name[DATA_MAX_NAME_LEN] = "";
 306   char *sensor_name_ptr;
 307
 308   if ((buffer == NULL) || (buf_len == 0))
 309     return;
 310
 311   ipmi_sensor_get_name(sensor, temp, sizeof(temp));
 312   temp[sizeof(temp) - 1] = 0;
 313
 314   if (entity_id_string != NULL && strlen(temp))
 315     snprintf(sensor_name, sizeof(sensor_name), "%s %s", temp, entity_id_string);
 316   else if (entity_id_string != NULL)
 317     sstrncpy(sensor_name, entity_id_string, sizeof(sensor_name));
 318   else
 319     sstrncpy(sensor_name, temp, sizeof(sensor_name));
 320
 321   if (strlen(temp)) {
 322     sstrncpy(temp, sensor_name, sizeof(temp));
 323     sensor_name_ptr = strstr(temp, ").");
 324     if (sensor_name_ptr != NULL) {
 325       /* If name is something like "foo (123).bar",
 326        * change that to "bar (123)".
 327        * Both, sensor_name_ptr and sensor_id_ptr point to memory within the
 328        * `temp' array, which holds a copy of the current `sensor_name'. */
 329       char *sensor_id_ptr;
 330
 331       /* `sensor_name_ptr' points to ").bar". */
 332       sensor_name_ptr[1] = 0;
 333       /* `temp' holds "foo (123)\0bar\0". */
 334       sensor_name_ptr += 2;
 335       /* `sensor_name_ptr' now points to "bar". */
 336
 337       sensor_id_ptr = strstr(temp, "(");
 338       if (sensor_id_ptr != NULL) {
 339         /* `sensor_id_ptr' now points to "(123)". */
 340         snprintf(sensor_name, sizeof(sensor_name), "%s %s", sensor_name_ptr,
 341                  sensor_id_ptr);
 342       }
 343       /* else: don't touch sensor_name. */
 344     }
 345   }
 346   sstrncpy(buffer, sensor_name, buf_len);
 347 }
 348
 349 static const char *sensor_unit_to_type(ipmi_sensor_t *sensor) {
 350   static const c_ipmi_db_type_map_t ipmi_db_type_map[] = {
 351       {IPMI_UNIT_TYPE_WATTS, "power"}, {IPMI_UNIT_TYPE_CFM, "flow"}};
 352
 353   /* check the modifier and rate of the sensor value */
 354   if ((ipmi_sensor_get_modifier_unit_use(sensor) != IPMI_MODIFIER_UNIT_NONE) ||
 355       (ipmi_sensor_get_rate_unit(sensor) != IPMI_RATE_UNIT_NONE))
 356     return NULL;
 357
 358   /* find the db type by using sensor base unit type */
 359   enum ipmi_unit_type_e ipmi_type = ipmi_sensor_get_base_unit(sensor);
 360   for (int i = 0; i < STATIC_ARRAY_SIZE(ipmi_db_type_map); i++)
 361     if (ipmi_db_type_map[i].type == ipmi_type)
 362       return ipmi_db_type_map[i].type_name;
 363
 364   return NULL;
 365 } /* const char* sensor_unit_to_type */
 366
 367 static int sensor_list_add(c_ipmi_instance_t *st, ipmi_sensor_t *sensor) {
 368   ipmi_sensor_id_t sensor_id;
 369   c_ipmi_sensor_list_t *list_item;
 370   c_ipmi_sensor_list_t *list_prev;
 371
 372   char buffer[DATA_MAX_NAME_LEN] = {0};
 373   char *sensor_name_ptr = buffer;
 374   int sensor_type;
 375   const char *type;
 376
 377   sensor_id = ipmi_sensor_convert_to_id(sensor);
 378   sensor_get_name(sensor, buffer, sizeof(buffer));
 379
 380   DEBUG("ipmi plugin: sensor_list_add: Found sensor `%s` of `%s`,"
 381         " Type: %#x"
 382         " Event reading type: %#x"
 383         " Direction: %#x"
 384         " Event support: %#x",
 385         sensor_name_ptr, st->name, ipmi_sensor_get_sensor_type(sensor),
 386         ipmi_sensor_get_event_reading_type(sensor),
 387         ipmi_sensor_get_sensor_direction(sensor),
 388         ipmi_sensor_get_event_support(sensor));
 389
 390   /* Both `ignorelist' and `sensor_name_ptr' may be NULL. */
 391   if (ignorelist_match(st->ignorelist, sensor_name_ptr) != 0) {
 392     INFO("ipmi plugin: sensor_list_add: Ignore sensor `%s` of `%s`, "
 393          "because it is on ignore list.",
 394          sensor_name_ptr, st->name);
 395     return -1;
 396   }
 397
 398   /* FIXME: Use rate unit or base unit to scale the value */
 399
 400   sensor_type = ipmi_sensor_get_sensor_type(sensor);
 401
 402   /*
 403    * ipmitool/lib/ipmi_sdr.c sdr_sensor_has_analog_reading() has a notice
 404    * about 'Threshold sensors' and 'analog readings'. Discrete sensor may
 405    * have analog data, but discrete sensors support is not implemented
 406    * in Collectd yet.
 407    *
 408    * ipmi_sensor_id_get_reading() supports only 'Threshold' sensors.
 409    * See lib/sensor.c:4842, stand_ipmi_sensor_get_reading() for details.
 410    */
 411   if (!ipmi_sensor_get_is_readable(sensor)) {
 412     INFO("ipmi plugin: sensor_list_add: Ignore sensor `%s` of `%s`, "
 413          "because it isn't readable! Its type: (%#x, %s). ",
 414          sensor_name_ptr, st->name, sensor_type,
 415          ipmi_sensor_get_sensor_type_string(sensor));
 416     return -1;
 417   }
 418
 419   if (ipmi_sensor_get_event_reading_type(sensor) !=
 420       IPMI_EVENT_READING_TYPE_THRESHOLD) {
 421     INFO("ipmi plugin: sensor_list_add: Ignore sensor `%s` of `%s`, "
 422          "because it is discrete (%#x)! Its type: (%#x, %s). ",
 423          sensor_name_ptr, st->name, sensor_type,
 424          ipmi_sensor_get_event_reading_type(sensor),
 425          ipmi_sensor_get_sensor_type_string(sensor));
 426     return -1;
 427   }
 428
 429   switch (sensor_type) {
 430   case IPMI_SENSOR_TYPE_TEMPERATURE:
 431     type = "temperature";
 432     break;
 433
 434   case IPMI_SENSOR_TYPE_VOLTAGE:
 435     type = "voltage";
 436     break;
 437
 438   case IPMI_SENSOR_TYPE_CURRENT:
 439     type = "current";
 440     break;
 441
 442   case IPMI_SENSOR_TYPE_FAN:
 443     type = "fanspeed";
 444     break;
 445
 446   case IPMI_SENSOR_TYPE_MEMORY:
 447     type = "memory";
 448     break;
 449
 450   default: {
 451     /* try to get collectd DB type based on sensor base unit type */
 452     if ((type = sensor_unit_to_type(sensor)) != NULL)
 453       break;
 454
 455     INFO("ipmi plugin: sensor_list_add: Ignore sensor `%s` of `%s`, "
 456          "because I don't know how to handle its units (%#x, %#x, %#x). "
 457          "Sensor type: (%#x, %s). If you need this sensor, please file "
 458          "a bug report at http://collectd.org/.",
 459          sensor_name_ptr, st->name, ipmi_sensor_get_base_unit(sensor),
 460          ipmi_sensor_get_modifier_unit(sensor),
 461          ipmi_sensor_get_rate_unit(sensor), sensor_type,
 462          ipmi_sensor_get_sensor_type_string(sensor));
 463     return -1;
 464   }
 465   } /* switch (sensor_type) */
 466
 467   pthread_mutex_lock(&st->sensor_list_lock);
 468
 469   list_prev = NULL;
 470   for (list_item = st->sensor_list; list_item != NULL;
 471        list_item = list_item->next) {
 472     if (ipmi_cmp_sensor_id(sensor_id, list_item->sensor_id) == 0)
 473       break;
 474     list_prev = list_item;
 475   } /* for (list_item) */
 476
 477   if (list_item != NULL) {
 478     pthread_mutex_unlock(&st->sensor_list_lock);
 479     return 0;
 480   }
 481
 482   list_item = (c_ipmi_sensor_list_t *)calloc(1, sizeof(c_ipmi_sensor_list_t));
 483   if (list_item == NULL) {
 484     pthread_mutex_unlock(&st->sensor_list_lock);
 485     return -1;
 486   }
 487
 488   list_item->instance = st;
 489   list_item->sensor_id = ipmi_sensor_convert_to_id(sensor);
 490
 491   if (list_prev != NULL)
 492     list_prev->next = list_item;
 493   else
 494     st->sensor_list = list_item;
 495
 496   /* if sensor provides the percentage value, use "percent" collectd type
 497      and add the `percent` to the type instance of the reported value */
 498   if (ipmi_sensor_get_percentage(sensor)) {
 499     snprintf(list_item->type_instance, sizeof(list_item->type_instance),
 500              "percent-%s", sensor_name_ptr);
 501     type = "percent";
 502   } else {
 503     /* use type instance as a name of the sensor */
 504     sstrncpy(list_item->type_instance, sensor_name_ptr,
 505              sizeof(list_item->type_instance));
 506   }
 507
 508   sstrncpy(list_item->sensor_name, sensor_name_ptr,
 509            sizeof(list_item->sensor_name));
 510   sstrncpy(list_item->sensor_type, type, sizeof(list_item->sensor_type));
 511
 512   pthread_mutex_unlock(&st->sensor_list_lock);
 513
 514   if (st->notify_add && (st->init_in_progress == 0)) {
 515     notification_t n = c_ipmi_notification_init(st, NOTIF_OKAY);
 516
 517     sstrncpy(n.type_instance, list_item->type_instance,
 518              sizeof(n.type_instance));
 519     sstrncpy(n.type, list_item->sensor_type, sizeof(n.type));
 520     snprintf(n.message, sizeof(n.message), "sensor %s added",
 521              list_item->sensor_name);
 522
 523     plugin_dispatch_notification(&n);
 524   }
 525
 526   return 0;
 527 } /* int sensor_list_add */
 528
 529 static int sensor_list_remove(c_ipmi_instance_t *st, ipmi_sensor_t *sensor) {
 530   ipmi_sensor_id_t sensor_id;
 531   c_ipmi_sensor_list_t *list_item;
 532   c_ipmi_sensor_list_t *list_prev;
 533
 534   sensor_id = ipmi_sensor_convert_to_id(sensor);
 535
 536   pthread_mutex_lock(&st->sensor_list_lock);
 537
 538   list_prev = NULL;
 539   for (list_item = st->sensor_list; list_item != NULL;
 540        list_item = list_item->next) {
 541     if (ipmi_cmp_sensor_id(sensor_id, list_item->sensor_id) == 0)
 542       break;
 543     list_prev = list_item;
 544   } /* for (list_item) */
 545
 546   if (list_item == NULL) {
 547     pthread_mutex_unlock(&st->sensor_list_lock);
 548     return -1;
 549   }
 550
 551   if (list_prev == NULL)
 552     st->sensor_list = list_item->next;
 553   else
 554     list_prev->next = list_item->next;
 555
 556   list_prev = NULL;
 557   list_item->next = NULL;
 558
 559   pthread_mutex_unlock(&st->sensor_list_lock);
 560
 561   if (st->notify_remove && st->active) {
 562     notification_t n = c_ipmi_notification_init(st, NOTIF_WARNING);
 563
 564     sstrncpy(n.type_instance, list_item->type_instance,
 565              sizeof(n.type_instance));
 566     sstrncpy(n.type, list_item->sensor_type, sizeof(n.type));
 567     snprintf(n.message, sizeof(n.message), "sensor %s removed",
 568              list_item->sensor_name);
 569
 570     plugin_dispatch_notification(&n);
 571   }
 572
 573   free(list_item);
 574   return 0;
 575 } /* int sensor_list_remove */
 576
 577 static int sensor_list_read_all(c_ipmi_instance_t *st) {
 578   pthread_mutex_lock(&st->sensor_list_lock);
 579
 580   for (c_ipmi_sensor_list_t *list_item = st->sensor_list; list_item != NULL;
 581        list_item = list_item->next) {
 582     DEBUG("ipmi plugin: try read sensor `%s` of `%s`, use: %d",
 583           list_item->sensor_name, st->name, list_item->use);
 584
 585     /* Reading already initiated */
 586     if (list_item->use)
 587       continue;
 588
 589     list_item->use++;
 590     ipmi_sensor_id_get_reading(list_item->sensor_id, sensor_read_handler,
 591                                /* user data = */ (void *)list_item);
 592   } /* for (list_item) */
 593
 594   pthread_mutex_unlock(&st->sensor_list_lock);
 595
 596   return 0;
 597 } /* int sensor_list_read_all */
 598
 599 static int sensor_list_remove_all(c_ipmi_instance_t *st) {
 600   c_ipmi_sensor_list_t *list_item;
 601
 602   pthread_mutex_lock(&st->sensor_list_lock);
 603
 604   list_item = st->sensor_list;
 605   st->sensor_list = NULL;
 606
 607   pthread_mutex_unlock(&st->sensor_list_lock);
 608
 609   while (list_item != NULL) {
 610     c_ipmi_sensor_list_t *list_next = list_item->next;
 611
 612     free(list_item);
 613
 614     list_item = list_next;
 615   } /* while (list_item) */
 616
 617   return 0;
 618 } /* int sensor_list_remove_all */
 619
 620 static int sensor_convert_threshold_severity(enum ipmi_thresh_e severity) {
 621   switch (severity) {
 622   case IPMI_LOWER_NON_CRITICAL:
 623   case IPMI_UPPER_NON_CRITICAL:
 624     return NOTIF_OKAY;
 625   case IPMI_LOWER_CRITICAL:
 626   case IPMI_UPPER_CRITICAL:
 627     return NOTIF_WARNING;
 628   case IPMI_LOWER_NON_RECOVERABLE:
 629   case IPMI_UPPER_NON_RECOVERABLE:
 630     return NOTIF_FAILURE;
 631   default:
 632     return NOTIF_OKAY;
 633   } /* switch (severity) */
 634 } /* int sensor_convert_threshold_severity */
 635
 636 static void add_event_common_data(notification_t *n, ipmi_sensor_t *sensor,
 637                                   enum ipmi_event_dir_e dir,
 638                                   ipmi_event_t *event) {
 639   ipmi_entity_t *ent = ipmi_sensor_get_entity(sensor);
 640
 641   plugin_notification_meta_add_string(n, "entity_name",
 642                                       ipmi_entity_get_entity_id_string(ent));
 643   plugin_notification_meta_add_signed_int(n, "entity_id",
 644                                           ipmi_entity_get_entity_id(ent));
 645   plugin_notification_meta_add_signed_int(n, "entity_instance",
 646                                           ipmi_entity_get_entity_instance(ent));
 647   plugin_notification_meta_add_boolean(n, "assert", dir == IPMI_ASSERTION);
 648
 649   if (event)
 650     plugin_notification_meta_add_signed_int(n, "event_type",
 651                                             ipmi_event_get_type(event));
 652 } /* void add_event_sensor_meta_data */
 653
 654 static int sensor_threshold_event_handler(
 655     ipmi_sensor_t *sensor, enum ipmi_event_dir_e dir,
 656     enum ipmi_thresh_e threshold, enum ipmi_event_value_dir_e high_low,
 657     enum ipmi_value_present_e value_present, unsigned int raw_value,
 658     double value, void *cb_data, ipmi_event_t *event) {
 659
 660   c_ipmi_instance_t *st = cb_data;
 661
 662   /* From the IPMI specification Chapter 2: Events.
 663    * If a callback handles the event, then all future callbacks called due to
 664    * the event will receive a NULL for the event. So be ready to handle a NULL
 665    * event in all your event handlers. A NULL may also be passed to an event
 666    * handler if the callback was not due to an event. */
 667   if (event == NULL)
 668     return IPMI_EVENT_NOT_HANDLED;
 669
 670   notification_t n = c_ipmi_notification_init(st, NOTIF_OKAY);
 671   /* offset is a table index and it's represented as enum of strings that are
 672      organized in the way - high and low for each threshold severity level */
 673   unsigned int offset = (2 * threshold) + high_low;
 674   unsigned int event_type = ipmi_sensor_get_event_reading_type(sensor);
 675   unsigned int sensor_type = ipmi_sensor_get_sensor_type(sensor);
 676   const char *event_state =
 677       ipmi_get_reading_name(event_type, sensor_type, offset);
 678   sensor_get_name(sensor, n.type_instance, sizeof(n.type_instance));
 679   if (value_present != IPMI_NO_VALUES_PRESENT)
 680     snprintf(n.message, sizeof(n.message),
 681              "sensor %s received event: %s, value is %f", n.type_instance,
 682              event_state, value);
 683   else
 684     snprintf(n.message, sizeof(n.message),
 685              "sensor %s received event: %s, value not provided",
 686              n.type_instance, event_state);
 687
 688   DEBUG("Threshold event received for sensor %s", n.type_instance);
 689
 690   sstrncpy(n.type, ipmi_sensor_get_sensor_type_string(sensor), sizeof(n.type));
 691   n.severity = sensor_convert_threshold_severity(threshold);
 692   n.time = NS_TO_CDTIME_T(ipmi_event_get_timestamp(event));
 693
 694   plugin_notification_meta_add_string(&n, "severity",
 695                                       ipmi_get_threshold_string(threshold));
 696   plugin_notification_meta_add_string(&n, "direction",
 697                                       ipmi_get_value_dir_string(high_low));
 698
 699   switch (value_present) {
 700   case IPMI_BOTH_VALUES_PRESENT:
 701     plugin_notification_meta_add_double(&n, "val", value);
 702   /* both values present, so fall-through to add raw value too */
 703   case IPMI_RAW_VALUE_PRESENT: {
 704     char buf[DATA_MAX_NAME_LEN] = {0};
 705     snprintf(buf, sizeof(buf), "0x%2.2x", raw_value);
 706     plugin_notification_meta_add_string(&n, "raw", buf);
 707   } break;
 708   default:
 709     break;
 710   } /* switch (value_present) */
 711
 712   add_event_common_data(&n, sensor, dir, event);
 713
 714   plugin_dispatch_notification(&n);
 715   plugin_notification_meta_free(n.meta);
 716
 717   /* Delete handled ipmi event from the list */
 718   if (st->sel_clear_event) {
 719     ipmi_event_delete(event, NULL, NULL);
 720     return IPMI_EVENT_HANDLED;
 721   }
 722
 723   return IPMI_EVENT_NOT_HANDLED;
 724 } /* int sensor_threshold_event_handler */
 725
 726 static int sensor_discrete_event_handler(ipmi_sensor_t *sensor,
 727                                          enum ipmi_event_dir_e dir, int offset,
 728                                          int severity, int prev_severity,
 729                                          void *cb_data, ipmi_event_t *event) {
 730
 731   c_ipmi_instance_t *st = cb_data;
 732
 733   /* From the IPMI specification Chapter 2: Events.
 734    * If a callback handles the event, then all future callbacks called due to
 735    * the event will receive a NULL for the event. So be ready to handle a NULL
 736    * event in all your event handlers. A NULL may also be passed to an event
 737    * handler if the callback was not due to an event. */
 738   if (event == NULL)
 739     return IPMI_EVENT_NOT_HANDLED;
 740
 741   notification_t n = c_ipmi_notification_init(st, NOTIF_OKAY);
 742   unsigned int event_type = ipmi_sensor_get_event_reading_type(sensor);
 743   unsigned int sensor_type = ipmi_sensor_get_sensor_type(sensor);
 744   const char *event_state =
 745       ipmi_get_reading_name(event_type, sensor_type, offset);
 746   sensor_get_name(sensor, n.type_instance, sizeof(n.type_instance));
 747   snprintf(n.message, sizeof(n.message), "sensor %s received event: %s",
 748            n.type_instance, event_state);
 749
 750   DEBUG("Discrete event received for sensor %s", n.type_instance);
 751
 752   sstrncpy(n.type, ipmi_sensor_get_sensor_type_string(sensor), sizeof(n.type));
 753   n.time = NS_TO_CDTIME_T(ipmi_event_get_timestamp(event));
 754
 755   plugin_notification_meta_add_signed_int(&n, "offset", offset);
 756
 757   if (severity != -1)
 758     plugin_notification_meta_add_signed_int(&n, "severity", severity);
 759
 760   if (prev_severity != -1)
 761     plugin_notification_meta_add_signed_int(&n, "prevseverity", prev_severity);
 762
 763   add_event_common_data(&n, sensor, dir, event);
 764
 765   plugin_dispatch_notification(&n);
 766   plugin_notification_meta_free(n.meta);
 767
 768   /* Delete handled ipmi event from the list */
 769   if (st->sel_clear_event) {
 770     ipmi_event_delete(event, NULL, NULL);
 771     return IPMI_EVENT_HANDLED;
 772   }
 773
 774   return IPMI_EVENT_NOT_HANDLED;
 775 } /* int sensor_discrete_event_handler */
 776
 777 /*
 778  * Entity handlers
 779  */
 780 static void
 781 entity_sensor_update_handler(enum ipmi_update_e op,
 782                              ipmi_entity_t __attribute__((unused)) * entity,
 783                              ipmi_sensor_t *sensor, void *user_data) {
 784   c_ipmi_instance_t *st = user_data;
 785   char sensor_name[DATA_MAX_NAME_LEN] = {0};
 786
 787   sensor_get_name(sensor, sensor_name, sizeof(sensor_name));
 788   if (ignorelist_match(st->ignorelist, sensor_name) != 0)
 789     return; /* Ignore - sensor on ignore list */
 790
 791   if ((op == IPMI_ADDED) || (op == IPMI_CHANGED)) {
 792     /* Will check for duplicate entries.. */
 793     sensor_list_add(st, sensor);
 794
 795     if (st->sel_enabled) {
 796       int status = 0;
 797       /* register threshold event handler */
 798       if (ipmi_sensor_get_event_reading_type(sensor) ==
 799           IPMI_EVENT_READING_TYPE_THRESHOLD)
 800         status = ipmi_sensor_add_threshold_event_handler(
 801             sensor, sensor_threshold_event_handler, st);
 802       /* register discrete handler if discrete/specific sensor support events */
 803       else if (ipmi_sensor_get_event_support(sensor) != IPMI_EVENT_SUPPORT_NONE)
 804         status = ipmi_sensor_add_discrete_event_handler(
 805             sensor, sensor_discrete_event_handler, st);
 806
 807       if (status) {
 808         ERROR("Unable to add sensor %s event handler, status: %d", sensor_name,
 809               status);
 810       }
 811     }
 812   } else if (op == IPMI_DELETED) {
 813     sensor_list_remove(st, sensor);
 814
 815     if (st->sel_enabled) {
 816       if (ipmi_sensor_get_event_reading_type(sensor) ==
 817           IPMI_EVENT_READING_TYPE_THRESHOLD)
 818         ipmi_sensor_remove_threshold_event_handler(
 819             sensor, sensor_threshold_event_handler, st);
 820       else
 821         ipmi_sensor_remove_discrete_event_handler(
 822             sensor, sensor_discrete_event_handler, st);
 823     }
 824   }
 825 } /* void entity_sensor_update_handler */
 826
 827 /*
 828  * Domain handlers
 829  */
 830 static void
 831 domain_entity_update_handler(enum ipmi_update_e op,
 832                              ipmi_domain_t __attribute__((unused)) * domain,
 833                              ipmi_entity_t *entity, void *user_data) {
 834   int status;
 835   c_ipmi_instance_t *st = user_data;
 836
 837   if (op == IPMI_ADDED) {
 838     status = ipmi_entity_add_sensor_update_handler(
 839         entity, entity_sensor_update_handler, /* user data = */ (void *)st);
 840     if (status != 0) {
 841       c_ipmi_error(st, "ipmi_entity_add_sensor_update_handler", status);
 842     }
 843   } else if (op == IPMI_DELETED) {
 844     status = ipmi_entity_remove_sensor_update_handler(
 845         entity, entity_sensor_update_handler, /* user data = */ (void *)st);
 846     if (status != 0) {
 847       c_ipmi_error(st, "ipmi_entity_remove_sensor_update_handler", status);
 848     }
 849   }
 850 } /* void domain_entity_update_handler */
 851
 852 static void smi_event_handler(ipmi_con_t __attribute__((unused)) * ipmi,
 853                               const ipmi_addr_t __attribute__((unused)) * addr,
 854                               unsigned int __attribute__((unused)) addr_len,
 855                               ipmi_event_t *event, void *cb_data) {
 856   unsigned int type = ipmi_event_get_type(event);
 857   ipmi_domain_t *domain = cb_data;
 858
 859   DEBUG("%s: Event received: type %u", __FUNCTION__, type);
 860
 861   if (type != 0x02)
 862     /* It's not a standard IPMI event. */
 863     return;
 864
 865   /* force domain to reread SELs */
 866   ipmi_domain_reread_sels(domain, NULL, NULL);
 867 }
 868
 869 static void domain_connection_change_handler(ipmi_domain_t *domain, int err,
 870                                              unsigned int conn_num,
 871                                              unsigned int port_num,
 872                                              int still_connected,
 873                                              void *user_data) {
 874
 875   DEBUG("domain_connection_change_handler (domain = %p, err = %i, "
 876         "conn_num = %u, port_num = %u, still_connected = %i, "
 877         "user_data = %p);",
 878         (void *)domain, err, conn_num, port_num, still_connected, user_data);
 879
 880   c_ipmi_instance_t *st = user_data;
 881
 882   if (err != 0)
 883     c_ipmi_error(st, "domain_connection_change_handler", err);
 884
 885   if (!still_connected) {
 886
 887     if (st->notify_conn && st->connected && st->init_in_progress == 0) {
 888       notification_t n = c_ipmi_notification_init(st, NOTIF_FAILURE);
 889
 890       sstrncpy(n.message, "IPMI connection lost", sizeof(n.plugin));
 891
 892       plugin_dispatch_notification(&n);
 893     }
 894
 895     st->connected = 0;
 896     return;
 897   }
 898
 899   if (st->notify_conn && !st->connected && st->init_in_progress == 0) {
 900     notification_t n = c_ipmi_notification_init(st, NOTIF_OKAY);
 901
 902     sstrncpy(n.message, "IPMI connection restored", sizeof(n.plugin));
 903
 904     plugin_dispatch_notification(&n);
 905   }
 906
 907   st->connected = 1;
 908
 909   int status = ipmi_domain_add_entity_update_handler(
 910       domain, domain_entity_update_handler, /* user data = */ st);
 911   if (status != 0) {
 912     c_ipmi_error(st, "ipmi_domain_add_entity_update_handler", status);
 913   }
 914
 915   status = st->connection->add_event_handler(st->connection, smi_event_handler,
 916                                              (void *)domain);
 917
 918   if (status != 0)
 919     c_ipmi_error(st, "Failed to register smi event handler", status);
 920 } /* void domain_connection_change_handler */
 921
 922 static int c_ipmi_thread_init(c_ipmi_instance_t *st) {
 923   ipmi_domain_id_t domain_id;
 924   int status;
 925
 926   if (st->connaddr != NULL) {
 927     status = ipmi_ip_setup_con(
 928         &st->connaddr, &(char *){IPMI_LAN_STD_PORT_STR}, 1, st->authtype,
 929         (unsigned int)IPMI_PRIVILEGE_USER, st->username, strlen(st->username),
 930         st->password, strlen(st->password), os_handler,
 931         /* user data = */ NULL, &st->connection);
 932     if (status != 0) {
 933       c_ipmi_error(st, "ipmi_ip_setup_con", status);
 934       return -1;
 935     }
 936   } else {
 937     status = ipmi_smi_setup_con(/* if_num = */ 0, os_handler,
 938                                 /* user data = */ NULL, &st->connection);
 939     if (status != 0) {
 940       c_ipmi_error(st, "ipmi_smi_setup_con", status);
 941       return -1;
 942     }
 943   }
 944
 945   ipmi_open_option_t opts[] = {
 946       {.option = IPMI_OPEN_OPTION_ALL, {.ival = 1}},
 947 #ifdef IPMI_OPEN_OPTION_USE_CACHE
 948       /* OpenIPMI-2.0.17 and later: Disable SDR cache in local file */
 949       {.option = IPMI_OPEN_OPTION_USE_CACHE, {.ival = 0}},
 950 #endif
 951   };
 952
 953   /*
 954    * NOTE: Domain names must be unique. There is static `domains_list` common
 955    * to all threads inside lib/domain.c and some ops are done by name.
 956    */
 957   status = ipmi_open_domain(
 958       st->name, &st->connection, /* num_con = */ 1,
 959       domain_connection_change_handler, /* user data = */ (void *)st,
 960       /* domain_fully_up_handler = */ NULL, /* user data = */ NULL, opts,
 961       STATIC_ARRAY_SIZE(opts), &domain_id);
 962   if (status != 0) {
 963     c_ipmi_error(st, "ipmi_open_domain", status);
 964     return -1;
 965   }
 966
 967   return 0;
 968 } /* int c_ipmi_thread_init */
 969
 970 static void *c_ipmi_thread_main(void *user_data) {
 971   c_ipmi_instance_t *st = user_data;
 972
 973   int status = c_ipmi_thread_init(st);
 974   if (status != 0) {
 975     ERROR("ipmi plugin: c_ipmi_thread_init failed.");
 976     st->active = 0;
 977     return (void *)-1;
 978   }
 979
 980   while (st->active != 0) {
 981     struct timeval tv = {1, 0};
 982     os_handler->perform_one_op(os_handler, &tv);
 983   }
 984   return (void *)0;
 985 } /* void *c_ipmi_thread_main */
 986
 987 static c_ipmi_instance_t *c_ipmi_init_instance() {
 988   c_ipmi_instance_t *st;
 989
 990   st = calloc(1, sizeof(*st));
 991   if (st == NULL) {
 992     ERROR("ipmi plugin: calloc failed.");
 993     return NULL;
 994   }
 995
 996   st->name = strdup("main");
 997   if (st->name == NULL) {
 998     sfree(st);
 999     ERROR("ipmi plugin: strdup() failed.");
1000     return NULL;
1001   }
1002
1003   st->ignorelist = ignorelist_create(/* invert = */ 1);
1004   if (st->ignorelist == NULL) {
1005     sfree(st->name);
1006     sfree(st);
1007     ERROR("ipmi plugin: ignorelist_create() failed.");
1008     return NULL;
1009   }
1010
1011   st->sensor_list = NULL;
1012   pthread_mutex_init(&st->sensor_list_lock, /* attr = */ NULL);
1013
1014   st->host = NULL;
1015   st->connaddr = NULL;
1016   st->username = NULL;
1017   st->password = NULL;
1018   st->authtype = IPMI_AUTHTYPE_DEFAULT;
1019
1020   st->next = NULL;
1021
1022   return st;
1023 } /* c_ipmi_instance_t *c_ipmi_init_instance */
1024
1025 static void c_ipmi_free_instance(c_ipmi_instance_t *st) {
1026   if (st == NULL)
1027     return;
1028
1029   assert(st->next == NULL);
1030
1031   sfree(st->name);
1032   sfree(st->host);
1033   sfree(st->connaddr);
1034   sfree(st->username);
1035   sfree(st->password);
1036
1037   ignorelist_free(st->ignorelist);
1038   pthread_mutex_destroy(&st->sensor_list_lock);
1039   sfree(st);
1040 } /* void c_ipmi_free_instance */
1041
1042 static void c_ipmi_add_instance(c_ipmi_instance_t *instance) {
1043   if (instances == NULL) {
1044     instances = instance;
1045     return;
1046   }
1047
1048   c_ipmi_instance_t *last = instances;
1049
1050   while (last->next != NULL)
1051     last = last->next;
1052
1053   last->next = instance;
1054 } /* void c_ipmi_add_instance */
1055
1056 static int c_ipmi_config_add_instance(oconfig_item_t *ci) {
1057   int status = 0;
1058   c_ipmi_instance_t *st = c_ipmi_init_instance();
1059   if (st == NULL)
1060     return ENOMEM;
1061
1062   if (strcasecmp(ci->key, "Instance") == 0)
1063     status = cf_util_get_string(ci, &st->name);
1064
1065   if (status != 0) {
1066     c_ipmi_free_instance(st);
1067     return status;
1068   }
1069
1070   for (int i = 0; i < ci->children_num; i++) {
1071     oconfig_item_t *child = ci->children + i;
1072
1073     if (strcasecmp("Sensor", child->key) == 0)
1074       ignorelist_add(st->ignorelist, child->values[0].value.string);
1075     else if (strcasecmp("IgnoreSelected", child->key) == 0) {
1076       _Bool t;
1077       status = cf_util_get_boolean(child, &t);
1078       if (status != 0)
1079         break;
1080       ignorelist_set_invert(st->ignorelist, /* invert = */ !t);
1081     } else if (strcasecmp("NotifyIPMIConnectionState", child->key) == 0) {
1082       status = cf_util_get_boolean(child, &st->notify_conn);
1083     } else if (strcasecmp("NotifySensorAdd", child->key) == 0) {
1084       status = cf_util_get_boolean(child, &st->notify_add);
1085     } else if (strcasecmp("NotifySensorRemove", child->key) == 0) {
1086       status = cf_util_get_boolean(child, &st->notify_remove);
1087     } else if (strcasecmp("NotifySensorNotPresent", child->key) == 0) {
1088       status = cf_util_get_boolean(child, &st->notify_notpresent);
1089     } else if (strcasecmp("SELEnabled", child->key) == 0) {
1090       status = cf_util_get_boolean(child, &st->sel_enabled);
1091     } else if (strcasecmp("SELClearEvent", child->key) == 0) {
1092       status = cf_util_get_boolean(child, &st->sel_clear_event);
1093     } else if (strcasecmp("Host", child->key) == 0)
1094       status = cf_util_get_string(child, &st->host);
1095     else if (strcasecmp("Address", child->key) == 0)
1096       status = cf_util_get_string(child, &st->connaddr);
1097     else if (strcasecmp("Username", child->key) == 0)
1098       status = cf_util_get_string(child, &st->username);
1099     else if (strcasecmp("Password", child->key) == 0)
1100       status = cf_util_get_string(child, &st->password);
1101     else if (strcasecmp("AuthType", child->key) == 0) {
1102       char tmp[8];
1103       status = cf_util_get_string_buffer(child, tmp, sizeof(tmp));
1104       if (status != 0)
1105         break;
1106
1107       if (strcasecmp("MD5", tmp) == 0)
1108         st->authtype = IPMI_AUTHTYPE_MD5;
1109       else if (strcasecmp("rmcp+", tmp) == 0)
1110         st->authtype = IPMI_AUTHTYPE_RMCP_PLUS;
1111       else
1112         WARNING("ipmi plugin: The value \"%s\" is not valid for the "
1113                 "\"AuthType\" option.",
1114                 tmp);
1115     } else {
1116       WARNING("ipmi plugin: Option `%s' not allowed here.", child->key);
1117       status = -1;
1118     }
1119
1120     if (status != 0)
1121       break;
1122   }
1123
1124   if (status != 0) {
1125     c_ipmi_free_instance(st);
1126     return status;
1127   }
1128
1129   c_ipmi_add_instance(st);
1130
1131   return 0;
1132 } /* int c_ipmi_config_add_instance */
1133
1134 static int c_ipmi_config(oconfig_item_t *ci) {
1135   _Bool have_instance_block = 0;
1136
1137   for (int i = 0; i < ci->children_num; i++) {
1138     oconfig_item_t *child = ci->children + i;
1139
1140     if (strcasecmp("Instance", child->key) == 0) {
1141       int status = c_ipmi_config_add_instance(child);
1142       if (status != 0)
1143         return status;
1144
1145       have_instance_block = 1;
1146     } else if (!have_instance_block) {
1147       /* Non-instance option: Assume legacy configuration (without <Instance />
1148        * blocks) and call c_ipmi_config_add_instance with the <Plugin /> block.
1149        */
1150       WARNING("ipmi plugin: Legacy configuration found! Please update your "
1151               "config file.");
1152       return c_ipmi_config_add_instance(ci);
1153     } else {
1154       WARNING("ipmi plugin: The configuration option "
1155               "\"%s\" is not allowed here. Did you "
1156               "forget to add an <Instance /> block "
1157               "around the configuration?",
1158               child->key);
1159       return -1;
1160     }
1161   } /* for (ci->children) */
1162
1163   return 0;
1164 } /* int c_ipmi_config */
1165
1166 static int c_ipmi_read(user_data_t *user_data) {
1167   c_ipmi_instance_t *st = user_data->data;
1168
1169   if (st->active == 0) {
1170     INFO("ipmi plugin: c_ipmi_read: I'm not active, returning false.");
1171     return -1;
1172   }
1173
1174   if (st->connected == 0)
1175     return 0;
1176
1177   sensor_list_read_all(st);
1178
1179   if (st->init_in_progress > 0)
1180     st->init_in_progress--;
1181   else
1182     st->init_in_progress = 0;
1183
1184   return 0;
1185 } /* int c_ipmi_read */
1186
1187 static int c_ipmi_init(void) {
1188   c_ipmi_instance_t *st;
1189   char callback_name[3 * DATA_MAX_NAME_LEN];
1190
1191   if (os_handler != NULL) {
1192     return 0;
1193   }
1194
1195   os_handler = ipmi_posix_thread_setup_os_handler(SIGIO);
1196   if (os_handler == NULL) {
1197     ERROR("ipmi plugin: ipmi_posix_thread_setup_os_handler failed.");
1198     return -1;
1199   }
1200
1201   os_handler->set_log_handler(os_handler, c_ipmi_log);
1202
1203   if (ipmi_init(os_handler) != 0) {
1204     ERROR("ipmi plugin: ipmi_init() failed.");
1205     os_handler->free_os_handler(os_handler);
1206     return -1;
1207   };
1208
1209   if (instances == NULL) {
1210     /* No instances were configured, let's start a default instance. */
1211     st = c_ipmi_init_instance();
1212     if (st == NULL)
1213       return ENOMEM;
1214
1215     c_ipmi_add_instance(st);
1216   }
1217
1218   /* Don't send `ADD' notifications during startup (~ 1 minute) */
1219   int cycles = 1 + (int)(TIME_T_TO_CDTIME_T(60) / plugin_get_interval());
1220
1221   st = instances;
1222   while (NULL != st) {
1223     /* The `st->name` is used as "domain name" for ipmi_open_domain().
1224      * That value should be unique, so we do plugin_register_complex_read()
1225      * at first as it checks the uniqueness. */
1226     snprintf(callback_name, sizeof(callback_name), "ipmi/%s", st->name);
1227
1228     user_data_t ud = {
1229         .data = st,
1230     };
1231
1232     int status = plugin_register_complex_read(
1233         /* group     = */ "ipmi",
1234         /* name      = */ callback_name,
1235         /* callback  = */ c_ipmi_read,
1236         /* interval  = */ 0,
1237         /* user_data = */ &ud);
1238
1239     if (status != 0) {
1240       st = st->next;
1241       continue;
1242     }
1243
1244     st->init_in_progress = cycles;
1245     st->active = 1;
1246
1247     status = plugin_thread_create(&st->thread_id, /* attr = */ NULL,
1248                                   c_ipmi_thread_main,
1249                                   /* user data = */ (void *)st, "ipmi");
1250
1251     if (status != 0) {
1252       st->active = 0;
1253       st->thread_id = (pthread_t){0};
1254
1255       plugin_unregister_read(callback_name);
1256
1257       ERROR("ipmi plugin: pthread_create failed for `%s`.", callback_name);
1258     }
1259
1260     st = st->next;
1261   }
1262
1263   return 0;
1264 } /* int c_ipmi_init */
1265
1266 static int c_ipmi_shutdown(void) {
1267   c_ipmi_instance_t *st = instances;
1268   instances = NULL;
1269
1270   while (st != NULL) {
1271     c_ipmi_instance_t *next = st->next;
1272
1273     st->next = NULL;
1274     st->active = 0;
1275
1276     if (!pthread_equal(st->thread_id, (pthread_t){0})) {
1277       pthread_join(st->thread_id, NULL);
1278       st->thread_id = (pthread_t){0};
1279     }
1280
1281     sensor_list_remove_all(st);
1282     c_ipmi_free_instance(st);
1283
1284     st = next;
1285   }
1286
1287   os_handler->free_os_handler(os_handler);
1288   os_handler = NULL;
1289
1290   return 0;
1291 } /* int c_ipmi_shutdown */
1292
1293 void module_register(void) {
1294   plugin_register_complex_config("ipmi", c_ipmi_config);
1295   plugin_register_init("ipmi", c_ipmi_init);
1296   plugin_register_shutdown("ipmi", c_ipmi_shutdown);
1297 } /* void module_register */