1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
|
'\"
.\" CDDL HEADER START
.\"
.\" The contents of this file are subject to the terms of the
.\" Common Development and Distribution License (the "License").
.\" You may not use this file except in compliance with the License.
.\"
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
.\" or http://www.opensolaris.org/os/licensing.
.\" See the License for the specific language governing permissions
.\" and limitations under the License.
.\"
.\" When distributing Covered Code, include this CDDL HEADER in each
.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
.\" If applicable, add the following below this CDDL HEADER, with the
.\" fields enclosed by brackets "[]" replaced with your own identifying
.\" information: Portions Copyright [yyyy] [name of copyright owner]
.\"
.\" CDDL HEADER END
.\"
.\" Copyright (c) 2012, Joyent, Inc. All Rights Reserved
.\"
.TH IMPI 7D "Apr 21, 2012"
.SH NAME
ipmi \- OpenIPMI compatible IPMI interface driver
.SH SYNOPSIS
.LP
.nf
\fB/dev/ipmi0\fR
.fi
.SH DESCRIPTION
.sp
.LP
The \fBipmi\fR device is a character special file that provides access to the
Intelligent Platform Management Interface for the system. For more
information on \fBIPMI\fR and to obtain a copy of the \fBIPMI\fR
specification and implementation guidelines, refer to
http://\fIhttp://www.intel.com/design/servers/ipmi/\fR.
The driver is adapted from the FreeBSD driver which is in turn adapted from
the Linux driver, however, not all features described in the standard are
supported. The current implementation depends on the \fBsmbios\fR(7d) to
discover the existence of an IPMI device.
.sp
.LP
.SH IOCTLS
.sp
.LP
Sending and receiving messages through the IPMI drivers requires the use of
\fBioctl\fR(2).
The ioctl command codes below are defined in \fBsys/ipmi.h\fR.
The third argument to ioctl should be a pointer to the type indicated.
Currently the following ioctls are supported:
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_RECEIVE_MSG "struct ipmi_recv"
.br
Receive a message.
.br
Possible error values:
.RS +8
EAGAIN No messages are in the process queue.
.br
EFAULT An address supplied was invalid.
.br
EMSGSIZE The address could not fit in the message buffer and
will remain in the buffer.
.RE
.RE
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_RECEIVE_MSG_TRUNC "struct ipmi_recv"
.br
Like IPMICTL_RECEIVE_MSG but if the message cannot fit into the buffer, it
will truncate the contents instead of leaving the data in the buffer.
.RE
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_SEND_COMMAND "struct ipmi_req"
.br
Send a message to the interface.
.br
Possible error values:
.RS +8
EFAULT An address supplied was invalid
.br
ENOMEM Buffers could not be allowed for the command, out of memory.
.RE
.RE
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_SET_MY_ADDRESS_CMD "unsigned int"
.br
Set the slave address for source messages.
.RE
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_GET_MY_ADDRESS_CMD "unsigned int"
.br
Get the slave address for source messages.
.RE
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_SET_MY_LUN_CMD "unsigned int"
.br
Set the slave LUN for source messages.
.RE
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_GET_MY_LUN_CMD "unsigned int"
.br
Get the slave LUN for source messages.
.RE
Stub Only Ioctl
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_SET_GETS_EVENTS_CMD int
.br
Set whether this interface receives events.
.RE
Unimplemented Ioctls
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_REGISTER_FOR_CMD
.br
Register to receive a specific command
.RE
.RS +4
.TP
.ie t \(bu
.el o
IPMICTL_UNREGISTER_FOR_CMD
.br
Unregister to receive a specific command
.RE
.SH SEE ALSO
.sp
.LP
\fBipmitool\fR(1M), \fBioctl\fR(2), \fBsmbios\fR(7d)
.sp
.LP
\fIIntelligent Platform Management Interface Specification Second
Generation\fR, v2.0 \(em
June 12, 2009 Markup
.SH NOTES
.sp
.LP
Not all systems include an \fBIPMI\fR.
|
