blob: 80d9e486e33ede2472a5e77b8cf4aa66029beddc [file] [log] [blame]
Christoph Hellwigc4795fb2011-11-16 09:46:48 -05001#ifndef TARGET_CORE_BACKEND_H
2#define TARGET_CORE_BACKEND_H
3
Andy Grovera3541702015-05-19 14:44:41 -07004#define TRANSPORT_FLAG_PASSTHROUGH 1
Christoph Hellwigc4795fb2011-11-16 09:46:48 -05005
Nicholas Bellinger73112ed2014-11-27 13:59:20 -08006struct target_backend_cits {
7 struct config_item_type tb_dev_cit;
Nicholas Bellingerf79a8972014-11-27 14:51:14 -08008 struct config_item_type tb_dev_attrib_cit;
Nicholas Bellinger91e2e392014-11-27 14:57:01 -08009 struct config_item_type tb_dev_pr_cit;
Nicholas Bellingerf8d389c2014-11-27 15:01:12 -080010 struct config_item_type tb_dev_wwn_cit;
Nicholas Bellinger72aca572014-11-27 15:06:23 -080011 struct config_item_type tb_dev_alua_tg_pt_gps_cit;
Nicholas Bellingerd23ab572014-11-27 15:09:32 -080012 struct config_item_type tb_dev_stat_cit;
Nicholas Bellinger73112ed2014-11-27 13:59:20 -080013};
14
Christoph Hellwigc4795fb2011-11-16 09:46:48 -050015struct se_subsystem_api {
16 struct list_head sub_api_list;
17
18 char name[16];
Christoph Hellwig0fd97cc2012-10-08 00:03:19 -040019 char inquiry_prod[16];
20 char inquiry_rev[4];
Christoph Hellwigc4795fb2011-11-16 09:46:48 -050021 struct module *owner;
22
Andy Grovera3541702015-05-19 14:44:41 -070023 u8 transport_flags;
Christoph Hellwigc4795fb2011-11-16 09:46:48 -050024
Christoph Hellwigc4795fb2011-11-16 09:46:48 -050025 int (*attach_hba)(struct se_hba *, u32);
26 void (*detach_hba)(struct se_hba *);
27 int (*pmode_enable_hba)(struct se_hba *, unsigned long);
Christoph Hellwig0fd97cc2012-10-08 00:03:19 -040028
29 struct se_device *(*alloc_device)(struct se_hba *, const char *);
30 int (*configure_device)(struct se_device *);
31 void (*free_device)(struct se_device *device);
32
33 ssize_t (*set_configfs_dev_params)(struct se_device *,
34 const char *, ssize_t);
35 ssize_t (*show_configfs_dev_params)(struct se_device *, char *);
36
Paolo Bonzinid5829ea2012-09-05 17:09:15 +020037 void (*transport_complete)(struct se_cmd *cmd,
38 struct scatterlist *,
39 unsigned char *);
Christoph Hellwigd6e01752012-05-20 11:59:14 -040040
Christoph Hellwigde103c92012-11-06 12:24:09 -080041 sense_reason_t (*parse_cdb)(struct se_cmd *cmd);
Christoph Hellwigc4795fb2011-11-16 09:46:48 -050042 u32 (*get_device_type)(struct se_device *);
43 sector_t (*get_blocks)(struct se_device *);
Andy Grover7f7caf62013-11-11 08:59:17 -080044 sector_t (*get_alignment_offset_lbas)(struct se_device *);
45 /* lbppbe = logical blocks per physical block exponent. see SBC-3 */
46 unsigned int (*get_lbppbe)(struct se_device *);
47 unsigned int (*get_io_min)(struct se_device *);
48 unsigned int (*get_io_opt)(struct se_device *);
Christoph Hellwig5787cac2012-04-24 00:25:06 -040049 unsigned char *(*get_sense_buffer)(struct se_cmd *);
Nicholas Bellingerd0c8b252013-01-29 22:10:06 -080050 bool (*get_write_cache)(struct se_device *);
Nicholas Bellingerce65e5b2013-12-23 20:28:13 +000051 int (*init_prot)(struct se_device *);
52 int (*format_prot)(struct se_device *);
53 void (*free_prot)(struct se_device *);
Nicholas Bellinger73112ed2014-11-27 13:59:20 -080054
55 struct target_backend_cits tb_cits;
Christoph Hellwigc4795fb2011-11-16 09:46:48 -050056};
57
Christoph Hellwig9e999a62012-10-07 10:55:50 -040058struct sbc_ops {
Nicholas Bellingera82a9532013-08-19 23:57:30 -070059 sense_reason_t (*execute_rw)(struct se_cmd *cmd, struct scatterlist *,
60 u32, enum dma_data_direction);
Christoph Hellwigde103c92012-11-06 12:24:09 -080061 sense_reason_t (*execute_sync_cache)(struct se_cmd *cmd);
62 sense_reason_t (*execute_write_same)(struct se_cmd *cmd);
Nicholas Bellingercd063be2012-11-07 20:01:10 -080063 sense_reason_t (*execute_write_same_unmap)(struct se_cmd *cmd);
Christoph Hellwigde103c92012-11-06 12:24:09 -080064 sense_reason_t (*execute_unmap)(struct se_cmd *cmd);
Christoph Hellwig0c2ad7d2012-06-17 18:40:52 -040065};
66
Christoph Hellwigc4795fb2011-11-16 09:46:48 -050067int transport_subsystem_register(struct se_subsystem_api *);
68void transport_subsystem_release(struct se_subsystem_api *);
69
Christoph Hellwig6bb35e02012-04-23 11:35:33 -040070void target_complete_cmd(struct se_cmd *, u8);
Roland Dreier2426bd42014-06-10 11:07:47 -070071void target_complete_cmd_with_length(struct se_cmd *, u8, int);
Christoph Hellwigc4795fb2011-11-16 09:46:48 -050072
Christoph Hellwigde103c92012-11-06 12:24:09 -080073sense_reason_t spc_parse_cdb(struct se_cmd *cmd, unsigned int *size);
74sense_reason_t spc_emulate_report_luns(struct se_cmd *cmd);
Hannes Reinecke0dfa1c52012-12-17 09:53:35 +010075sense_reason_t spc_emulate_inquiry_std(struct se_cmd *, unsigned char *);
76sense_reason_t spc_emulate_evpd_83(struct se_cmd *, unsigned char *);
Christoph Hellwigd6e01752012-05-20 11:59:14 -040077
Christoph Hellwigde103c92012-11-06 12:24:09 -080078sense_reason_t sbc_parse_cdb(struct se_cmd *cmd, struct sbc_ops *ops);
Christoph Hellwig6f23ac82012-10-07 10:55:53 -040079u32 sbc_get_device_rev(struct se_device *dev);
80u32 sbc_get_device_type(struct se_device *dev);
Roland Dreier972b29c82013-02-22 09:52:57 -080081sector_t sbc_get_write_same_sectors(struct se_cmd *cmd);
Asias He86d71822013-02-25 14:03:46 +080082sense_reason_t sbc_execute_unmap(struct se_cmd *cmd,
83 sense_reason_t (*do_unmap_fn)(struct se_cmd *cmd, void *priv,
84 sector_t lba, sector_t nolb),
85 void *priv);
Nicholas Bellinger66a3d5b2014-04-02 14:19:09 -070086void sbc_dif_generate(struct se_cmd *);
Sagi Grimbergf75b6fa2015-04-19 20:27:19 +030087sense_reason_t sbc_dif_verify(struct se_cmd *, sector_t, unsigned int,
Nicholas Bellinger41861fa2014-01-07 22:44:57 +000088 unsigned int, struct scatterlist *, int);
Sagi Grimbergf75b6fa2015-04-19 20:27:19 +030089void sbc_dif_copy_prot(struct se_cmd *, unsigned int, bool,
90 struct scatterlist *, int);
Christoph Hellwigc4795fb2011-11-16 09:46:48 -050091void transport_set_vpd_proto_id(struct t10_vpd *, unsigned char *);
92int transport_set_vpd_assoc(struct t10_vpd *, unsigned char *);
93int transport_set_vpd_ident_type(struct t10_vpd *, unsigned char *);
94int transport_set_vpd_ident(struct t10_vpd *, unsigned char *);
95
96/* core helpers also used by command snooping in pscsi */
Andy Grover49493142012-01-16 16:57:08 -080097void *transport_kmap_data_sg(struct se_cmd *);
98void transport_kunmap_data_sg(struct se_cmd *);
Nicholas Bellingerc5ff8d62013-08-22 11:58:43 -070099/* core helpers also used by xcopy during internal command setup */
100int target_alloc_sgl(struct scatterlist **, unsigned int *, u32, bool);
101sense_reason_t transport_generic_map_mem_to_cmd(struct se_cmd *,
102 struct scatterlist *, u32, struct scatterlist *, u32);
Christoph Hellwigc4795fb2011-11-16 09:46:48 -0500103
Nicholas Bellinger29a05de2015-03-22 20:42:19 -0700104bool target_lun_is_rdonly(struct se_cmd *);
Jörn Engel4a5a75f2012-03-15 15:05:12 -0400105
Nicholas Bellinger73112ed2014-11-27 13:59:20 -0800106/* From target_core_configfs.c to setup default backend config_item_types */
107void target_core_setup_sub_cits(struct se_subsystem_api *);
108
Nicholas Bellingerd30cd122014-11-27 19:15:48 -0800109/* attribute helpers from target_core_device.c for backend drivers */
Christophe Vu-Brugier9bc65482015-03-19 14:30:13 +0100110bool se_dev_check_wce(struct se_device *);
Nicholas Bellingerd30cd122014-11-27 19:15:48 -0800111int se_dev_set_max_unmap_lba_count(struct se_device *, u32);
112int se_dev_set_max_unmap_block_desc_count(struct se_device *, u32);
113int se_dev_set_unmap_granularity(struct se_device *, u32);
114int se_dev_set_unmap_granularity_alignment(struct se_device *, u32);
115int se_dev_set_max_write_same_len(struct se_device *, u32);
116int se_dev_set_emulate_model_alias(struct se_device *, int);
117int se_dev_set_emulate_dpo(struct se_device *, int);
118int se_dev_set_emulate_fua_write(struct se_device *, int);
119int se_dev_set_emulate_fua_read(struct se_device *, int);
120int se_dev_set_emulate_write_cache(struct se_device *, int);
121int se_dev_set_emulate_ua_intlck_ctrl(struct se_device *, int);
122int se_dev_set_emulate_tas(struct se_device *, int);
123int se_dev_set_emulate_tpu(struct se_device *, int);
124int se_dev_set_emulate_tpws(struct se_device *, int);
125int se_dev_set_emulate_caw(struct se_device *, int);
126int se_dev_set_emulate_3pc(struct se_device *, int);
127int se_dev_set_pi_prot_type(struct se_device *, int);
128int se_dev_set_pi_prot_format(struct se_device *, int);
129int se_dev_set_enforce_pr_isids(struct se_device *, int);
130int se_dev_set_force_pr_aptpl(struct se_device *, int);
131int se_dev_set_is_nonrot(struct se_device *, int);
132int se_dev_set_emulate_rest_reord(struct se_device *dev, int);
133int se_dev_set_queue_depth(struct se_device *, u32);
134int se_dev_set_max_sectors(struct se_device *, u32);
Nicholas Bellingerd30cd122014-11-27 19:15:48 -0800135int se_dev_set_optimal_sectors(struct se_device *, u32);
136int se_dev_set_block_size(struct se_device *, u32);
Andy Grover7bfea53b2015-05-19 14:44:40 -0700137sense_reason_t passthrough_parse_cdb(struct se_cmd *cmd,
138 sense_reason_t (*exec_cmd)(struct se_cmd *cmd));
Nicholas Bellingerd30cd122014-11-27 19:15:48 -0800139
Christoph Hellwigc4795fb2011-11-16 09:46:48 -0500140#endif /* TARGET_CORE_BACKEND_H */