LXR linux/drivers/target/tcm_fc/tcm

   1/*
   2 * Copyright (c) 2010 Cisco Systems, Inc.
   3 *
   4 * This program is free software; you can redistribute it and/or modify it
   5 * under the terms and conditions of the GNU General Public License,
   6 * version 2, as published by the Free Software Foundation.
   7 *
   8 * This program is distributed in the hope it will be useful, but WITHOUT
   9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  10 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  11 * more details.
  12 *
  13 * You should have received a copy of the GNU General Public License along with
  14 * this program; if not, write to the Free Software Foundation, Inc.,
  15 * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
  16 */
  17#ifndef __TCM_FC_H__
  18#define __TCM_FC_H__
  19
  20#define FT_VERSION "0.4"
  21
  22#define FT_NAMELEN 32           /* length of ASCII WWPNs including pad */
  23#define FT_TPG_NAMELEN 32       /* max length of TPG name */
  24#define FT_LUN_NAMELEN 32       /* max length of LUN name */
  25
  26struct ft_transport_id {
  27        __u8    format;
  28        __u8    __resvd1[7];
  29        __u8    wwpn[8];
  30        __u8    __resvd2[8];
  31} __attribute__((__packed__));
  32
  33/*
  34 * Session (remote port).
  35 */
  36struct ft_sess {
  37        u32 port_id;                    /* for hash lookup use only */
  38        u32 params;
  39        u16 max_frame;                  /* maximum frame size */
  40        u64 port_name;                  /* port name for transport ID */
  41        struct ft_tport *tport;
  42        struct se_session *se_sess;
  43        struct hlist_node hash;         /* linkage in ft_sess_hash table */
  44        struct rcu_head rcu;
  45        struct kref kref;               /* ref for hash and outstanding I/Os */
  46};
  47
  48/*
  49 * Hash table of sessions per local port.
  50 * Hash lookup by remote port FC_ID.
  51 */
  52#define FT_SESS_HASH_BITS       6
  53#define FT_SESS_HASH_SIZE       (1 << FT_SESS_HASH_BITS)
  54
  55/*
  56 * Per local port data.
  57 * This is created only after a TPG exists that allows target function
  58 * for the local port.  If the TPG exists, this is allocated when
  59 * we're notified that the local port has been created, or when
  60 * the first PRLI provider callback is received.
  61 */
  62struct ft_tport {
  63        struct fc_lport *lport;
  64        struct ft_tpg *tpg;             /* NULL if TPG deleted before tport */
  65        u32     sess_count;             /* number of sessions in hash */
  66        struct rcu_head rcu;
  67        struct hlist_head hash[FT_SESS_HASH_SIZE];      /* list of sessions */
  68};
  69
  70/*
  71 * Node ID and authentication.
  72 */
  73struct ft_node_auth {
  74        u64     port_name;
  75        u64     node_name;
  76};
  77
  78/*
  79 * Node ACL for FC remote port session.
  80 */
  81struct ft_node_acl {
  82        struct ft_node_auth node_auth;
  83        struct se_node_acl se_node_acl;
  84};
  85
  86struct ft_lun {
  87        u32 index;
  88        char name[FT_LUN_NAMELEN];
  89};
  90
  91/*
  92 * Target portal group (local port).
  93 */
  94struct ft_tpg {
  95        u32 index;
  96        struct ft_lport_acl *lport_acl;
  97        struct ft_tport *tport;         /* active tport or NULL */
  98        struct list_head list;          /* linkage in ft_lport_acl tpg_list */
  99        struct list_head lun_list;      /* head of LUNs */
 100        struct se_portal_group se_tpg;
 101        struct workqueue_struct *workqueue;
 102};
 103
 104struct ft_lport_acl {
 105        u64 wwpn;
 106        char name[FT_NAMELEN];
 107        struct list_head list;
 108        struct list_head tpg_list;
 109        struct se_wwn fc_lport_wwn;
 110};
 111
 112/*
 113 * Commands
 114 */
 115struct ft_cmd {
 116        struct ft_sess *sess;           /* session held for cmd */
 117        struct fc_seq *seq;             /* sequence in exchange mgr */
 118        struct se_cmd se_cmd;           /* Local TCM I/O descriptor */
 119        struct fc_frame *req_frame;
 120        u32 write_data_len;             /* data received on writes */
 121        struct work_struct work;
 122        /* Local sense buffer */
 123        unsigned char ft_sense_buffer[TRANSPORT_SENSE_BUFFER];
 124        u32 was_ddp_setup:1;            /* Set only if ddp is setup */
 125        u32 aborted:1;                  /* Set if aborted by reset or timeout */
 126        struct scatterlist *sg;         /* Set only if DDP is setup */
 127        u32 sg_cnt;                     /* No. of item in scatterlist */
 128};
 129
 130extern struct list_head ft_lport_list;
 131extern struct mutex ft_lport_lock;
 132extern struct fc4_prov ft_prov;
 133extern struct target_fabric_configfs *ft_configfs;
 134extern unsigned int ft_debug_logging;
 135
 136/*
 137 * Fabric methods.
 138 */
 139
 140/*
 141 * Session ops.
 142 */
 143void ft_sess_put(struct ft_sess *);
 144int ft_sess_shutdown(struct se_session *);
 145void ft_sess_close(struct se_session *);
 146u32 ft_sess_get_index(struct se_session *);
 147u32 ft_sess_get_port_name(struct se_session *, unsigned char *, u32);
 148
 149void ft_lport_add(struct fc_lport *, void *);
 150void ft_lport_del(struct fc_lport *, void *);
 151int ft_lport_notify(struct notifier_block *, unsigned long, void *);
 152
 153/*
 154 * IO methods.
 155 */
 156int ft_check_stop_free(struct se_cmd *);
 157void ft_release_cmd(struct se_cmd *);
 158int ft_queue_status(struct se_cmd *);
 159int ft_queue_data_in(struct se_cmd *);
 160int ft_write_pending(struct se_cmd *);
 161int ft_write_pending_status(struct se_cmd *);
 162u32 ft_get_task_tag(struct se_cmd *);
 163int ft_get_cmd_state(struct se_cmd *);
 164int ft_queue_tm_resp(struct se_cmd *);
 165
 166/*
 167 * other internal functions.
 168 */
 169void ft_recv_req(struct ft_sess *, struct fc_frame *);
 170struct ft_tpg *ft_lport_find_tpg(struct fc_lport *);
 171struct ft_node_acl *ft_acl_get(struct ft_tpg *, struct fc_rport_priv *);
 172
 173void ft_recv_write_data(struct ft_cmd *, struct fc_frame *);
 174void ft_dump_cmd(struct ft_cmd *, const char *caller);
 175
 176ssize_t ft_format_wwn(char *, size_t, u64);
 177
 178/*
 179 * Underlying HW specific helper function
 180 */
 181void ft_invl_hw_context(struct ft_cmd *);
 182
 183#endif /* __TCM_FC_H__ */
 184