1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
23  * have a fairly good understanding of IPMI to use this, so go read
26  * With that said, this driver provides a multi-user interface to the
32  * Multi-user means that multiple applications may use the driver,
52 	 /* Try to take these from the "Channel Medium Type" table
55 	short channel;  member
61  * The channel is the BMC's channel number for the channel (usually
67 	short         channel;  member
78 	short         channel;  member
91 	short         channel;  member
102  * spec.  We do not use rqSWID and rsSWID like it shows in the
103  * message.  Instead, we use remote_SWID and local_SWID.  This means
117 	short         channel;  member
127  * Channel for talking directly with the BMC.  When using this
128  * channel, This is for the system interface address type only.  FIXME
129  * - is this right, or should we use -1?
135  * Used to signify an "all channel" bitmask.  This is more than the
172  * is used for the receive in-kernel interface and in the receive
218  * descriptor, you just can use read to get it.
221  * responses back.  You can use the msgid value to correlate commands
228  * The address type depends upon the channel type.  When talking
230  * (IPMI_UNUSED_ADDR_TYPE).  When talking to an IPMB channel, you must
234  * details of formatting and sending messages on that channel.  You do
236  * whatever command you want to the channel, the driver will create
261  *   - EFAULT - an address supplied was invalid.
262  *   - EINVAL - The address supplied was not valid, or the command
264  *   - EMSGSIZE - The message to was too large.
265  *   - ENOMEM - Buffers could not be allocated for the command.
283  *   - EFAULT - an address supplied was invalid.
284  *   - EINVAL - The address supplied was not valid, or the command
286  *   - EMSGSIZE - The message to was too large.
287  *   - ENOMEM - Buffers could not be allocated for the command.
322  *  - EAGAIN - no messages in the queue.
323  *  - EFAULT - an address supplied was invalid.
324  *  - EINVAL - The address supplied was not valid.
325  *  - EMSGSIZE - The message to was too large to fit into the message buffer,
346  *   - EFAULT - an address supplied was invalid.
347  *   - EBUSY - The netfn/cmd supplied was already in use.
348  *   - ENOMEM - could not allocate memory for the entry.
354  *  - EFAULT - an address supplied was invalid.
355  *  - ENOENT - The netfn/cmd was not found registered for this user.
364  * else.  The chans field is a bitmask, (1 << channel) for each channel.
375  *   - EFAULT - an address supplied was invalid.
376  *   - EBUSY - One of the netfn/cmd/chans supplied was already in use.
377  *   - ENOMEM - could not allocate memory for the entry.
383  *  - EFAULT - an address supplied was invalid.
384  *  - ENOENT - None of the netfn/cmd/chans were found registered for this user.
393  *  - EFAULT - an address supplied was invalid.
398  * Set and get the slave address and LUN that we will use for our
401  * so some initialization code can come in and do the OEM-specific
406 	unsigned short channel;  member