Linux Certif

Toute la documentation sur la certification Linux LPI

libipmimonitoring

NAME

libipmimonitoring - a library for IPMI sensor monitoring

SYNOPSIS

#include <ipmi_monitoring.h>

int ipmi_monitoring_init(unsigned int debug_flags, int *errnum);

int ipmi_monitoring_sdr_cache_directory(char *dir, int *errnum);

ipmi_monitoring_ctx_t ipmi_monitoring_ctx_create(void);

void ipmi_monitoring_ctx_destroy(ipmi_monitoring_ctx_t c);

int ipmi_monitoring_ctx_errnum(ipmi_monitoring_ctx_t c);

char *ipmi_monitoring_ctx_strerror(int errnum);

int ipmi_monitoring_sensor_readings_by_record_id(ipmi_monitoring_ctx_t c, char *hostname, struct ipmi_monitoring_ipmi_config *config, unsigned int sensor_reading_flags, unsigned int *record_ids, unsigned int record_ids_len);

int ipmi_monitoring_sensor_readings_by_sensor_group(ipmi_monitoring_ctx_t c, char *hostname, struct ipmi_monitoring_ipmi_config *config, unsigned int sensor_reading_flags, unsigned int *sensor_groups, unsigned int sensor_groups_len);

int ipmi_monitoring_iterator_first(ipmi_monitoring_ctx_t c);

int ipmi_monitoring_iterator_next(ipmi_monitoring_ctx_t c);

int ipmi_monitoring_iterator_record_id(ipmi_monitoring_ctx_t c);

int ipmi_monitoring_iterator_sensor_group(ipmi_monitoring_ctx_t c);

char *ipmi_monitoring_iterator_sensor_name(ipmi_monitoring_ctx_t c);

int ipmi_monitoring_iterator_sensor_state(ipmi_monitoring_ctx_t c);

int ipmi_monitoring_iterator_sensor_units(ipmi_monitoring_ctx_t c);

int ipmi_monitoring_iterator_sensor_reading_type(ipmi_monitoring_ctx_t c);

void *ipmi_monitoring_iterator_sensor_reading(ipmi_monitoring_ctx_t c);

void ipmi_monitoring_iterator_destroy(ipmi_monitoring_ctx_t c);

DESCRIPTION

The ipmimonitoring library allows users to get IPMI sensor readings both in-band and out-of-band via a high level iterator interface. In addition, the sensor readings are interpreted into NOMINAL, WARNING, or CRITICAL states, so that monitoring software may take appropriate actions dependent on the sensor readings.

In order to improve efficiency, SDR data will be cached on the host. By default it is cached in /var/cache/ipmimonitoringsdrcache.

Interpretation rules have not been written for all sensors permutations and types. If sensor interpretation rules are needed, please contact the author listed below.

STATE CONFIGURATION

The interpretation of sensors is configurable via the configuration file stored at /etc/ipmi_monitoring_sensors.conf. Various states returnable by IPMI based sensors can be assigned NOMINAL, WARNING, or CRITICAL states to be returned by the libipmimonitoring library. If multiple states are triggered on a sensor reading, the more severe state is returned to the user.

FILES

/var/cache/ipmimonitoringsdrcache

/etc/ipmi_monitoring_sensors.conf

ORIGIN

Developed by Albert Chu <chu11@llnl.gov> on LLNL's GNU/Linux clusters. This software is open source and distributed under the terms of the Gnu GPL.