[mirror_ubuntu-bionic-kernel.git] / drivers / scsi / ibmvscsi / viosrp.h

/*****************************************************************************/
/* srp.h -- SCSI RDMA Protocol definitions                                   */
/*                                                                           */
/* Written By: Colin Devilbis, IBM Corporation                               */
/*                                                                           */
/* Copyright (C) 2003 IBM Corporation                                        */
/*                                                                           */
/* This program is free software; you can redistribute it and/or modify      */
/* it under the terms of the GNU General Public License as published by      */
/* the Free Software Foundation; either version 2 of the License, or         */
/* (at your option) any later version.                                       */
/*                                                                           */
/* This program is distributed in the hope that it will be useful,           */
/* but WITHOUT ANY WARRANTY; without even the implied warranty of            */
/* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the             */
/* GNU General Public License for more details.                              */
/*                                                                           */
/* You should have received a copy of the GNU General Public License         */
/* along with this program; if not, write to the Free Software               */
/* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA */
/*                                                                           */
/*                                                                           */
/* This file contains structures and definitions for IBM RPA (RS/6000        */
/* platform architecture) implementation of the SRP (SCSI RDMA Protocol)     */
/* standard.  SRP is used on IBM iSeries and pSeries platforms to send SCSI  */
/* commands between logical partitions.                                      */
/*                                                                           */
/* SRP Information Units (IUs) are sent on a "Command/Response Queue" (CRQ)  */
/* between partitions.  The definitions in this file are architected,        */
/* and cannot be changed without breaking compatibility with other versions  */
/* of Linux and other operating systems (AIX, OS/400) that talk this protocol*/
/* between logical partitions                                                */
/*****************************************************************************/
#ifndef VIOSRP_H
#define VIOSRP_H
#include <scsi/srp.h>

#define SRP_VERSION "16.a"
#define SRP_MAX_IU_LEN	256
#define SRP_MAX_LOC_LEN 32

union srp_iu {
	struct srp_login_req login_req;
	struct srp_login_rsp login_rsp;
	struct srp_login_rej login_rej;
	struct srp_i_logout i_logout;
	struct srp_t_logout t_logout;
	struct srp_tsk_mgmt tsk_mgmt;
	struct srp_cmd cmd;
	struct srp_rsp rsp;
	u8 reserved[SRP_MAX_IU_LEN];
};

enum viosrp_crq_headers {
	VIOSRP_CRQ_FREE = 0x00,
	VIOSRP_CRQ_CMD_RSP = 0x80,
	VIOSRP_CRQ_INIT_RSP = 0xC0,
	VIOSRP_CRQ_XPORT_EVENT = 0xFF
};

enum viosrp_crq_init_formats {
	VIOSRP_CRQ_INIT = 0x01,
	VIOSRP_CRQ_INIT_COMPLETE = 0x02
};

enum viosrp_crq_formats {
	VIOSRP_SRP_FORMAT = 0x01,
	VIOSRP_MAD_FORMAT = 0x02,
	VIOSRP_OS400_FORMAT = 0x03,
	VIOSRP_AIX_FORMAT = 0x04,
	VIOSRP_LINUX_FORMAT = 0x05,
	VIOSRP_INLINE_FORMAT = 0x06
};

enum viosrp_crq_status {
	VIOSRP_OK = 0x0,
	VIOSRP_NONRECOVERABLE_ERR = 0x1,
	VIOSRP_VIOLATES_MAX_XFER = 0x2,
	VIOSRP_PARTNER_PANIC = 0x3,
	VIOSRP_DEVICE_BUSY = 0x8,
	VIOSRP_ADAPTER_FAIL = 0x10,
	VIOSRP_OK2 = 0x99,
};

struct viosrp_crq {
	u8 valid;		/* used by RPA */
	u8 format;		/* SCSI vs out-of-band */
	u8 reserved;
	u8 status;		/* non-scsi failure? (e.g. DMA failure) */
	__be16 timeout;		/* in seconds */
	__be16 IU_length;		/* in bytes */
	__be64 IU_data_ptr;	/* the TCE for transferring data */
};

/* MADs are Management requests above and beyond the IUs defined in the SRP
 * standard.  
 */
enum viosrp_mad_types {
	VIOSRP_EMPTY_IU_TYPE = 0x01,
	VIOSRP_ERROR_LOG_TYPE = 0x02,
	VIOSRP_ADAPTER_INFO_TYPE = 0x03,
	VIOSRP_HOST_CONFIG_TYPE = 0x04,
	VIOSRP_CAPABILITIES_TYPE = 0x05,
	VIOSRP_ENABLE_FAST_FAIL = 0x08,
};

