fcp.h

Go to the documentation of this file.

#ifndef _IPXE_FCP_H
#define _IPXE_FCP_H

/**
 * @file
 *
 * Fibre Channel Protocol
 *
 */

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
FILE_SECBOOT ( PERMITTED );

#include <stdint.h>
#include <ipxe/fc.h>
#include <ipxe/fcels.h>
#include <ipxe/scsi.h>

/** An FCP command IU */
struct fcp_cmnd {
        /** SCSI LUN */
        struct scsi_lun lun;
        /** Command reference number */
        uint8_t ref;
        /** Priority and task attributes */
        uint8_t priority;
        /** Task management flags */
        uint8_t flags;
        /** Direction */
        uint8_t dirn;
        /** SCSI CDB */
        union scsi_cdb cdb;
        /** Data length */
        uint32_t len;
} __attribute__ (( packed ));

/** Command includes data-out */
#define FCP_CMND_WRDATA 0x01

/** Command includes data-in */
#define FCP_CMND_RDDATA 0x02

/** FCP tag magic marker */
#define FCP_TAG_MAGIC 0x18ae0000

/** An FCP transfer ready IU */
struct fcp_xfer_rdy {
        /** Relative offset of data */
        uint32_t offset;
        /** Burst length */
        uint32_t len;
        /** Reserved */
        uint32_t reserved;
} __attribute__ (( packed ));

/** An FCP response IU */
struct fcp_rsp {
        /** Reserved */
        uint8_t reserved[8];
        /** Retry delay timer */
        uint16_t retry_delay;
        /** Flags */
        uint8_t flags;
        /** SCSI status code */
        uint8_t status;
        /** Residual data count */
        uint32_t residual;
        /** Sense data length */
        uint32_t sense_len;
        /** Response data length */
        uint32_t response_len;
} __attribute__ (( packed ));

/** Response length field is valid */
#define FCP_RSP_RESPONSE_LEN_VALID 0x01

/** Sense length field is valid */
#define FCP_RSP_SENSE_LEN_VALID 0x02

/** Residual represents overrun */
#define FCP_RSP_RESIDUAL_OVERRUN 0x04

/** Residual represents underrun */
#define FCP_RSP_RESIDUAL_UNDERRUN 0x08

/**
 * Get response data portion of FCP response
 *
 * @v rsp                       FCP response
 * @ret response_data           Response data, or NULL if not present
 */
static inline void * fcp_rsp_response_data ( struct fcp_rsp *rsp ) {
        return ( ( rsp->flags & FCP_RSP_RESPONSE_LEN_VALID ) ?
                 ( ( ( void * ) rsp ) + sizeof ( *rsp ) ) : NULL );
}

/**
 * Get length of response data portion of FCP response
 *
 * @v rsp                       FCP response
 * @ret response_data_len       Response data length
 */
static inline size_t fcp_rsp_response_data_len ( struct fcp_rsp *rsp ) {
        return ( ( rsp->flags & FCP_RSP_RESPONSE_LEN_VALID ) ?
                 ntohl ( rsp->response_len ) : 0 );
}

/**
 * Get sense data portion of FCP response
 *
 * @v rsp                       FCP response
 * @ret sense_data              Sense data, or NULL if not present
 */
static inline void * fcp_rsp_sense_data ( struct fcp_rsp *rsp ) {
        return ( ( rsp->flags & FCP_RSP_SENSE_LEN_VALID ) ?
                 ( ( ( void * ) rsp ) + sizeof ( *rsp ) +
                   fcp_rsp_response_data_len ( rsp ) ) : NULL );
}

/**
 * Get length of sense data portion of FCP response
 *
 * @v rsp                       FCP response
 * @ret sense_data_len          Sense data length
 */
static inline size_t fcp_rsp_sense_data_len ( struct fcp_rsp *rsp ) {
        return ( ( rsp->flags & FCP_RSP_SENSE_LEN_VALID ) ?
                 ntohl ( rsp->sense_len ) : 0 );
}

/** An FCP PRLI service parameter page */
struct fcp_prli_service_parameters {
        /** Flags */
        uint32_t flags;
} __attribute__ (( packed ));

/** Write FCP_XFER_RDY disabled */
#define FCP_PRLI_NO_WRITE_RDY 0x0001

/** Read FCP_XFER_RDY disabled */
#define FCP_PRLI_NO_READ_RDY 0x0002

/** Has target functionality */
#define FCP_PRLI_TARGET 0x0010

/** Has initiator functionality */
#define FCP_PRLI_INITIATOR 0x0020

/** Data overlay allowed */
#define FCP_PRLI_OVERLAY 0x0040

/** Confirm completion allowed */
#define FCP_PRLI_CONF 0x0080

/** Retransmission supported */
#define FCP_PRLI_RETRY 0x0100

/** Task retry identification */
#define FCP_PRLI_TASK_RETRY 0x0200

/** REC ELS supported */
#define FCP_PRLI_REC 0x0400

/** Enhanced discovery supported */
#define FCP_PRLI_ENH_DISC 0x0800

/** An FCP device description */
struct fcp_description {
        /** Fibre Channel WWN */
        struct fc_name wwn;
        /** SCSI LUN */
        struct scsi_lun lun;
};

#endif /* _IPXE_FCP_H */