Release 4.7 include/scsi/fc/fc_fcp.h
/*
* Copyright(c) 2007 Intel Corporation. All rights reserved.
*
* This program is free software; you can redistribute it and/or modify it
* under the terms and conditions of the GNU General Public License,
* version 2, as published by the Free Software Foundation.
*
* This program is distributed in the hope 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.,
* 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
*
* Maintained at www.Open-FCoE.org
*/
#ifndef _FC_FCP_H_
#define _FC_FCP_H_
#include <scsi/scsi.h>
/*
* Fibre Channel Protocol for SCSI.
* From T10 FCP-3, T10 project 1560-D Rev 4, Sept. 13, 2005.
*/
/*
* fc/fs.h defines FC_TYPE_FCP.
*/
/*
* Service parameter page parameters (word 3 bits) for Process Login.
*/
#define FCP_SPPF_TASK_RETRY_ID 0x0200
/* task retry ID requested */
#define FCP_SPPF_RETRY 0x0100
/* retry supported */
#define FCP_SPPF_CONF_COMPL 0x0080
/* confirmed completion allowed */
#define FCP_SPPF_OVLY_ALLOW 0x0040
/* data overlay allowed */
#define FCP_SPPF_INIT_FCN 0x0020
/* initiator function */
#define FCP_SPPF_TARG_FCN 0x0010
/* target function */
#define FCP_SPPF_RD_XRDY_DIS 0x0002
/* disable XFER_RDY for reads */
#define FCP_SPPF_WR_XRDY_DIS 0x0001
/* disable XFER_RDY for writes */
/*
* FCP_CMND IU Payload.
*/
struct fcp_cmnd {
struct scsi_lun fc_lun; /* logical unit number */
__u8 fc_cmdref; /* command reference number */
__u8 fc_pri_ta; /* priority and task attribute */
__u8 fc_tm_flags; /* task management flags */
__u8 fc_flags; /* additional len & flags */
__u8 fc_cdb[16]; /* base CDB */
__be32 fc_dl; /* data length (must follow fc_cdb) */
};
#define FCP_CMND_LEN 32
/* expected length of structure */
struct fcp_cmnd32 {
struct scsi_lun fc_lun; /* logical unit number */
__u8 fc_cmdref; /* command reference number */
__u8 fc_pri_ta; /* priority and task attribute */
__u8 fc_tm_flags; /* task management flags */
__u8 fc_flags; /* additional len & flags */
__u8 fc_cdb[32]; /* base CDB */
__be32 fc_dl; /* data length (must follow fc_cdb) */
};
#define FCP_CMND32_LEN 48
/* expected length of structure */
#define FCP_CMND32_ADD_LEN (16 / 4)
/* Additional cdb length */
/*
* fc_pri_ta.
*/
#define FCP_PTA_SIMPLE 0
/* simple task attribute */
#define FCP_PTA_HEADQ 1
/* head of queue task attribute */
#define FCP_PTA_ORDERED 2
/* ordered task attribute */
#define FCP_PTA_ACA 4
/* auto. contingent allegiance */
#define FCP_PTA_MASK 7
/* mask for task attribute field */
#define FCP_PRI_SHIFT 3
/* priority field starts in bit 3 */
#define FCP_PRI_RESVD_MASK 0x80
/* reserved bits in priority field */
/*
* fc_tm_flags - task management flags field.
*/
#define FCP_TMF_CLR_ACA 0x40
/* clear ACA condition */
#define FCP_TMF_TGT_RESET 0x20
/* target reset task management,
deprecated as of FCP-3 */
#define FCP_TMF_LUN_RESET 0x10
/* logical unit reset task management */
#define FCP_TMF_CLR_TASK_SET 0x04
/* clear task set */
#define FCP_TMF_ABT_TASK_SET 0x02
/* abort task set */
/*
* fc_flags.
* Bits 7:2 are the additional FCP_CDB length / 4.
*/
#define FCP_CFL_LEN_MASK 0xfc
/* mask for additional length */
#define FCP_CFL_LEN_SHIFT 2
/* shift bits for additional length */
#define FCP_CFL_RDDATA 0x02
/* read data */
#define FCP_CFL_WRDATA 0x01
/* write data */
/*
* FCP_TXRDY IU - transfer ready payload.
*/
struct fcp_txrdy {
__be32 ft_data_ro; /* data relative offset */
__be32 ft_burst_len; /* burst length */
__u8 _ft_resvd[4]; /* reserved */
};
#define FCP_TXRDY_LEN 12
/* expected length of structure */
/*
* FCP_RESP IU - response payload.
*
* The response payload comes in three parts: the flags/status, the
* sense/response lengths and the sense data/response info section.
*
* From FCP3r04, note 6 of section 9.5.13:
*
* Some early implementations presented the FCP_RSP IU without the FCP_RESID,
* FCP_SNS_LEN, and FCP_RSP_LEN fields if the FCP_RESID_UNDER, FCP_RESID_OVER,
* FCP_SNS_LEN_VALID, and FCP_RSP_LEN_VALID bits were all set to zero. This
* non-standard behavior should be tolerated.
*
* All response frames will always contain the fcp_resp template. Some
* will also include the fcp_resp_len template.
*
* From Table 23, the FCP_RSP_INFO can either be 4 bytes or 8 bytes, both
* are valid length.
*/
struct fcp_resp {
__u8 _fr_resvd[8]; /* reserved */
__be16 fr_retry_delay; /* retry delay timer */
__u8 fr_flags; /* flags */
__u8 fr_status; /* SCSI status code */
};
#define FCP_RESP_LEN 12
/* expected length of structure */
struct fcp_resp_ext {
__be32 fr_resid; /* Residual value */
__be32 fr_sns_len; /* SCSI Sense length */
__be32 fr_rsp_len; /* Response Info length */
/*
* Optionally followed by RSP info and/or SNS info and/or
* bidirectional read residual length, if any.
*/
};
#define FCP_RESP_EXT_LEN 12
/* expected length of the structure */
struct fcp_resp_rsp_info {
__u8 _fr_resvd[3]; /* reserved */
__u8 rsp_code; /* Response Info Code */
__u8 _fr_resvd2[4]; /* reserved */
};
#define FCP_RESP_RSP_INFO_LEN4 4
/* without reserved field */
#define FCP_RESP_RSP_INFO_LEN8 8
/* with reserved field */
struct fcp_resp_with_ext {
struct fcp_resp resp;
struct fcp_resp_ext ext;
};
#define FCP_RESP_WITH_EXT (FCP_RESP_LEN + FCP_RESP_EXT_LEN)
/*
* fr_flags.
*/
#define FCP_BIDI_RSP 0x80
/* bidirectional read response */
#define FCP_BIDI_READ_UNDER 0x40
/* bidir. read less than requested */
#define FCP_BIDI_READ_OVER 0x20
/* DL insufficient for full transfer */
#define FCP_CONF_REQ 0x10
/* confirmation requested */
#define FCP_RESID_UNDER 0x08
/* transfer shorter than expected */
#define FCP_RESID_OVER 0x04
/* DL insufficient for full transfer */
#define FCP_SNS_LEN_VAL 0x02
/* SNS_LEN field is valid */
#define FCP_RSP_LEN_VAL 0x01
/* RSP_LEN field is valid */
/*
* rsp_codes
*/
enum fcp_resp_rsp_codes {
FCP_TMF_CMPL = 0,
FCP_DATA_LEN_INVALID = 1,
FCP_CMND_FIELDS_INVALID = 2,
FCP_DATA_PARAM_MISMATCH = 3,
FCP_TMF_REJECTED = 4,
FCP_TMF_FAILED = 5,
FCP_TMF_INVALID_LUN = 9,
};
/*
* FCP SRR Link Service request - Sequence Retransmission Request.
*/
struct fcp_srr {
__u8 srr_op; /* opcode ELS_SRR */
__u8 srr_resvd[3]; /* opcode / reserved - must be zero */
__be16 srr_ox_id; /* OX_ID of failed command */
__be16 srr_rx_id; /* RX_ID of failed command */
__be32 srr_rel_off; /* relative offset */
__u8 srr_r_ctl; /* r_ctl for the information unit */
__u8 srr_resvd2[3]; /* reserved */
};
/*
* Feature bits in name server FC-4 Features object.
*/
#define FCP_FEAT_TARG (1 << 0)
/* target function supported */
#define FCP_FEAT_INIT (1 << 1)
/* initiator function supported */
#endif /* _FC_FCP_H_ */
Overall Contributors
| Person | Tokens | Prop | Commits | CommitProp |
| robert love | robert love | 441 | 91.30% | 1 | 12.50% |
| joe eykholt | joe eykholt | 16 | 3.31% | 2 | 25.00% |
| yi zou | yi zou | 11 | 2.28% | 1 | 12.50% |
| andy grover | andy grover | 7 | 1.45% | 1 | 12.50% |
| christof schmitt | christof schmitt | 5 | 1.04% | 1 | 12.50% |
| uwe kleine-koenig | uwe kleine-koenig | 2 | 0.41% | 1 | 12.50% |
| lucas de marchi | lucas de marchi | 1 | 0.21% | 1 | 12.50% |
| Total | 483 | 100.00% | 8 | 100.00% |
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.