enum viosrp_mad_status {
	VIOSRP_MAD_SUCCESS = 0x00,
	VIOSRP_MAD_NOT_SUPPORTED = 0xF1,
	VIOSRP_MAD_FAILED = 0xF7,
};

enum viosrp_capability_type {
	MIGRATION_CAPABILITIES = 0x01,
	RESERVATION_CAPABILITIES = 0x02,
};

enum viosrp_capability_support {
	SERVER_DOES_NOT_SUPPORTS_CAP = 0x0,
	SERVER_SUPPORTS_CAP = 0x01,
	SERVER_CAP_DATA = 0x02,
};

enum viosrp_reserve_type {
	CLIENT_RESERVE_SCSI_2 = 0x01,
};

enum viosrp_capability_flag {
	CLIENT_MIGRATED = 0x01,
	CLIENT_RECONNECT = 0x02,
	CAP_LIST_SUPPORTED = 0x04,
	CAP_LIST_DATA = 0x08,
};

/* 
 * Common MAD header
 */
struct mad_common {
	__be32 type;
	__be16 status;
	__be16 length;
	__be64 tag;
};

/*
 * All SRP (and MAD) requests normally flow from the
 * client to the server.  There is no way for the server to send
 * an asynchronous message back to the client.  The Empty IU is used
 * to hang out a meaningless request to the server so that it can respond
 * asynchrouously with something like a SCSI AER 
 */
struct viosrp_empty_iu {
	struct mad_common common;
	__be64 buffer;
	__be32 port;
};

struct viosrp_error_log {
	struct mad_common common;
	__be64 buffer;
};

struct viosrp_adapter_info {
	struct mad_common common;
	__be64 buffer;
};

struct viosrp_host_config {
	struct mad_common common;
	__be64 buffer;
};

struct viosrp_fast_fail {
	struct mad_common common;
};

struct viosrp_capabilities {
	struct mad_common common;
	__be64 buffer;
};

struct mad_capability_common {
	__be32 cap_type;
	__be16 length;
	__be16 server_support;
};

struct mad_reserve_cap {
	struct mad_capability_common common;
	__be32 type;
};

struct mad_migration_cap {
	struct mad_capability_common common;
	__be32 ecl;
};

struct capabilities{
	__be32 flags;
	char name[SRP_MAX_LOC_LEN];
	char loc[SRP_MAX_LOC_LEN];
	struct mad_migration_cap migration;
	struct mad_reserve_cap reserve;
};

union mad_iu {
	struct viosrp_empty_iu empty_iu;
	struct viosrp_error_log error_log;
	struct viosrp_adapter_info adapter_info;
	struct viosrp_host_config host_config;
	struct viosrp_fast_fail fast_fail;
	struct viosrp_capabilities capabilities;
};

union viosrp_iu {
	union srp_iu srp;
	union mad_iu mad;
};

struct mad_adapter_info_data {
	char srp_version[8];
	char partition_name[96];
	__be32 partition_number;
	__be32 mad_version;
	__be32 os_type;
	__be32 port_max_txu[8];	/* per-port maximum transfer */
};

#endif
Commit	Line	Data
1da177e4 LT	1	/*****************************************************************************/
	2	/* srp.h -- SCSI RDMA Protocol definitions */
	3	/* */
	4	/* Written By: Colin Devilbis, IBM Corporation */
	5	/* */
	6	/* Copyright (C) 2003 IBM Corporation */
	7	/* */
	8	/* This program is free software; you can redistribute it and/or modify */
	9	/* it under the terms of the GNU General Public License as published by */
	10	/* the Free Software Foundation; either version 2 of the License, or */
	11	/* (at your option) any later version. */
	12	/* */
	13	/* This program is distributed in the hope that it will be useful, */
	14	/* but WITHOUT ANY WARRANTY; without even the implied warranty of */
	15	/* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the */
	16	/* GNU General Public License for more details. */
	17	/* */
	18	/* You should have received a copy of the GNU General Public License */
	19	/* along with this program; if not, write to the Free Software */
	20	/* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */
	21	/* */
	22	/* */
	23	/* This file contains structures and definitions for IBM RPA (RS/6000 */
	24	/* platform architecture) implementation of the SRP (SCSI RDMA Protocol) */
	25	/* standard. SRP is used on IBM iSeries and pSeries platforms to send SCSI */
	26	/* commands between logical partitions. */
	27	/* */
	28	/* SRP Information Units (IUs) are sent on a "Command/Response Queue" (CRQ) */
	29	/* between partitions. The definitions in this file are architected, */
	30	/* and cannot be changed without breaking compatibility with other versions */
	31	/* of Linux and other operating systems (AIX, OS/400) that talk this protocol*/
	32	/* between logical partitions */
	33	/*****************************************************************************/
	34	#ifndef VIOSRP_H
	35	#define VIOSRP_H
