Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 1 | #ifndef TARGET_CORE_FABRIC_H |
| 2 | #define TARGET_CORE_FABRIC_H |
| 3 | |
| 4 | struct target_core_fabric_ops { |
Christoph Hellwig | 9ac8928 | 2015-04-08 20:01:35 +0200 | [diff] [blame] | 5 | struct module *module; |
| 6 | const char *name; |
Christoph Hellwig | 144bc4c | 2015-04-13 19:51:16 +0200 | [diff] [blame] | 7 | size_t node_acl_size; |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 8 | char *(*get_fabric_name)(void); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 9 | char *(*tpg_get_wwn)(struct se_portal_group *); |
| 10 | u16 (*tpg_get_tag)(struct se_portal_group *); |
| 11 | u32 (*tpg_get_default_depth)(struct se_portal_group *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 12 | int (*tpg_check_demo_mode)(struct se_portal_group *); |
| 13 | int (*tpg_check_demo_mode_cache)(struct se_portal_group *); |
| 14 | int (*tpg_check_demo_mode_write_protect)(struct se_portal_group *); |
| 15 | int (*tpg_check_prod_mode_write_protect)(struct se_portal_group *); |
| 16 | /* |
| 17 | * Optionally used by fabrics to allow demo-mode login, but not |
| 18 | * expose any TPG LUNs, and return 'not connected' in standard |
| 19 | * inquiry response |
| 20 | */ |
| 21 | int (*tpg_check_demo_mode_login_only)(struct se_portal_group *); |
Nicholas Bellinger | 38b57f8 | 2015-02-27 22:05:21 -0800 | [diff] [blame] | 22 | /* |
| 23 | * Optionally used as a configfs tunable to determine when |
| 24 | * target-core should signal the PROTECT=1 feature bit for |
| 25 | * backends that don't support T10-PI, so that either fabric |
| 26 | * HW offload or target-core emulation performs the associated |
| 27 | * WRITE_STRIP and READ_INSERT operations. |
| 28 | */ |
| 29 | int (*tpg_check_prot_fabric_only)(struct se_portal_group *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 30 | u32 (*tpg_get_inst_index)(struct se_portal_group *); |
| 31 | /* |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 32 | * Optional to release struct se_cmd and fabric dependent allocated |
| 33 | * I/O descriptor in transport_cmd_check_stop(). |
| 34 | * |
| 35 | * Returning 1 will signal a descriptor has been released. |
| 36 | * Returning 0 will signal a descriptor has not been released. |
| 37 | */ |
| 38 | int (*check_stop_free)(struct se_cmd *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 39 | void (*release_cmd)(struct se_cmd *); |
| 40 | /* |
| 41 | * Called with spin_lock_bh(struct se_portal_group->session_lock held. |
| 42 | */ |
| 43 | int (*shutdown_session)(struct se_session *); |
| 44 | void (*close_session)(struct se_session *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 45 | u32 (*sess_get_index)(struct se_session *); |
| 46 | /* |
| 47 | * Used only for SCSI fabrics that contain multi-value TransportIDs |
| 48 | * (like iSCSI). All other SCSI fabrics should set this to NULL. |
| 49 | */ |
| 50 | u32 (*sess_get_initiator_sid)(struct se_session *, |
| 51 | unsigned char *, u32); |
| 52 | int (*write_pending)(struct se_cmd *); |
| 53 | int (*write_pending_status)(struct se_cmd *); |
| 54 | void (*set_default_node_attributes)(struct se_node_acl *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 55 | int (*get_cmd_state)(struct se_cmd *); |
| 56 | int (*queue_data_in)(struct se_cmd *); |
| 57 | int (*queue_status)(struct se_cmd *); |
Joern Engel | b79fafa | 2013-07-03 11:22:17 -0400 | [diff] [blame] | 58 | void (*queue_tm_rsp)(struct se_cmd *); |
Nicholas Bellinger | 131e6ab | 2014-03-22 14:55:56 -0700 | [diff] [blame] | 59 | void (*aborted_task)(struct se_cmd *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 60 | /* |
| 61 | * fabric module calls for target_core_fabric_configfs.c |
| 62 | */ |
| 63 | struct se_wwn *(*fabric_make_wwn)(struct target_fabric_configfs *, |
| 64 | struct config_group *, const char *); |
| 65 | void (*fabric_drop_wwn)(struct se_wwn *); |
| 66 | struct se_portal_group *(*fabric_make_tpg)(struct se_wwn *, |
| 67 | struct config_group *, const char *); |
| 68 | void (*fabric_drop_tpg)(struct se_portal_group *); |
| 69 | int (*fabric_post_link)(struct se_portal_group *, |
| 70 | struct se_lun *); |
| 71 | void (*fabric_pre_unlink)(struct se_portal_group *, |
| 72 | struct se_lun *); |
| 73 | struct se_tpg_np *(*fabric_make_np)(struct se_portal_group *, |
| 74 | struct config_group *, const char *); |
| 75 | void (*fabric_drop_np)(struct se_tpg_np *); |
Christoph Hellwig | c7d6a80 | 2015-04-13 19:51:14 +0200 | [diff] [blame] | 76 | int (*fabric_init_nodeacl)(struct se_node_acl *, const char *); |
| 77 | void (*fabric_cleanup_nodeacl)(struct se_node_acl *); |
Christoph Hellwig | 9ac8928 | 2015-04-08 20:01:35 +0200 | [diff] [blame] | 78 | |
| 79 | struct configfs_attribute **tfc_discovery_attrs; |
| 80 | struct configfs_attribute **tfc_wwn_attrs; |
| 81 | struct configfs_attribute **tfc_tpg_base_attrs; |
| 82 | struct configfs_attribute **tfc_tpg_np_base_attrs; |
| 83 | struct configfs_attribute **tfc_tpg_attrib_attrs; |
| 84 | struct configfs_attribute **tfc_tpg_auth_attrs; |
| 85 | struct configfs_attribute **tfc_tpg_param_attrs; |
| 86 | struct configfs_attribute **tfc_tpg_nacl_base_attrs; |
| 87 | struct configfs_attribute **tfc_tpg_nacl_attrib_attrs; |
| 88 | struct configfs_attribute **tfc_tpg_nacl_auth_attrs; |
| 89 | struct configfs_attribute **tfc_tpg_nacl_param_attrs; |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 90 | }; |
| 91 | |
Christoph Hellwig | 9ac8928 | 2015-04-08 20:01:35 +0200 | [diff] [blame] | 92 | int target_register_template(const struct target_core_fabric_ops *fo); |
| 93 | void target_unregister_template(const struct target_core_fabric_ops *fo); |
| 94 | |
Christoph Hellwig | d588cf8 | 2015-05-03 08:50:52 +0200 | [diff] [blame] | 95 | int target_depend_item(struct config_item *item); |
| 96 | void target_undepend_item(struct config_item *item); |
| 97 | |
Nicholas Bellinger | e70beee | 2014-04-02 12:52:38 -0700 | [diff] [blame] | 98 | struct se_session *transport_init_session(enum target_prot_op); |
Nicholas Bellinger | c0add7f | 2013-06-07 17:38:58 -0700 | [diff] [blame] | 99 | int transport_alloc_session_tags(struct se_session *, unsigned int, |
| 100 | unsigned int); |
Nicholas Bellinger | e70beee | 2014-04-02 12:52:38 -0700 | [diff] [blame] | 101 | struct se_session *transport_init_session_tags(unsigned int, unsigned int, |
| 102 | enum target_prot_op); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 103 | void __transport_register_session(struct se_portal_group *, |
| 104 | struct se_node_acl *, struct se_session *, void *); |
| 105 | void transport_register_session(struct se_portal_group *, |
| 106 | struct se_node_acl *, struct se_session *, void *); |
Nicholas Bellinger | 41ac82b | 2012-02-26 22:22:10 -0800 | [diff] [blame] | 107 | void target_get_session(struct se_session *); |
Jörn Engel | 33933a0 | 2012-05-11 10:35:08 -0400 | [diff] [blame] | 108 | void target_put_session(struct se_session *); |
Nicholas Bellinger | f8e471f | 2015-03-06 20:34:32 -0800 | [diff] [blame] | 109 | ssize_t target_show_dynamic_sessions(struct se_portal_group *, char *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 110 | void transport_free_session(struct se_session *); |
Nicholas Bellinger | afb999f | 2012-03-08 23:45:02 -0800 | [diff] [blame] | 111 | void target_put_nacl(struct se_node_acl *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 112 | void transport_deregister_session_configfs(struct se_session *); |
| 113 | void transport_deregister_session(struct se_session *); |
| 114 | |
| 115 | |
Christoph Hellwig | 9ac8928 | 2015-04-08 20:01:35 +0200 | [diff] [blame] | 116 | void transport_init_se_cmd(struct se_cmd *, |
| 117 | const struct target_core_fabric_ops *, |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 118 | struct se_session *, u32, int, int, unsigned char *); |
Christoph Hellwig | de103c9 | 2012-11-06 12:24:09 -0800 | [diff] [blame] | 119 | sense_reason_t transport_lookup_cmd_lun(struct se_cmd *, u32); |
| 120 | sense_reason_t target_setup_cmd_from_cdb(struct se_cmd *, unsigned char *); |
Nicholas Bellinger | a026757 | 2012-10-01 17:23:22 -0700 | [diff] [blame] | 121 | int target_submit_cmd_map_sgls(struct se_cmd *, struct se_session *, |
| 122 | unsigned char *, unsigned char *, u32, u32, int, int, int, |
Nicholas Bellinger | def2b33 | 2013-12-23 20:38:30 +0000 | [diff] [blame] | 123 | struct scatterlist *, u32, struct scatterlist *, u32, |
| 124 | struct scatterlist *, u32); |
Roland Dreier | d6dfc86 | 2012-07-16 11:04:39 -0700 | [diff] [blame] | 125 | int target_submit_cmd(struct se_cmd *, struct se_session *, unsigned char *, |
Nicholas Bellinger | a636078 | 2011-11-18 20:36:22 -0800 | [diff] [blame] | 126 | unsigned char *, u32, u32, int, int, int); |
Nicholas Bellinger | c7042ca | 2012-02-25 01:40:24 -0800 | [diff] [blame] | 127 | int target_submit_tmr(struct se_cmd *se_cmd, struct se_session *se_sess, |
Andy Grover | ea98d7f | 2012-01-19 13:39:21 -0800 | [diff] [blame] | 128 | unsigned char *sense, u32 unpacked_lun, |
Nicholas Bellinger | c0974f8 | 2012-02-25 05:10:04 -0800 | [diff] [blame] | 129 | void *fabric_tmr_ptr, unsigned char tm_type, |
| 130 | gfp_t, unsigned int, int); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 131 | int transport_handle_cdb_direct(struct se_cmd *); |
Christoph Hellwig | de103c9 | 2012-11-06 12:24:09 -0800 | [diff] [blame] | 132 | sense_reason_t transport_generic_new_cmd(struct se_cmd *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 133 | |
Christoph Hellwig | 70baf0a | 2012-07-08 15:58:39 -0400 | [diff] [blame] | 134 | void target_execute_cmd(struct se_cmd *cmd); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 135 | |
Nicholas Bellinger | d5ddad416 | 2013-05-31 00:46:11 -0700 | [diff] [blame] | 136 | int transport_generic_free_cmd(struct se_cmd *, int); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 137 | |
| 138 | bool transport_wait_for_tasks(struct se_cmd *); |
| 139 | int transport_check_aborted_status(struct se_cmd *, int); |
Christoph Hellwig | de103c9 | 2012-11-06 12:24:09 -0800 | [diff] [blame] | 140 | int transport_send_check_condition_and_sense(struct se_cmd *, |
| 141 | sense_reason_t, int); |
Bart Van Assche | afc1660 | 2015-04-27 13:52:36 +0200 | [diff] [blame] | 142 | int target_get_sess_cmd(struct se_cmd *, bool); |
| 143 | int target_put_sess_cmd(struct se_cmd *); |
Roland Dreier | 1c7b13f | 2012-07-16 11:04:42 -0700 | [diff] [blame] | 144 | void target_sess_cmd_list_set_waiting(struct se_session *); |
Joern Engel | be646c2d | 2013-05-15 00:44:07 -0700 | [diff] [blame] | 145 | void target_wait_for_sess_cmds(struct se_session *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 146 | |
| 147 | int core_alua_check_nonop_delay(struct se_cmd *); |
| 148 | |
Andy Grover | c8e31f2 | 2012-01-19 13:39:17 -0800 | [diff] [blame] | 149 | int core_tmr_alloc_req(struct se_cmd *, void *, u8, gfp_t); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 150 | void core_tmr_release_req(struct se_tmr_req *); |
| 151 | int transport_generic_handle_tmr(struct se_cmd *); |
Christoph Hellwig | de103c9 | 2012-11-06 12:24:09 -0800 | [diff] [blame] | 152 | void transport_generic_request_failure(struct se_cmd *, sense_reason_t); |
Nicholas Bellinger | 76dde50 | 2013-08-21 16:04:10 -0700 | [diff] [blame] | 153 | void __target_execute_cmd(struct se_cmd *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 154 | int transport_lookup_tmr_lun(struct se_cmd *, u32); |
| 155 | |
Thomas Glanzmann | b3fde03 | 2013-10-07 23:13:02 +0200 | [diff] [blame] | 156 | struct se_node_acl *core_tpg_get_initiator_node_acl(struct se_portal_group *tpg, |
| 157 | unsigned char *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 158 | struct se_node_acl *core_tpg_check_initiator_node_acl(struct se_portal_group *, |
| 159 | unsigned char *); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 160 | int core_tpg_set_initiator_node_queue_depth(struct se_portal_group *, |
| 161 | unsigned char *, u32, int); |
Andy Grover | 79e62fc | 2012-12-11 16:30:53 -0800 | [diff] [blame] | 162 | int core_tpg_set_initiator_node_tag(struct se_portal_group *, |
| 163 | struct se_node_acl *, const char *); |
Nicholas Bellinger | bc0c94b | 2015-05-20 21:48:03 -0700 | [diff] [blame^] | 164 | int core_tpg_register(struct se_wwn *, struct se_portal_group *, int); |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 165 | int core_tpg_deregister(struct se_portal_group *); |
| 166 | |
Nicholas Bellinger | b3faa2e | 2013-08-21 14:54:54 -0700 | [diff] [blame] | 167 | /* |
| 168 | * The LIO target core uses DMA_TO_DEVICE to mean that data is going |
| 169 | * to the target (eg handling a WRITE) and DMA_FROM_DEVICE to mean |
| 170 | * that data is coming from the target (eg handling a READ). However, |
| 171 | * this is just the opposite of what we have to tell the DMA mapping |
| 172 | * layer -- eg when handling a READ, the HBA will have to DMA the data |
| 173 | * out of memory so it can send it to the initiator, which means we |
| 174 | * need to use DMA_TO_DEVICE when we map the data. |
| 175 | */ |
| 176 | static inline enum dma_data_direction |
| 177 | target_reverse_dma_direction(struct se_cmd *se_cmd) |
| 178 | { |
| 179 | if (se_cmd->se_cmd_flags & SCF_BIDI) |
| 180 | return DMA_BIDIRECTIONAL; |
| 181 | |
| 182 | switch (se_cmd->data_direction) { |
| 183 | case DMA_TO_DEVICE: |
| 184 | return DMA_FROM_DEVICE; |
| 185 | case DMA_FROM_DEVICE: |
| 186 | return DMA_TO_DEVICE; |
| 187 | case DMA_NONE: |
| 188 | default: |
| 189 | return DMA_NONE; |
| 190 | } |
| 191 | } |
| 192 | |
Christoph Hellwig | c4795fb | 2011-11-16 09:46:48 -0500 | [diff] [blame] | 193 | #endif /* TARGET_CORE_FABRICH */ |