linux/drivers/target/sbp/sbp_target.h
<<
>>
Prefs
   1/* SPDX-License-Identifier: GPL-2.0 */
   2#ifndef _SBP_BASE_H
   3#define _SBP_BASE_H
   4
   5#include <linux/firewire.h>
   6#include <linux/spinlock.h>
   7#include <linux/types.h>
   8#include <linux/workqueue.h>
   9#include <target/target_core_base.h>
  10
  11#define SBP_VERSION  "v0.1"
  12#define SBP_NAMELEN 32
  13
  14#define SBP_ORB_FETCH_SIZE      8
  15
  16#define MANAGEMENT_AGENT_STATE_IDLE     0
  17#define MANAGEMENT_AGENT_STATE_BUSY     1
  18
  19#define ORB_NOTIFY(v)                   (((v) >> 31) & 0x01)
  20#define ORB_REQUEST_FORMAT(v)           (((v) >> 29) & 0x03)
  21
  22#define MANAGEMENT_ORB_FUNCTION(v)      (((v) >> 16) & 0x0f)
  23
  24#define MANAGEMENT_ORB_FUNCTION_LOGIN                   0x0
  25#define MANAGEMENT_ORB_FUNCTION_QUERY_LOGINS            0x1
  26#define MANAGEMENT_ORB_FUNCTION_RECONNECT               0x3
  27#define MANAGEMENT_ORB_FUNCTION_SET_PASSWORD            0x4
  28#define MANAGEMENT_ORB_FUNCTION_LOGOUT                  0x7
  29#define MANAGEMENT_ORB_FUNCTION_ABORT_TASK              0xb
  30#define MANAGEMENT_ORB_FUNCTION_ABORT_TASK_SET          0xc
  31#define MANAGEMENT_ORB_FUNCTION_LOGICAL_UNIT_RESET      0xe
  32#define MANAGEMENT_ORB_FUNCTION_TARGET_RESET            0xf
  33
  34#define LOGIN_ORB_EXCLUSIVE(v)          (((v) >> 28) &   0x01)
  35#define LOGIN_ORB_RESERVED(v)           (((v) >> 24) &   0x0f)
  36#define LOGIN_ORB_RECONNECT(v)          (((v) >> 20) &   0x0f)
  37#define LOGIN_ORB_LUN(v)                (((v) >>  0) & 0xffff)
  38#define LOGIN_ORB_PASSWORD_LENGTH(v)    (((v) >> 16) & 0xffff)
  39#define LOGIN_ORB_RESPONSE_LENGTH(v)    (((v) >>  0) & 0xffff)
  40
  41#define RECONNECT_ORB_LOGIN_ID(v)       (((v) >>  0) & 0xffff)
  42#define LOGOUT_ORB_LOGIN_ID(v)          (((v) >>  0) & 0xffff)
  43
  44#define CMDBLK_ORB_DIRECTION(v)         (((v) >> 27) &   0x01)
  45#define CMDBLK_ORB_SPEED(v)             (((v) >> 24) &   0x07)
  46#define CMDBLK_ORB_MAX_PAYLOAD(v)       (((v) >> 20) &   0x0f)
  47#define CMDBLK_ORB_PG_TBL_PRESENT(v)    (((v) >> 19) &   0x01)
  48#define CMDBLK_ORB_PG_SIZE(v)           (((v) >> 16) &   0x07)
  49#define CMDBLK_ORB_DATA_SIZE(v)         (((v) >>  0) & 0xffff)
  50
  51#define STATUS_BLOCK_SRC(v)             (((v) &   0x03) << 30)
  52#define STATUS_BLOCK_RESP(v)            (((v) &   0x03) << 28)
  53#define STATUS_BLOCK_DEAD(v)            (((v) ? 1 : 0)  << 27)
  54#define STATUS_BLOCK_LEN(v)             (((v) &   0x07) << 24)
  55#define STATUS_BLOCK_SBP_STATUS(v)      (((v) &   0xff) << 16)
  56#define STATUS_BLOCK_ORB_OFFSET_HIGH(v) (((v) & 0xffff) <<  0)
  57
  58#define STATUS_SRC_ORB_CONTINUING       0
  59#define STATUS_SRC_ORB_FINISHED         1
  60#define STATUS_SRC_UNSOLICITED          2
  61
  62#define STATUS_RESP_REQUEST_COMPLETE    0
  63#define STATUS_RESP_TRANSPORT_FAILURE   1
  64#define STATUS_RESP_ILLEGAL_REQUEST     2
  65#define STATUS_RESP_VENDOR_DEPENDENT    3
  66
  67#define SBP_STATUS_OK                   0
  68#define SBP_STATUS_REQ_TYPE_NOTSUPP     1
  69#define SBP_STATUS_SPEED_NOTSUPP        2
  70#define SBP_STATUS_PAGE_SIZE_NOTSUPP    3
  71#define SBP_STATUS_ACCESS_DENIED        4
  72#define SBP_STATUS_LUN_NOTSUPP          5
  73#define SBP_STATUS_PAYLOAD_TOO_SMALL    6
  74/* 7 is reserved */
  75#define SBP_STATUS_RESOURCES_UNAVAIL    8
  76#define SBP_STATUS_FUNCTION_REJECTED    9
  77#define SBP_STATUS_LOGIN_ID_UNKNOWN     10
  78#define SBP_STATUS_DUMMY_ORB_COMPLETE   11
  79#define SBP_STATUS_REQUEST_ABORTED      12
  80#define SBP_STATUS_UNSPECIFIED_ERROR    0xff
  81
  82#define AGENT_STATE_RESET       0
  83#define AGENT_STATE_ACTIVE      1
  84#define AGENT_STATE_SUSPENDED   2
  85#define AGENT_STATE_DEAD        3
  86
  87struct sbp2_pointer {
  88        __be32 high;
  89        __be32 low;
  90};
  91
  92struct sbp_command_block_orb {
  93        struct sbp2_pointer next_orb;
  94        struct sbp2_pointer data_descriptor;
  95        __be32 misc;
  96        u8 command_block[12];
  97};
  98
  99struct sbp_page_table_entry {
 100        __be16 segment_length;
 101        __be16 segment_base_hi;
 102        __be32 segment_base_lo;
 103};
 104
 105struct sbp_management_orb {
 106        struct sbp2_pointer ptr1;
 107        struct sbp2_pointer ptr2;
 108        __be32 misc;
 109        __be32 length;
 110        struct sbp2_pointer status_fifo;
 111};
 112
 113struct sbp_status_block {
 114        __be32 status;
 115        __be32 orb_low;
 116        u8 data[24];
 117};
 118
 119struct sbp_login_response_block {
 120        __be32 misc;
 121        struct sbp2_pointer command_block_agent;
 122        __be32 reconnect_hold;
 123};
 124
 125struct sbp_login_descriptor {
 126        struct sbp_session *sess;
 127        struct list_head link;
 128
 129        u32 login_lun;
 130
 131        u64 status_fifo_addr;
 132        int exclusive;
 133        u16 login_id;
 134
 135        struct sbp_target_agent *tgt_agt;
 136};
 137
 138struct sbp_session {
 139        spinlock_t lock;
 140        struct se_session *se_sess;
 141        struct list_head login_list;
 142        struct delayed_work maint_work;
 143
 144        u64 guid; /* login_owner_EUI_64 */
 145        int node_id; /* login_owner_ID */
 146
 147        struct fw_card *card;
 148        int generation;
 149        int speed;
 150
 151        int reconnect_hold;
 152        u64 reconnect_expires;
 153};
 154
 155struct sbp_tpg {
 156        /* Target portal group tag for TCM */
 157        u16 tport_tpgt;
 158        /* Pointer back to sbp_tport */
 159        struct sbp_tport *tport;
 160        /* Returned by sbp_make_tpg() */
 161        struct se_portal_group se_tpg;
 162};
 163
 164struct sbp_tport {
 165        /* Target Unit Identifier (EUI-64) */
 166        u64 guid;
 167        /* Target port name */
 168        char tport_name[SBP_NAMELEN];
 169        /* Returned by sbp_make_tport() */
 170        struct se_wwn tport_wwn;
 171
 172        struct sbp_tpg *tpg;
 173
 174        /* FireWire unit directory */
 175        struct fw_descriptor unit_directory;
 176
 177        /* SBP Management Agent */
 178        struct sbp_management_agent *mgt_agt;
 179
 180        /* Parameters */
 181        int enable;
 182        s32 directory_id;
 183        int mgt_orb_timeout;
 184        int max_reconnect_timeout;
 185        int max_logins_per_lun;
 186};
 187
 188static inline u64 sbp2_pointer_to_addr(const struct sbp2_pointer *ptr)
 189{
 190        return (u64)(be32_to_cpu(ptr->high) & 0x0000ffff) << 32 |
 191                (be32_to_cpu(ptr->low) & 0xfffffffc);
 192}
 193
 194static inline void addr_to_sbp2_pointer(u64 addr, struct sbp2_pointer *ptr)
 195{
 196        ptr->high = cpu_to_be32(addr >> 32);
 197        ptr->low = cpu_to_be32(addr);
 198}
 199
 200struct sbp_target_agent {
 201        spinlock_t lock;
 202        struct fw_address_handler handler;
 203        struct sbp_login_descriptor *login;
 204        int state;
 205        struct work_struct work;
 206        u64 orb_pointer;
 207        bool doorbell;
 208};
 209
 210struct sbp_target_request {
 211        struct sbp_login_descriptor *login;
 212        u64 orb_pointer;
 213        struct sbp_command_block_orb orb;
 214        struct sbp_status_block status;
 215        struct work_struct work;
 216
 217        struct se_cmd se_cmd;
 218        struct sbp_page_table_entry *pg_tbl;
 219        void *cmd_buf;
 220
 221        unsigned char sense_buf[TRANSPORT_SENSE_BUFFER];
 222};
 223
 224struct sbp_management_agent {
 225        spinlock_t lock;
 226        struct sbp_tport *tport;
 227        struct fw_address_handler handler;
 228        int state;
 229        struct work_struct work;
 230        u64 orb_offset;
 231        struct sbp_management_request *request;
 232};
 233
 234struct sbp_management_request {
 235        struct sbp_management_orb orb;
 236        struct sbp_status_block status;
 237        struct fw_card *card;
 238        int generation;
 239        int node_addr;
 240        int speed;
 241};
 242
 243#endif
 244