ef265673 FT	36	#include <scsi/srp.h>
	37
	38	#define SRP_VERSION "16.a"
	39	#define SRP_MAX_IU_LEN 256
126c5cc3	40	#define SRP_MAX_LOC_LEN 32
ef265673 FT	41
	42	union srp_iu {
	43	struct srp_login_req login_req;
	44	struct srp_login_rsp login_rsp;
	45	struct srp_login_rej login_rej;
	46	struct srp_i_logout i_logout;
	47	struct srp_t_logout t_logout;
	48	struct srp_tsk_mgmt tsk_mgmt;
	49	struct srp_cmd cmd;
	50	struct srp_rsp rsp;
	51	u8 reserved[SRP_MAX_IU_LEN];
	52	};
1da177e4	53
55c9b1e5 TD	54	enum viosrp_crq_headers {
	55	VIOSRP_CRQ_FREE = 0x00,
	56	VIOSRP_CRQ_CMD_RSP = 0x80,
	57	VIOSRP_CRQ_INIT_RSP = 0xC0,
	58	VIOSRP_CRQ_XPORT_EVENT = 0xFF
	59	};
	60
	61	enum viosrp_crq_init_formats {
	62	VIOSRP_CRQ_INIT = 0x01,
	63	VIOSRP_CRQ_INIT_COMPLETE = 0x02
	64	};
	65
1da177e4 LT	66	enum viosrp_crq_formats {
	67	VIOSRP_SRP_FORMAT = 0x01,
	68	VIOSRP_MAD_FORMAT = 0x02,
	69	VIOSRP_OS400_FORMAT = 0x03,
	70	VIOSRP_AIX_FORMAT = 0x04,
5de5f1f6 TD	71	VIOSRP_LINUX_FORMAT = 0x05,
5de5f1f6 TD	72	VIOSRP_INLINE_FORMAT = 0x06
1da177e4 LT	73	};
1da177e4 LT	74
c3a3b55a BK	75	enum viosrp_crq_status {
	76	VIOSRP_OK = 0x0,
	77	VIOSRP_NONRECOVERABLE_ERR = 0x1,
	78	VIOSRP_VIOLATES_MAX_XFER = 0x2,
	79	VIOSRP_PARTNER_PANIC = 0x3,
	80	VIOSRP_DEVICE_BUSY = 0x8,
ca61668b BK	81	VIOSRP_ADAPTER_FAIL = 0x10,
ca61668b BK	82	VIOSRP_OK2 = 0x99,
c3a3b55a BK	83	};
c3a3b55a BK	84
1da177e4 LT	85	struct viosrp_crq {
	86	u8 valid; /* used by RPA */
	87	u8 format; /* SCSI vs out-of-band */
	88	u8 reserved;
	89	u8 status; /* non-scsi failure? (e.g. DMA failure) */
72264eb6 AB	90	__be16 timeout; /* in seconds */
	91	__be16 IU_length; /* in bytes */
	92	__be64 IU_data_ptr; /* the TCE for transferring data */
1da177e4 LT	93	};
	94
	95	/* MADs are Management requests above and beyond the IUs defined in the SRP
	96	* standard.
	97	*/
	98	enum viosrp_mad_types {
	99	VIOSRP_EMPTY_IU_TYPE = 0x01,
	100	VIOSRP_ERROR_LOG_TYPE = 0x02,
	101	VIOSRP_ADAPTER_INFO_TYPE = 0x03,
c1988e31	102	VIOSRP_HOST_CONFIG_TYPE = 0x04,
126c5cc3	103	VIOSRP_CAPABILITIES_TYPE = 0x05,
c1988e31 RJ	104	VIOSRP_ENABLE_FAST_FAIL = 0x08,
	105	};
	106
	107	enum viosrp_mad_status {
	108	VIOSRP_MAD_SUCCESS = 0x00,
	109	VIOSRP_MAD_NOT_SUPPORTED = 0xF1,
	110	VIOSRP_MAD_FAILED = 0xF7,
1da177e4 LT	111	};
1da177e4 LT	112
126c5cc3 BK	113	enum viosrp_capability_type {
	114	MIGRATION_CAPABILITIES = 0x01,
	115	RESERVATION_CAPABILITIES = 0x02,
	116	};
	117
	118	enum viosrp_capability_support {
	119	SERVER_DOES_NOT_SUPPORTS_CAP = 0x0,
	120	SERVER_SUPPORTS_CAP = 0x01,
	121	SERVER_CAP_DATA = 0x02,
	122	};
	123
	124	enum viosrp_reserve_type {
	125	CLIENT_RESERVE_SCSI_2 = 0x01,
	126	};
	127
	128	enum viosrp_capability_flag {
	129	CLIENT_MIGRATED = 0x01,
	130	CLIENT_RECONNECT = 0x02,
	131	CAP_LIST_SUPPORTED = 0x04,
	132	CAP_LIST_DATA = 0x08,
	133	};
	134
