1LIBFREEIPMI(3)                    LIBFREEIPMI                   LIBFREEIPMI(3)
2
3
4

NAME

6       libfreeipmi - FreeIPMI library
7

Introduction

9       Libfreeipmi  is the primary library that most of the FreeIPMI tools are
10       based upon. The following describe the sub-sections of the library.
11
12       api    The highest level API provided by libfreeipmi. It abstracts away
13              the  details of inband and outofband protocols from the user. It
14              also provides useful error codes for the user to  easily  inter‐
15              pret  IPMI  problems.  'api'  is used by most FreeIPMI tools and
16              libraries, such as bmc-info(8), ipmi-sensors(8), and libipmimon‐
17              itoring(3).
18
19       cmds   Provides  fiid templates and 'fill' functions for IPMI commands.
20              Also provides macros definining common parameters for IPMI  com‐
21              mands.  The  cmds are used by most other portions of libfreeipmi
22              including the 'api' sub-section and tools such  as  ipmipower(8)
23              and ipmiconsole(8).
24
25       debug  Provides  various packet/record dumping utility functions.  Uti‐
26              lized by the 'api' subsection and by tools such as  ipmipower(8)
27              and ipmiconsole(8).
28
29       driver Provides  APIs  for  in-band  IPMI communication. Currently sup‐
30              ported drivers are KCS, SSIF, and OpenIPMI. The 'driver'  subsc‐
31              tion is used by tools such as bmc-watchdog(8) and the 'api' sub-
32              section.
33
34       fiid   The "FreeIPMI Interface Definition" provides an API used for the
35              construction/deconstruction  of  packets in libfreeipmi. The API
36              works around fiid-templates, which are then used to create fiid-
37              objects.  Fiid-templates  are used to describe packets through a
38              string-name to  bit-field  mapping.  The  API  allows  users  to
39              read/write  fields  in  an  object using the string to bit-field
40              mapping. Marshalling, packing, endian, and various other network
41              issues are handled within 'fiid'. Fiid objects are used through‐
42              out libfreeipmi, including the 'api'  sub-section,  'cmds'  sub-
43              sections, and various tools.
44
45       fru-parse
46              Provides  an  API  for  parsing  Field  Replaceable  Unit  (FRU)
47              records.  Utilized by tools such as ipmi-fru(8).
48
49       interface
50              Provides 'assemble' and  'disassemble'  functions  for  building
51              packets  for  individual  in-band or out-of-band protocols. Also
52              provides all necessary fiid  templates,  'fill'  functions,  and
53              other  utility  functions  necessary  to  communicate on an IPMI
54              interface. Utilized by the 'api' sub-section and tools  such  as
55              ipmipower(8) and ipmiconsole(8).
56
57       locate Provides  an API to probe several standards to find default val‐
58              ues for in-band IPMI communication. Utilized by the  'api'  sub-
59              section and the ipmi-locate(8) tool.
60
61       record-format
62              Provides macros, fiid-templates, and information on records used
63              in IPMI. Utilized by the 'sdr-cache' subsection and  tools  like
64              ipmi-sensors(8).
65
66       sdr-cache
67              Provides  an  API  for creating, caching, reading, and parsing a
68              sensor data repository (SDR). Utilized by tools  such  as  ipmi-
69              fru(8), ipmi-sensors(8) and ipmimonitoring(8).
70
71       sdr-parse
72              Provides  an API for parsing SDR records. Utilized by tools such
73              as ipmi-fru(8) and ipmi-sensors(8)
74
75       sel-parse
76              Provides an API for reading and parsing System Event  Log  (SEL)
77              entries.  Utilized by tools such as ipmi-sel(8).
78
79       sensor-read
80              Provides  an API for reading a sensor. Utilized by tools such as
81              ipmi-sensors(8).
82
83       spec   Provides macros and arrays for  various  other  definitions  and
84              tables in IPMI. Utilized by tools such as ipmi-sensors(8).
85
86       util   Provides  various utility functions for the calculation of keys,
87              sensor readings, etc. Utilized by most of the rest of FreeIPMI.
88
89

FILES

91       /usr/include/freeipmi.h
92
93       /usr/include/freeipmi/
94
95

97       Copyright © 2003-2010 FreeIPMI Core Team.
98
99       This library is free software; you can redistribute it and/or modify it
100       under  the  terms of the GNU General Public License as published by the
101       Free Software Foundation; either version 2 of the License, or (at  your
102       option) any later version.
103

SEE ALSO

105       libipmiconsole(3), libipmidetect(3), libipmimonitoring(3), freeipmi(7),
106       bmc-config(8),  bmc-info(8),  bmc-watchdog(8),  ipmi-chassis(8),  ipmi-
107       fru(8),  ipmi-locate(8),  ipmi-oem(8),  ipmi-raw(8), ipmi-sel(8), ipmi-
108       sensors(8),  ipmi-sensors-config(8),   ipmiconsole(8),   ipmidetect(8),
109       ipmimonitoring(8), ipmiping(8), ipmipower(8), ipmi-pef-config(8), rmcp‐
110       ping(8)
111
112       http://www.gnu.org/software/freeipmi/
113
114
115
116libfreeipmi 0.8.8                  @ISODATE                     LIBFREEIPMI(3)
Impressum