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

NAME

6       ipmiutil_sel - show firmware System Event Log records
7

SYNOPSIS

9       ipmiutil sel [-abcflswvx -N node -P/-R pswd -U user -EFJTVYZ]
10
11

DESCRIPTION

13       ipmiutil  sel  is a program that uses IPMI commands to to read and dis‐
14       play the System Event Log (SEL) which is stored by  the  BMC  firmware.
15       IPMI commands are issued to read each record, and, if specified, incre‐
16       mentally write records that have not  previously  been  read  into  the
17       Linux  syslog  (/var/log/messages).   This  utility  can use either the
18       /dev/ipmi0 driver from OpenIPMI, the /dev/imb driver  from  Intel,  the
19       /dev/ipmikcs  driver  from  valinux, direct user-space IOs, or the IPMI
20       LAN interface if -N.
21
22

OPTIONS

24       Command line options are described below.
25
26
27       -a string
28              Add a SEL record with a string of up to 13  characters.   Longer
29              strings  will be truncated.  Note that this should be used spar‐
30              ingly, but would be useful for changes made to the  hardware  or
31              firmware environment, like "Fan replaced" or "flash FW2.1".
32
33
34       -b bin_file
35              Interpret  a  file  containing raw binary/hex SEL data dumped in
36              binary form, such as that produced  by  "ipmitool  sel  writeraw
37              bin_file".  Each set of 16 bytes in the file will be interpreted
38              as an IPMI event.
39
40
41       -c     Show output in a canonical format, with a default  delimiter  of
42              '|'.  (same as -n).
43
44
45       -d     Deletes/Clears  the SEL of all records.  If the SEL becomes full
46              (free space = 0), it no longer accepts new records, so  the  SEL
47              should be cleared periodically (use checksel cron script).
48
49
50       -e     Show  Extended  sensor  descriptions  for events if run locally.
51              This option will attempt to get the full sensor description from
52              /var/lib/ipmiutil/sensor_out.txt, and also use its SDR to decode
53              any raw threshold values in the event, if present.
54
55
56       -f sel_file
57              Interpret a file containing raw ascii  text  SEL  data  captured
58              with  ipmiutil sel -r, or some other similar utility.  Each line
59              in the file should be in this form, with no leading spaces:
60              04 00 02 76 a9 4a 47 20 00 04 10 09 6f 42 0f ff
61              Lines not in this format will be ignored.
62
63
64       -l N   Show last N SEL records, in reverse order (newest  first).   For
65              some BMC implementations, this may not show all N records speci‐
66              fied.
67
68       -n     Show output in a nominal/canonical format, with a default delim‐
69              iter of '|'.  (same as -c).
70
71       -r     Show the 16 raw hex bytes for each SEL entry.  The default is to
72              display interpreted entries,  and  include  relevant  hex  event
73              bytes.
74
75       -p     Port to use.  Defaults to RMCP port 623.
76
77       -s N   Show  only  SEL  events  with  severity  N or greater.  Severity
78              0=INF, 1=MIN, 2=MAJ, 3=CRT.  The default  is  to  show  all  SEL
79              events.
80
81       -u     Show the SEL time as UTC and also get the SEL Time UTC offset if
82              that command is supported.  The default is to  convert  the  SEL
83              Time to local time.
84
85       -v     Only  show  the  version information.  This shows:  the ipmiutil
86              sel utility version, the BMC version, the IPMI version, the  SEL
87              version, and the amount of free space in the SEL.
88
89       -w     This    option   writes   SEL   records   to  the  Linux  syslog
90              (/var/log/messages) or Windows Application Log.  It only  writes
91              SEL  records  that  have  timestamps  newer than the last record
92              written to syslog.  It saves the last timestamp in an index file
93              named /usr/share/ipmiutil/sel.idx (.\sel.idx in Windows).
94
95       -x     Causes extra debug messages to be displayed.
96
97       -N nodename
98              Nodename  or IP address of the remote target system.  If a node‐
99              name is specified, IPMI LAN interface is  used.   Otherwise  the
100              local system management interface is used.
101
102       -U rmt_user
103              Remote  username  for the nodename given.  The default is a null
104              username.
105
106       -P/-R rmt_pswd
107              Remote password for the nodename given.  The default is  a  null
108              password.
109
110       -E     Use the remote password from Environment variable IPMI_PASSWORD.
111
112       -F drv_t
113              Force  the  driver  type  to one of the followng: imb, va, open,
114              gnu, landesk, lan, lan2, lan2i, kcs, smb.  Note that lan2i means
115              lan2  with  intelplus.   The  default is to detect any available
116              driver type and use it.
117
118       -J     Use  the  specified  LanPlus   cipher   suite   (0   thru   17):
119              0=none/none/none,       1=sha1/none/none,      2=sha1/sha1/none,
120              3=sha1/sha1/cbc128,  4=sha1/sha1/xrc4_128,  5=sha1/sha1/xrc4_40,
121              6=md5/none/none, ... 14=md5/md5/xrc4_40.  Default is 3.
122
123       -T     Use  a  specified  IPMI  LAN Authentication Type: 0=None, 1=MD2,
124              2=MD5, 4=Straight Password, 5=OEM.
125
126       -V     Use a specified IPMI  LAN  privilege  level.  1=Callback  level,
127              2=User level, 3=Operator level, 4=Administrator level (default),
128              5=OEM level.
129
130       -Y     Yes, do prompt the  user  for  the  IPMI  LAN  remote  password.
131              Alternatives for the password are -E or -P.
132
133       -Z     Set the slave address for a local MC
134
135

SEE ALSO

137       ipmiutil(8)   ialarms(8)  iconfig(8)  icmd(8)  idiscover(8)  ievents(8)
138       ifru(8) igetevent(8) ihealth(8) ilan(8) ireset(8) isensor(8) iserial(8)
139       isol(8) iwdt(8)
140
141

WARNINGS

143       See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil
144       and any bug fix list.
145
146
148       Copyright (C) 2009  Kontron America, Inc.
149
150       See the file COPYING in the distribution  for  more  details  regarding
151       redistribution.
152
153       This  utility  is  distributed  in the hope that it will be useful, but
154       WITHOUT ANY WARRANTY.
155
156

AUTHOR

158       Andy Cress <arcress at users.sourceforge.net>
159
160
161
162
163                           Version 1.4: 17 Feb 2010                    ISEL(8)
Impressum