viosrp.h 6.07 KB
Newer Older
Linus Torvalds's avatar
Linus Torvalds committed
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
/*****************************************************************************/
/* 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.                              */
/*                                                                           */
/* 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
31 32 33 34
#include <scsi/srp.h>

#define SRP_VERSION "16.a"
#define SRP_MAX_IU_LEN	256
35
#define SRP_MAX_LOC_LEN 32
36 37 38 39 40 41 42 43 44 45 46 47

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];
};
Linus Torvalds's avatar
Linus Torvalds committed
48

49 50 51 52 53 54 55 56 57 58 59 60
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
};

Linus Torvalds's avatar
Linus Torvalds committed
61 62 63 64 65
enum viosrp_crq_formats {
	VIOSRP_SRP_FORMAT = 0x01,
	VIOSRP_MAD_FORMAT = 0x02,
	VIOSRP_OS400_FORMAT = 0x03,
	VIOSRP_AIX_FORMAT = 0x04,
66 67
	VIOSRP_LINUX_FORMAT = 0x05,
	VIOSRP_INLINE_FORMAT = 0x06
Linus Torvalds's avatar
Linus Torvalds committed
68 69
};

70 71 72 73 74 75
enum viosrp_crq_status {
	VIOSRP_OK = 0x0,
	VIOSRP_NONRECOVERABLE_ERR = 0x1,
	VIOSRP_VIOLATES_MAX_XFER = 0x2,
	VIOSRP_PARTNER_PANIC = 0x3,
	VIOSRP_DEVICE_BUSY = 0x8,
76 77
	VIOSRP_ADAPTER_FAIL = 0x10,
	VIOSRP_OK2 = 0x99,
78 79
};

Linus Torvalds's avatar
Linus Torvalds committed
80 81 82 83 84
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) */
85 86 87
	__be16 timeout;		/* in seconds */
	__be16 IU_length;		/* in bytes */
	__be64 IU_data_ptr;	/* the TCE for transferring data */
Linus Torvalds's avatar
Linus Torvalds committed
88 89 90
};

/* MADs are Management requests above and beyond the IUs defined in the SRP
91
 * standard.
Linus Torvalds's avatar
Linus Torvalds committed
92 93 94 95 96
 */
enum viosrp_mad_types {
	VIOSRP_EMPTY_IU_TYPE = 0x01,
	VIOSRP_ERROR_LOG_TYPE = 0x02,
	VIOSRP_ADAPTER_INFO_TYPE = 0x03,
97
	VIOSRP_CAPABILITIES_TYPE = 0x05,
98 99 100 101 102 103 104
	VIOSRP_ENABLE_FAST_FAIL = 0x08,
};

enum viosrp_mad_status {
	VIOSRP_MAD_SUCCESS = 0x00,
	VIOSRP_MAD_NOT_SUPPORTED = 0xF1,
	VIOSRP_MAD_FAILED = 0xF7,
Linus Torvalds's avatar
Linus Torvalds committed
105 106
};

107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128
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,
};

129
/*
Linus Torvalds's avatar
Linus Torvalds committed
130 131 132
 * Common MAD header
 */
struct mad_common {
133 134 135 136
	__be32 type;
	__be16 status;
	__be16 length;
	__be64 tag;
Linus Torvalds's avatar
Linus Torvalds committed
137 138 139 140 141 142 143
};

/*
 * 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
144
 * asynchrouously with something like a SCSI AER
Linus Torvalds's avatar
Linus Torvalds committed
145 146 147
 */
struct viosrp_empty_iu {
	struct mad_common common;
148 149
	__be64 buffer;
	__be32 port;
Linus Torvalds's avatar
Linus Torvalds committed
150 151 152 153
};

struct viosrp_error_log {
	struct mad_common common;
154
	__be64 buffer;
Linus Torvalds's avatar
Linus Torvalds committed
155 156 157 158
};

struct viosrp_adapter_info {
	struct mad_common common;
159
	__be64 buffer;
Linus Torvalds's avatar
Linus Torvalds committed
160 161
};

162 163 164 165
struct viosrp_fast_fail {
	struct mad_common common;
};

166 167
struct viosrp_capabilities {
	struct mad_common common;
168
	__be64 buffer;
169 170 171
};

struct mad_capability_common {
172 173 174
	__be32 cap_type;
	__be16 length;
	__be16 server_support;
175 176 177 178
};

struct mad_reserve_cap {
	struct mad_capability_common common;
179
	__be32 type;
180 181 182 183
};

struct mad_migration_cap {
	struct mad_capability_common common;
184
	__be32 ecl;
185 186
};

187
struct capabilities {
188
	__be32 flags;
189 190 191 192 193 194
	char name[SRP_MAX_LOC_LEN];
	char loc[SRP_MAX_LOC_LEN];
	struct mad_migration_cap migration;
	struct mad_reserve_cap reserve;
};

Linus Torvalds's avatar
Linus Torvalds committed
195 196 197 198
union mad_iu {
	struct viosrp_empty_iu empty_iu;
	struct viosrp_error_log error_log;
	struct viosrp_adapter_info adapter_info;
199
	struct viosrp_fast_fail fast_fail;
200
	struct viosrp_capabilities capabilities;
Linus Torvalds's avatar
Linus Torvalds committed
201 202 203 204 205 206 207 208 209 210
};

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

struct mad_adapter_info_data {
	char srp_version[8];
	char partition_name[96];
211
	__be32 partition_number;
212
#define SRP_MAD_VERSION_1 1
213
	__be32 mad_version;
214 215
#define SRP_MAD_OS_LINUX 2
#define SRP_MAD_OS_AIX 3
216 217
	__be32 os_type;
	__be32 port_max_txu[8];	/* per-port maximum transfer */
Linus Torvalds's avatar
Linus Torvalds committed
218 219 220
};

#endif