Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
mptctl.h
Go to the documentation of this file.
1 /*
2  * linux/drivers/message/fusion/mptioctl.h
3  * Fusion MPT misc device (ioctl) driver.
4  * For use with PCI chip/adapter(s):
5  * LSIFC9xx/LSI409xx Fibre Channel
6  * running LSI Fusion MPT (Message Passing Technology) firmware.
7  *
8  * Copyright (c) 1999-2008 LSI Corporation
9  * (mailto:[email protected])
10  *
11  */
12 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
13 /*
14  This program is free software; you can redistribute it and/or modify
15  it under the terms of the GNU General Public License as published by
16  the Free Software Foundation; version 2 of the License.
17 
18  This program is distributed in the hope that it will be useful,
19  but WITHOUT ANY WARRANTY; without even the implied warranty of
20  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21  GNU General Public License for more details.
22 
23  NO WARRANTY
24  THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR
25  CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT
26  LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT,
27  MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is
28  solely responsible for determining the appropriateness of using and
29  distributing the Program and assumes all risks associated with its
30  exercise of rights under this Agreement, including but not limited to
31  the risks and costs of program errors, damage to or loss of data,
32  programs or equipment, and unavailability or interruption of operations.
33 
34  DISCLAIMER OF LIABILITY
35  NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY
36  DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37  DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND
38  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
39  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
40  USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
41  HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES
42 
43  You should have received a copy of the GNU General Public License
44  along with this program; if not, write to the Free Software
45  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
46 */
47 
48 #ifndef MPTCTL_H_INCLUDED
49 #define MPTCTL_H_INCLUDED
50 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
51 
52 
53 
54 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
55 /*
56  *
57  */
58 #define MPT_MISCDEV_BASENAME "mptctl"
59 #define MPT_MISCDEV_PATHNAME "/dev/" MPT_MISCDEV_BASENAME
60 
61 #define MPT_PRODUCT_LENGTH 12
62 
63 /*
64  * Generic MPT Control IOCTLs and structures
65  */
66 #define MPT_MAGIC_NUMBER 'm'
67 
68 #define MPTRWPERF _IOWR(MPT_MAGIC_NUMBER,0,struct mpt_raw_r_w)
69 
70 #define MPTFWDOWNLOAD _IOWR(MPT_MAGIC_NUMBER,15,struct mpt_fw_xfer)
71 #define MPTCOMMAND _IOWR(MPT_MAGIC_NUMBER,20,struct mpt_ioctl_command)
72 
73 #if defined(__KERNEL__) && defined(CONFIG_COMPAT)
74 #define MPTFWDOWNLOAD32 _IOWR(MPT_MAGIC_NUMBER,15,struct mpt_fw_xfer32)
75 #define MPTCOMMAND32 _IOWR(MPT_MAGIC_NUMBER,20,struct mpt_ioctl_command32)
76 #endif
77 
78 #define MPTIOCINFO _IOWR(MPT_MAGIC_NUMBER,17,struct mpt_ioctl_iocinfo)
79 #define MPTIOCINFO1 _IOWR(MPT_MAGIC_NUMBER,17,struct mpt_ioctl_iocinfo_rev0)
80 #define MPTIOCINFO2 _IOWR(MPT_MAGIC_NUMBER,17,struct mpt_ioctl_iocinfo_rev1)
81 #define MPTTARGETINFO _IOWR(MPT_MAGIC_NUMBER,18,struct mpt_ioctl_targetinfo)
82 #define MPTTEST _IOWR(MPT_MAGIC_NUMBER,19,struct mpt_ioctl_test)
83 #define MPTEVENTQUERY _IOWR(MPT_MAGIC_NUMBER,21,struct mpt_ioctl_eventquery)
84 #define MPTEVENTENABLE _IOWR(MPT_MAGIC_NUMBER,22,struct mpt_ioctl_eventenable)
85 #define MPTEVENTREPORT _IOWR(MPT_MAGIC_NUMBER,23,struct mpt_ioctl_eventreport)
86 #define MPTHARDRESET _IOWR(MPT_MAGIC_NUMBER,24,struct mpt_ioctl_diag_reset)
87 #define MPTFWREPLACE _IOWR(MPT_MAGIC_NUMBER,25,struct mpt_ioctl_replace_fw)
88 
89 /*
90  * SPARC PLATFORM REMARKS:
91  * IOCTL data structures that contain pointers
92  * will have different sizes in the driver and applications
93  * (as the app. will not use 8-byte pointers).
94  * Apps should use MPTFWDOWNLOAD and MPTCOMMAND.
95  * The driver will convert data from
96  * mpt_fw_xfer32 (mpt_ioctl_command32) to mpt_fw_xfer (mpt_ioctl_command)
97  * internally.
98  *
99  * If data structures change size, must handle as in IOCGETINFO.
100  */
101 struct mpt_fw_xfer {
102  unsigned int iocnum; /* IOC unit number */
103  unsigned int fwlen;
104  void __user *bufp; /* Pointer to firmware buffer */
105 };
106 
107 #if defined(__KERNEL__) && defined(CONFIG_COMPAT)
108 struct mpt_fw_xfer32 {
109  unsigned int iocnum;
110  unsigned int fwlen;
111  u32 bufp;
112 };
113 #endif /*}*/
114 
115 /*
116  * IOCTL header structure.
117  * iocnum - must be defined.
118  * port - must be defined for all IOCTL commands other than MPTIOCINFO
119  * maxDataSize - ignored on MPTCOMMAND commands
120  * - ignored on MPTFWREPLACE commands
121  * - on query commands, reports the maximum number of bytes to be returned
122  * to the host driver (count includes the header).
123  * That is, set to sizeof(struct mpt_ioctl_iocinfo) for fixed sized commands.
124  * Set to sizeof(struct mpt_ioctl_targetinfo) + datasize for variable
125  * sized commands. (MPTTARGETINFO, MPTEVENTREPORT)
126  */
127 typedef struct _mpt_ioctl_header {
128  unsigned int iocnum; /* IOC unit number */
129  unsigned int port; /* IOC port number */
130  int maxDataSize; /* Maximum Num. bytes to transfer on read */
132 
133 /*
134  * Issue a diagnostic reset
135  */
138 };
139 
140 
141 /*
142  * PCI bus/device/function information structure.
143  */
145  union {
146  struct {
147  unsigned int deviceNumber : 5;
148  unsigned int functionNumber : 3;
149  unsigned int busNumber : 24;
150  } bits;
151  unsigned int asUlong;
152  } u;
153 };
154 
156  union {
157  struct {
158  unsigned int deviceNumber : 5;
159  unsigned int functionNumber : 3;
160  unsigned int busNumber : 24;
161  } bits;
162  unsigned int asUlong;
163  } u;
165 };
166 
167 /*
168  * Adapter Information Page
169  * Read only.
170  * Data starts at offset 0xC
171  */
172 #define MPT_IOCTL_INTERFACE_SCSI (0x00)
173 #define MPT_IOCTL_INTERFACE_FC (0x01)
174 #define MPT_IOCTL_INTERFACE_FC_IP (0x02)
175 #define MPT_IOCTL_INTERFACE_SAS (0x03)
176 #define MPT_IOCTL_VERSION_LENGTH (32)
177 
180  int adapterType; /* SCSI or FCP */
181  int port; /* port number */
182  int pciId; /* PCI Id. */
183  int hwRev; /* hardware revision */
184  int subSystemDevice; /* PCI subsystem Device ID */
185  int subSystemVendor; /* PCI subsystem Vendor ID */
186  int numDevices; /* number of devices */
187  int FWVersion; /* FW Version (integer) */
188  int BIOSVersion; /* BIOS Version (integer) */
189  char driverVersion[MPT_IOCTL_VERSION_LENGTH]; /* Driver Version (string) */
191  char hostId;
192  char rsvd[2];
193  struct mpt_ioctl_pci_info2 pciInfo; /* Added Rev 2 */
194 };
195 
198  int adapterType; /* SCSI or FCP */
199  int port; /* port number */
200  int pciId; /* PCI Id. */
201  int hwRev; /* hardware revision */
202  int subSystemDevice; /* PCI subsystem Device ID */
203  int subSystemVendor; /* PCI subsystem Vendor ID */
204  int numDevices; /* number of devices */
205  int FWVersion; /* FW Version (integer) */
206  int BIOSVersion; /* BIOS Version (integer) */
207  char driverVersion[MPT_IOCTL_VERSION_LENGTH]; /* Driver Version (string) */
209  char hostId;
210  char rsvd[2];
211  struct mpt_ioctl_pci_info pciInfo; /* Added Rev 1 */
212 };
213 
214 /* Original structure, must always accept these
215  * IOCTLs. 4 byte pads can occur based on arch with
216  * above structure. Wish to re-align, but cannot.
217  */
220  int adapterType; /* SCSI or FCP */
221  int port; /* port number */
222  int pciId; /* PCI Id. */
223  int hwRev; /* hardware revision */
224  int subSystemDevice; /* PCI subsystem Device ID */
225  int subSystemVendor; /* PCI subsystem Vendor ID */
226  int numDevices; /* number of devices */
227  int FWVersion; /* FW Version (integer) */
228  int BIOSVersion; /* BIOS Version (integer) */
229  char driverVersion[MPT_IOCTL_VERSION_LENGTH]; /* Driver Version (string) */
231  char hostId;
232  char rsvd[2];
233 };
234 
235 /*
236  * Device Information Page
237  * Report the number of, and ids of, all targets
238  * on this IOC. The ids array is a packed structure
239  * of the known targetInfo.
240  * bits 31-24: reserved
241  * 23-16: LUN
242  * 15- 8: Bus Number
243  * 7- 0: Target ID
244  */
247  int numDevices; /* Num targets on this ioc */
248  int targetInfo[1];
249 };
250 
251 
252 /*
253  * Event reporting IOCTL's. These IOCTL's will
254  * use the following defines:
255  */
258  unsigned short eventEntries;
259  unsigned short reserved;
260  unsigned int eventTypes;
261 };
262 
265  unsigned int eventTypes;
266 };
267 
268 #ifndef __KERNEL__
269 typedef struct {
272  uint data[2];
274 #endif
275 
279 };
280 
281 #define MPT_MAX_NAME 32
287 };
288 
289 /* Replace the FW image cached in host driver memory
290  * newImageSize - image size in bytes
291  * newImage - first byte of the new image
292  */
293 typedef struct mpt_ioctl_replace_fw {
298 
299 /* General MPT Pass through data strucutre
300  *
301  * iocnum
302  * timeout - in seconds, command timeout. If 0, set by driver to
303  * default value.
304  * replyFrameBufPtr - reply location
305  * dataInBufPtr - destination for read
306  * dataOutBufPtr - data source for write
307  * senseDataPtr - sense data location
308  * maxReplyBytes - maximum number of reply bytes to be sent to app.
309  * dataInSize - num bytes for data transfer in (read)
310  * dataOutSize - num bytes for data transfer out (write)
311  * dataSgeOffset - offset in words from the start of the request message
312  * to the first SGL
313  * MF[1];
314  *
315  * Remark: Some config pages have bi-directional transfer,
316  * both a read and a write. The basic structure allows for
317  * a bidirectional set up. Normal messages will have one or
318  * both of these buffers NULL.
319  */
322  int timeout; /* optional (seconds) */
332  char MF[1];
333 };
334 
335 /*
336  * SPARC PLATFORM: See earlier remark.
337  */
338 #if defined(__KERNEL__) && defined(CONFIG_COMPAT)
339 struct mpt_ioctl_command32 {
341  int timeout;
342  u32 replyFrameBufPtr;
343  u32 dataInBufPtr;
344  u32 dataOutBufPtr;
345  u32 senseDataPtr;
346  int maxReplyBytes;
347  int dataInSize;
348  int dataOutSize;
349  int maxSenseBytes;
350  int dataSgeOffset;
351  char MF[1];
352 };
353 #endif /*}*/
354 
355 
356 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
357 
358 #define CPQFCTS_IOC_MAGIC 'Z'
359 #define HP_IOC_MAGIC 'Z'
360 #define HP_GETHOSTINFO _IOR(HP_IOC_MAGIC, 20, hp_host_info_t)
361 #define HP_GETHOSTINFO1 _IOR(HP_IOC_MAGIC, 20, hp_host_info_rev0_t)
362 #define HP_GETTARGETINFO _IOR(HP_IOC_MAGIC, 21, hp_target_info_t)
363 
364 typedef struct _hp_header {
365  unsigned int iocnum;
366  unsigned int host;
367  unsigned int channel;
368  unsigned int id;
369  unsigned int lun;
370 } hp_header_t;
371 
372 /*
373  * Header:
374  * iocnum required (input)
375  * host ignored
376  * channe ignored
377  * id ignored
378  * lun ignored
379  */
380 typedef struct _hp_host_info {
388  ushort host_no; /* SCSI Host number, if scsi driver not loaded*/
389  u8 fw_version[16]; /* string */
390  u8 serial_number[24]; /* string */
395  unsigned int hard_resets; /* driver initiated resets */
396  unsigned int soft_resets; /* ioc, external resets */
397  unsigned int timeouts; /* num timeouts */
399 
400 /* replace ulongs with uints, need to preserve backwards
401  * compatibility.
402  */
403 typedef struct _hp_host_info_rev0 {
411  ushort host_no; /* SCSI Host number, if scsi driver not loaded*/
412  u8 fw_version[16]; /* string */
413  u8 serial_number[24]; /* string */
418  unsigned long hard_resets; /* driver initiated resets */
419  unsigned long soft_resets; /* ioc, external resets */
420  unsigned long timeouts; /* num timeouts */
422 
423 /*
424  * Header:
425  * iocnum required (input)
426  * host required
427  * channel required (bus number)
428  * id required
429  * lun ignored
430  *
431  * All error values between 0 and 0xFFFF in size.
432  */
433 typedef struct _hp_target_info {
441  u8 rsvd[7]; /* 8 byte alignment */
443 
444 #define HP_STATUS_OTHER 1
445 #define HP_STATUS_OK 2
446 #define HP_STATUS_FAILED 3
447 
448 #define HP_BUS_WIDTH_UNK 1
449 #define HP_BUS_WIDTH_8 2
450 #define HP_BUS_WIDTH_16 3
451 #define HP_BUS_WIDTH_32 4
452 
453 #define HP_DEV_SPEED_ASYNC 2
454 #define HP_DEV_SPEED_FAST 3
455 #define HP_DEV_SPEED_ULTRA 4
456 #define HP_DEV_SPEED_ULTRA2 5
457 #define HP_DEV_SPEED_ULTRA160 6
458 #define HP_DEV_SPEED_SCSI1 7
459 #define HP_DEV_SPEED_ULTRA320 8
460 
461 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
462 
463 
464 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
465 
466 #endif
467