1da177e4 LT	135	/*
	136	* Common MAD header
	137	*/
	138	struct mad_common {
72264eb6 AB	139	__be32 type;
	140	__be16 status;
	141	__be16 length;
	142	__be64 tag;
1da177e4 LT	143	};
	144
	145	/*
	146	* All SRP (and MAD) requests normally flow from the
	147	* client to the server. There is no way for the server to send
	148	* an asynchronous message back to the client. The Empty IU is used
	149	* to hang out a meaningless request to the server so that it can respond
	150	* asynchrouously with something like a SCSI AER
	151	*/
	152	struct viosrp_empty_iu {
	153	struct mad_common common;
72264eb6 AB	154	__be64 buffer;
72264eb6 AB	155	__be32 port;
1da177e4 LT	156	};
	157
	158	struct viosrp_error_log {
	159	struct mad_common common;
72264eb6	160	__be64 buffer;
1da177e4 LT	161	};
	162
	163	struct viosrp_adapter_info {
	164	struct mad_common common;
72264eb6	165	__be64 buffer;
1da177e4 LT	166	};
	167
	168	struct viosrp_host_config {
	169	struct mad_common common;
72264eb6	170	__be64 buffer;
1da177e4 LT	171	};
1da177e4 LT	172
c1988e31 RJ	173	struct viosrp_fast_fail {
	174	struct mad_common common;
	175	};
	176
126c5cc3 BK	177	struct viosrp_capabilities {
126c5cc3 BK	178	struct mad_common common;
72264eb6	179	__be64 buffer;
126c5cc3 BK	180	};
	181
	182	struct mad_capability_common {
72264eb6 AB	183	__be32 cap_type;
	184	__be16 length;
	185	__be16 server_support;
126c5cc3 BK	186	};
	187
	188	struct mad_reserve_cap {
	189	struct mad_capability_common common;
72264eb6	190	__be32 type;
126c5cc3 BK	191	};
	192
	193	struct mad_migration_cap {
	194	struct mad_capability_common common;
72264eb6	195	__be32 ecl;
126c5cc3 BK	196	};
	197
	198	struct capabilities{
72264eb6	199	__be32 flags;
126c5cc3 BK	200	char name[SRP_MAX_LOC_LEN];
	201	char loc[SRP_MAX_LOC_LEN];
	202	struct mad_migration_cap migration;
	203	struct mad_reserve_cap reserve;
	204	};
	205
1da177e4 LT	206	union mad_iu {
	207	struct viosrp_empty_iu empty_iu;
	208	struct viosrp_error_log error_log;
	209	struct viosrp_adapter_info adapter_info;
	210	struct viosrp_host_config host_config;
c1988e31	211	struct viosrp_fast_fail fast_fail;
126c5cc3	212	struct viosrp_capabilities capabilities;
1da177e4 LT	213	};
	214
	215	union viosrp_iu {
	216	union srp_iu srp;
	217	union mad_iu mad;
	218	};
	219
	220	struct mad_adapter_info_data {
	221	char srp_version[8];
	222	char partition_name[96];
72264eb6 AB	223	__be32 partition_number;
	224	__be32 mad_version;
	225	__be32 os_type;
	226	__be32 port_max_txu[8]; /* per-port maximum transfer */
1da177e4 LT	227	};
	228
	229	#endif