Man Linux: Main Page and Category List

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);

       int ipmi_monitoring_sdr_cache_filenames(char *format, 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 Libipmimonitoring implements a high level sensor monitoring API for
       IPMI  sensors.  The goal of this library is to abstract away all of the
       underlying IPMI details away from the user and map IPMI sensor readings
       into  NOMINAL,  WARNING, or CRITICAL states. By mapping sensor readings
       into NOMINAL, WARNING, or CRITICAL states, it makes monitoring  sensors
       easier  across  large  numbers  of nodes. An iterator interface is also
       provided that allows the user to iterate through sensor values, groups,
       units, and states.

       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 developers as listed below.

STATE CONFIGURATION

       The interpretation of sensors is  configurable  via  the  configuration
       file      stored     at     /etc/ipmi_monitoring_sensors.conf.      See
       ipmi_monitoring_sensors.conf(5) for  more  information  on  configuring
       sensor interpretations.

FILES

       /var/cache/ipmimonitoringsdrcache

       /etc/ipmi_monitoring_sensors.conf

REPORTING BUGS

       Report bugs to <freeipmi-users@gnu.org> or <freeipmi-devel@gnu.org>.

COPYRIGHT

       Copyright (C) 2007-2008 Lawrence Livermore National Security, LLC.
       Copyright (C) 2006-2007 The Regents of the University of California.

       This library is free software; you can redistribute it and/or modify it
       under the terms of the GNU General Public License as published  by  the
       Free  Software Foundation; either version 2 of the License, or (at your
       option) any later version.

SEE ALSO

       ipmi_monitoring_sensors.conf(5), ipmimonitoring(8)

       http://www.gnu.org/software/freeipmi/