1IEVENTS(8)                  System Manager's Manual                 IEVENTS(8)
2
3
4

NAME

6       ievents - decode IPMI and PET event data
7

SYNOPSIS

9       ievents [-bfhnprsx] 01 02 03 04 05 06 07 08 09 0a 0b 0c 0d 0e 0f 10
10
11

DESCRIPTION

13       ievents is a standalone utility delivered with ipmiutil, used to inter‐
14       pret raw hex data from IPMI events or from IPMI PET SNMP  trap  varbind
15       data.   This  utility  uses the same interpretation logic as is used by
16       "ipmiutil sel" (showsel) and "ipmiutil getevt" (getevents).
17
18       The data bytes in the input are always assumed to be in hex form.
19
20       This could be useful if a utility other than "ipmiutil sel"  were  used
21       to obtain IPMI SEL records or events and interpretation is needed.
22
23       This would also be needed at an enterprise management station to inter‐
24       pret the PET SNMP trap hex data into human-readable  form,  see  option
25       -p.
26
27

OPTIONS

29       -b bin_file
30              Interpret  a  file  containing raw binary/hex SEL data dumped in
31              binary form, such as that produced  by  "ipmitool  sel  writeraw
32              bin_file".  Each set of 16 bytes in the file will be interpreted
33              as an IPMI event.  (same as -h)
34
35
36       -f sel_file
37              Interpret a file containing raw ascii  text  SEL  data  captured
38              with  ipmiutil sel -r, or some other similar utility.  Each line
39              in the file should be in this form, with no leading spaces:
40              04 00 02 76 a9 4a 47 20 00 04 10 09 6f 42 0f ff
41              If this option is not specified, the default is to  use  the  16
42              bytes taken from the command-line arguments.  (same as -r)
43
44
45       -h bin_file
46              Interpret  a  file  containing raw binary/hex SEL data dumped in
47              binary form, such as that produced  by  "ipmitool  sel  writeraw
48              bin_file".  Each set of 16 bytes in the file will be interpreted
49              as an IPMI event.  (same as -b)
50
51
52       -n     This option generates a New IPMI platform event, using  9  bytes
53              of  input.   The input bytes are the same as the last 9 bytes of
54              an IPMI event.
55
56
57       -p     Decode as PET event bytes, where the input is 34  PET  hex  data
58              bytes,  skipping  the  first  8  of  the  47-byte PET data.  The
59              default without -p assumes that the  input  is  a  16-byte  IPMI
60              event.
61
62
63       -r sel_file
64              Interpret  a  file  containing  raw ascii text SEL data captured
65              with ipmiutil sel -r, or some other similar utility.   (same  as
66              -f)
67
68
69       -s sensor_file
70              Sensor  file  with  the output of "ipmiutil sensor", used to get
71              the  PET  sensor_type  from  the  sensor_num.   The  default  is
72              /usr/share/ipmiutil/sensor_out.txt   as   generated  during  the
73              ipmiutil package installation.  This is  only  needed  with  PET
74              interpretation (-p).
75
76
77       -x     show eXtra debug messages
78
79
80

SEE ALSO

82       ipmiutil(8)   ialarms(8)   iconfig(8)   icmd(8)   idiscover(8)  ifru(8)
83       igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8)
84       isol(8) iwdt(8)
85
86

WARNINGS

88       See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil
89       and any bug fix list.
90
91
93       Copyright (C) 2009  Kontron America, Inc.
94
95       See the file COPYING in the distribution  for  more  details  regarding
96       redistribution.
97
98       This  utility  is  distributed  in the hope that it will be useful, but
99       WITHOUT ANY WARRANTY.
100
101

AUTHOR

103       Andy Cress <arcress at users.sourceforge.net>
104
105
106
107
108                           Version 1.3: 23 June 2009                IEVENTS(8)
Impressum