1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*******************************************************************************
3 * Filename: target_core_file.c
5 * This file contains the Storage Engine <-> FILEIO transport specific functions
7 * (c) Copyright 2005-2013 Datera, Inc.
9 * Nicholas A. Bellinger <nab@kernel.org>
11 ******************************************************************************/
13 #include <linux/string.h>
14 #include <linux/parser.h>
15 #include <linux/timer.h>
16 #include <linux/blkdev.h>
17 #include <linux/slab.h>
18 #include <linux/spinlock.h>
19 #include <linux/module.h>
20 #include <linux/vmalloc.h>
21 #include <linux/falloc.h>
22 #include <linux/uio.h>
23 #include <linux/scatterlist.h>
24 #include <scsi/scsi_proto.h>
25 #include <linux/unaligned.h>
27 #include <target/target_core_base.h>
28 #include <target/target_core_backend.h>
30 #include "target_core_file.h"
32 static inline struct fd_dev
*FD_DEV(struct se_device
*dev
)
34 return container_of(dev
, struct fd_dev
, dev
);
37 static int fd_attach_hba(struct se_hba
*hba
, u32 host_id
)
39 struct fd_host
*fd_host
;
41 fd_host
= kzalloc(sizeof(struct fd_host
), GFP_KERNEL
);
43 pr_err("Unable to allocate memory for struct fd_host\n");
47 fd_host
->fd_host_id
= host_id
;
49 hba
->hba_ptr
= fd_host
;
51 pr_debug("CORE_HBA[%d] - TCM FILEIO HBA Driver %s on Generic"
52 " Target Core Stack %s\n", hba
->hba_id
, FD_VERSION
,
54 pr_debug("CORE_HBA[%d] - Attached FILEIO HBA: %u to Generic\n",
55 hba
->hba_id
, fd_host
->fd_host_id
);
60 static void fd_detach_hba(struct se_hba
*hba
)
62 struct fd_host
*fd_host
= hba
->hba_ptr
;
64 pr_debug("CORE_HBA[%d] - Detached FILEIO HBA: %u from Generic"
65 " Target Core\n", hba
->hba_id
, fd_host
->fd_host_id
);
71 static struct se_device
*fd_alloc_device(struct se_hba
*hba
, const char *name
)
73 struct fd_dev
*fd_dev
;
74 struct fd_host
*fd_host
= hba
->hba_ptr
;
76 fd_dev
= kzalloc(sizeof(struct fd_dev
), GFP_KERNEL
);
78 pr_err("Unable to allocate memory for struct fd_dev\n");
82 fd_dev
->fd_host
= fd_host
;
84 pr_debug("FILEIO: Allocated fd_dev for %p\n", name
);
89 static bool fd_configure_unmap(struct se_device
*dev
)
91 struct file
*file
= FD_DEV(dev
)->fd_file
;
92 struct inode
*inode
= file
->f_mapping
->host
;
94 if (S_ISBLK(inode
->i_mode
))
95 return target_configure_unmap_from_queue(&dev
->dev_attrib
,
98 /* Limit UNMAP emulation to 8k Number of LBAs (NoLB) */
99 dev
->dev_attrib
.max_unmap_lba_count
= 0x2000;
100 /* Currently hardcoded to 1 in Linux/SCSI code. */
101 dev
->dev_attrib
.max_unmap_block_desc_count
= 1;
102 dev
->dev_attrib
.unmap_granularity
= 1;
103 dev
->dev_attrib
.unmap_granularity_alignment
= 0;
107 static int fd_configure_device(struct se_device
*dev
)
109 struct fd_dev
*fd_dev
= FD_DEV(dev
);
110 struct fd_host
*fd_host
= dev
->se_hba
->hba_ptr
;
112 struct inode
*inode
= NULL
;
113 int flags
, ret
= -EINVAL
;
115 if (!(fd_dev
->fbd_flags
& FBDF_HAS_PATH
)) {
116 pr_err("Missing fd_dev_name=\n");
121 * Use O_DSYNC by default instead of O_SYNC to forgo syncing
122 * of pure timestamp updates.
124 flags
= O_RDWR
| O_CREAT
| O_LARGEFILE
| O_DSYNC
;
127 * Optionally allow fd_buffered_io=1 to be enabled for people
128 * who want use the fs buffer cache as an WriteCache mechanism.
130 * This means that in event of a hard failure, there is a risk
131 * of silent data-loss if the SCSI client has *not* performed a
132 * forced unit access (FUA) write, or issued SYNCHRONIZE_CACHE
133 * to write-out the entire device cache.
135 if (fd_dev
->fbd_flags
& FDBD_HAS_BUFFERED_IO_WCE
) {
136 pr_debug("FILEIO: Disabling O_DSYNC, using buffered FILEIO\n");
140 file
= filp_open(fd_dev
->fd_dev_name
, flags
, 0600);
142 pr_err("filp_open(%s) failed\n", fd_dev
->fd_dev_name
);
146 fd_dev
->fd_file
= file
;
148 * If using a block backend with this struct file, we extract
149 * fd_dev->fd_[block,dev]_size from struct block_device.
151 * Otherwise, we use the passed fd_size= from configfs
153 inode
= file
->f_mapping
->host
;
154 if (S_ISBLK(inode
->i_mode
)) {
155 struct block_device
*bdev
= I_BDEV(inode
);
156 unsigned long long dev_size
;
158 fd_dev
->fd_block_size
= bdev_logical_block_size(bdev
);
160 * Determine the number of bytes from i_size_read() minus
161 * one (1) logical sector from underlying struct block_device
163 dev_size
= (i_size_read(file
->f_mapping
->host
) -
164 fd_dev
->fd_block_size
);
166 pr_debug("FILEIO: Using size: %llu bytes from struct"
167 " block_device blocks: %llu logical_block_size: %d\n",
168 dev_size
, div_u64(dev_size
, fd_dev
->fd_block_size
),
169 fd_dev
->fd_block_size
);
171 * Enable write same emulation for IBLOCK and use 0xFFFF as
172 * the smaller WRITE_SAME(10) only has a two-byte block count.
174 dev
->dev_attrib
.max_write_same_len
= 0xFFFF;
176 if (bdev_nonrot(bdev
))
177 dev
->dev_attrib
.is_nonrot
= 1;
179 if (!(fd_dev
->fbd_flags
& FBDF_HAS_SIZE
)) {
180 pr_err("FILEIO: Missing fd_dev_size="
181 " parameter, and no backing struct"
186 fd_dev
->fd_block_size
= FD_BLOCKSIZE
;
189 * Limit WRITE_SAME w/ UNMAP=0 emulation to 8k Number of LBAs (NoLB)
190 * based upon struct iovec limit for vfs_writev()
192 dev
->dev_attrib
.max_write_same_len
= 0x1000;
195 dev
->dev_attrib
.hw_block_size
= fd_dev
->fd_block_size
;
196 dev
->dev_attrib
.hw_max_sectors
= FD_MAX_BYTES
/ fd_dev
->fd_block_size
;
197 dev
->dev_attrib
.hw_queue_depth
= FD_MAX_DEVICE_QUEUE_DEPTH
;
199 if (fd_dev
->fbd_flags
& FDBD_HAS_BUFFERED_IO_WCE
) {
200 pr_debug("FILEIO: Forcing setting of emulate_write_cache=1"
201 " with FDBD_HAS_BUFFERED_IO_WCE\n");
202 dev
->dev_attrib
.emulate_write_cache
= 1;
205 fd_dev
->fd_dev_id
= fd_host
->fd_host_dev_id_count
++;
206 fd_dev
->fd_queue_depth
= dev
->queue_depth
;
208 pr_debug("CORE_FILE[%u] - Added TCM FILEIO Device ID: %u at %s,"
209 " %llu total bytes\n", fd_host
->fd_host_id
, fd_dev
->fd_dev_id
,
210 fd_dev
->fd_dev_name
, fd_dev
->fd_dev_size
);
214 if (fd_dev
->fd_file
) {
215 filp_close(fd_dev
->fd_file
, NULL
);
216 fd_dev
->fd_file
= NULL
;
221 static void fd_dev_call_rcu(struct rcu_head
*p
)
223 struct se_device
*dev
= container_of(p
, struct se_device
, rcu_head
);
224 struct fd_dev
*fd_dev
= FD_DEV(dev
);
229 static void fd_free_device(struct se_device
*dev
)
231 call_rcu(&dev
->rcu_head
, fd_dev_call_rcu
);
234 static void fd_destroy_device(struct se_device
*dev
)
236 struct fd_dev
*fd_dev
= FD_DEV(dev
);
238 if (fd_dev
->fd_file
) {
239 filp_close(fd_dev
->fd_file
, NULL
);
240 fd_dev
->fd_file
= NULL
;
244 struct target_core_file_cmd
{
248 struct bio_vec bvecs
[];
251 static void cmd_rw_aio_complete(struct kiocb
*iocb
, long ret
)
253 struct target_core_file_cmd
*cmd
;
255 cmd
= container_of(iocb
, struct target_core_file_cmd
, iocb
);
258 target_complete_cmd(cmd
->cmd
, SAM_STAT_CHECK_CONDITION
);
260 target_complete_cmd(cmd
->cmd
, SAM_STAT_GOOD
);
265 static sense_reason_t
266 fd_execute_rw_aio(struct se_cmd
*cmd
, struct scatterlist
*sgl
, u32 sgl_nents
,
267 enum dma_data_direction data_direction
)
269 int is_write
= !(data_direction
== DMA_FROM_DEVICE
);
270 struct se_device
*dev
= cmd
->se_dev
;
271 struct fd_dev
*fd_dev
= FD_DEV(dev
);
272 struct file
*file
= fd_dev
->fd_file
;
273 struct target_core_file_cmd
*aio_cmd
;
274 struct iov_iter iter
;
275 struct scatterlist
*sg
;
279 aio_cmd
= kmalloc(struct_size(aio_cmd
, bvecs
, sgl_nents
), GFP_KERNEL
);
281 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
283 for_each_sg(sgl
, sg
, sgl_nents
, i
) {
284 bvec_set_page(&aio_cmd
->bvecs
[i
], sg_page(sg
), sg
->length
,
289 iov_iter_bvec(&iter
, is_write
, aio_cmd
->bvecs
, sgl_nents
, len
);
293 aio_cmd
->iocb
.ki_pos
= cmd
->t_task_lba
* dev
->dev_attrib
.block_size
;
294 aio_cmd
->iocb
.ki_filp
= file
;
295 aio_cmd
->iocb
.ki_complete
= cmd_rw_aio_complete
;
296 aio_cmd
->iocb
.ki_flags
= IOCB_DIRECT
;
298 if (is_write
&& (cmd
->se_cmd_flags
& SCF_FUA
))
299 aio_cmd
->iocb
.ki_flags
|= IOCB_DSYNC
;
302 ret
= file
->f_op
->write_iter(&aio_cmd
->iocb
, &iter
);
304 ret
= file
->f_op
->read_iter(&aio_cmd
->iocb
, &iter
);
306 if (ret
!= -EIOCBQUEUED
)
307 cmd_rw_aio_complete(&aio_cmd
->iocb
, ret
);
312 static int fd_do_rw(struct se_cmd
*cmd
, struct file
*fd
,
313 u32 block_size
, struct scatterlist
*sgl
,
314 u32 sgl_nents
, u32 data_length
, int is_write
)
316 struct scatterlist
*sg
;
317 struct iov_iter iter
;
318 struct bio_vec
*bvec
;
320 loff_t pos
= (cmd
->t_task_lba
* block_size
);
323 bvec
= kcalloc(sgl_nents
, sizeof(struct bio_vec
), GFP_KERNEL
);
325 pr_err("Unable to allocate fd_do_readv iov[]\n");
329 for_each_sg(sgl
, sg
, sgl_nents
, i
) {
330 bvec_set_page(&bvec
[i
], sg_page(sg
), sg
->length
, sg
->offset
);
334 iov_iter_bvec(&iter
, is_write
, bvec
, sgl_nents
, len
);
336 ret
= vfs_iter_write(fd
, &iter
, &pos
, 0);
338 ret
= vfs_iter_read(fd
, &iter
, &pos
, 0);
341 if (ret
< 0 || ret
!= data_length
) {
342 pr_err("%s() write returned %d\n", __func__
, ret
);
348 * Return zeros and GOOD status even if the READ did not return
349 * the expected virt_size for struct file w/o a backing struct
352 if (S_ISBLK(file_inode(fd
)->i_mode
)) {
353 if (ret
< 0 || ret
!= data_length
) {
354 pr_err("%s() returned %d, expecting %u for "
355 "S_ISBLK\n", __func__
, ret
,
362 pr_err("%s() returned %d for non S_ISBLK\n",
364 } else if (ret
!= data_length
) {
367 * Probably some one truncate file under us.
368 * We must explicitly zero sg-pages to prevent
369 * expose uninizialized pages to userspace.
371 if (ret
< data_length
)
372 ret
+= iov_iter_zero(data_length
- ret
, &iter
);
382 static sense_reason_t
383 fd_execute_sync_cache(struct se_cmd
*cmd
)
385 struct se_device
*dev
= cmd
->se_dev
;
386 struct fd_dev
*fd_dev
= FD_DEV(dev
);
387 int immed
= (cmd
->t_task_cdb
[1] & 0x2);
392 * If the Immediate bit is set, queue up the GOOD response
393 * for this SYNCHRONIZE_CACHE op
396 target_complete_cmd(cmd
, SAM_STAT_GOOD
);
399 * Determine if we will be flushing the entire device.
401 if (cmd
->t_task_lba
== 0 && cmd
->data_length
== 0) {
405 start
= cmd
->t_task_lba
* dev
->dev_attrib
.block_size
;
406 if (cmd
->data_length
)
407 end
= start
+ cmd
->data_length
- 1;
412 ret
= vfs_fsync_range(fd_dev
->fd_file
, start
, end
, 1);
414 pr_err("FILEIO: vfs_fsync_range() failed: %d\n", ret
);
420 target_complete_cmd(cmd
, SAM_STAT_CHECK_CONDITION
);
422 target_complete_cmd(cmd
, SAM_STAT_GOOD
);
427 static sense_reason_t
428 fd_execute_write_same(struct se_cmd
*cmd
)
430 struct se_device
*se_dev
= cmd
->se_dev
;
431 struct fd_dev
*fd_dev
= FD_DEV(se_dev
);
432 loff_t pos
= cmd
->t_task_lba
* se_dev
->dev_attrib
.block_size
;
433 sector_t nolb
= sbc_get_write_same_sectors(cmd
);
434 struct iov_iter iter
;
435 struct bio_vec
*bvec
;
436 unsigned int len
= 0, i
;
440 pr_err("WRITE_SAME: Protection information with FILEIO"
441 " backends not supported\n");
442 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
445 if (!cmd
->t_data_nents
)
446 return TCM_INVALID_CDB_FIELD
;
448 if (cmd
->t_data_nents
> 1 ||
449 cmd
->t_data_sg
[0].length
!= cmd
->se_dev
->dev_attrib
.block_size
) {
450 pr_err("WRITE_SAME: Illegal SGL t_data_nents: %u length: %u"
453 cmd
->t_data_sg
[0].length
,
454 cmd
->se_dev
->dev_attrib
.block_size
);
455 return TCM_INVALID_CDB_FIELD
;
458 bvec
= kcalloc(nolb
, sizeof(struct bio_vec
), GFP_KERNEL
);
460 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
462 for (i
= 0; i
< nolb
; i
++) {
463 bvec_set_page(&bvec
[i
], sg_page(&cmd
->t_data_sg
[0]),
464 cmd
->t_data_sg
[0].length
,
465 cmd
->t_data_sg
[0].offset
);
466 len
+= se_dev
->dev_attrib
.block_size
;
469 iov_iter_bvec(&iter
, ITER_SOURCE
, bvec
, nolb
, len
);
470 ret
= vfs_iter_write(fd_dev
->fd_file
, &iter
, &pos
, 0);
473 if (ret
< 0 || ret
!= len
) {
474 pr_err("vfs_iter_write() returned %zd for write same\n", ret
);
475 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
478 target_complete_cmd(cmd
, SAM_STAT_GOOD
);
483 fd_do_prot_fill(struct se_device
*se_dev
, sector_t lba
, sector_t nolb
,
484 void *buf
, size_t bufsize
)
486 struct fd_dev
*fd_dev
= FD_DEV(se_dev
);
487 struct file
*prot_fd
= fd_dev
->fd_prot_file
;
488 sector_t prot_length
, prot
;
489 loff_t pos
= lba
* se_dev
->prot_length
;
492 pr_err("Unable to locate fd_dev->fd_prot_file\n");
496 prot_length
= nolb
* se_dev
->prot_length
;
498 memset(buf
, 0xff, bufsize
);
499 for (prot
= 0; prot
< prot_length
;) {
500 sector_t len
= min_t(sector_t
, bufsize
, prot_length
- prot
);
501 ssize_t ret
= kernel_write(prot_fd
, buf
, len
, &pos
);
504 pr_err("vfs_write to prot file failed: %zd\n", ret
);
505 return ret
< 0 ? ret
: -ENODEV
;
514 fd_do_prot_unmap(struct se_cmd
*cmd
, sector_t lba
, sector_t nolb
)
519 buf
= (void *)__get_free_page(GFP_KERNEL
);
521 pr_err("Unable to allocate FILEIO prot buf\n");
525 rc
= fd_do_prot_fill(cmd
->se_dev
, lba
, nolb
, buf
, PAGE_SIZE
);
527 free_page((unsigned long)buf
);
532 static sense_reason_t
533 fd_execute_unmap(struct se_cmd
*cmd
, sector_t lba
, sector_t nolb
)
535 struct file
*file
= FD_DEV(cmd
->se_dev
)->fd_file
;
536 struct inode
*inode
= file
->f_mapping
->host
;
543 if (cmd
->se_dev
->dev_attrib
.pi_prot_type
) {
544 ret
= fd_do_prot_unmap(cmd
, lba
, nolb
);
546 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
549 if (S_ISBLK(inode
->i_mode
)) {
550 /* The backend is block device, use discard */
551 struct block_device
*bdev
= I_BDEV(inode
);
552 struct se_device
*dev
= cmd
->se_dev
;
554 ret
= blkdev_issue_discard(bdev
,
555 target_to_linux_sector(dev
, lba
),
556 target_to_linux_sector(dev
, nolb
),
559 pr_warn("FILEIO: blkdev_issue_discard() failed: %d\n",
561 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
564 /* The backend is normal file, use fallocate */
565 struct se_device
*se_dev
= cmd
->se_dev
;
566 loff_t pos
= lba
* se_dev
->dev_attrib
.block_size
;
567 unsigned int len
= nolb
* se_dev
->dev_attrib
.block_size
;
568 int mode
= FALLOC_FL_PUNCH_HOLE
| FALLOC_FL_KEEP_SIZE
;
570 if (!file
->f_op
->fallocate
)
571 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
573 ret
= file
->f_op
->fallocate(file
, mode
, pos
, len
);
575 pr_warn("FILEIO: fallocate() failed: %d\n", ret
);
576 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
583 static sense_reason_t
584 fd_execute_rw_buffered(struct se_cmd
*cmd
, struct scatterlist
*sgl
, u32 sgl_nents
,
585 enum dma_data_direction data_direction
)
587 struct se_device
*dev
= cmd
->se_dev
;
588 struct fd_dev
*fd_dev
= FD_DEV(dev
);
589 struct file
*file
= fd_dev
->fd_file
;
590 struct file
*pfile
= fd_dev
->fd_prot_file
;
594 * Call vectorized fileio functions to map struct scatterlist
595 * physical memory addresses to struct iovec virtual memory.
597 if (data_direction
== DMA_FROM_DEVICE
) {
598 if (cmd
->prot_type
&& dev
->dev_attrib
.pi_prot_type
) {
599 ret
= fd_do_rw(cmd
, pfile
, dev
->prot_length
,
600 cmd
->t_prot_sg
, cmd
->t_prot_nents
,
601 cmd
->prot_length
, 0);
603 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
606 ret
= fd_do_rw(cmd
, file
, dev
->dev_attrib
.block_size
,
607 sgl
, sgl_nents
, cmd
->data_length
, 0);
609 if (ret
> 0 && cmd
->prot_type
&& dev
->dev_attrib
.pi_prot_type
&&
610 dev
->dev_attrib
.pi_prot_verify
) {
611 u32 sectors
= cmd
->data_length
>>
612 ilog2(dev
->dev_attrib
.block_size
);
614 rc
= sbc_dif_verify(cmd
, cmd
->t_task_lba
, sectors
,
615 0, cmd
->t_prot_sg
, 0);
620 if (cmd
->prot_type
&& dev
->dev_attrib
.pi_prot_type
&&
621 dev
->dev_attrib
.pi_prot_verify
) {
622 u32 sectors
= cmd
->data_length
>>
623 ilog2(dev
->dev_attrib
.block_size
);
625 rc
= sbc_dif_verify(cmd
, cmd
->t_task_lba
, sectors
,
626 0, cmd
->t_prot_sg
, 0);
631 ret
= fd_do_rw(cmd
, file
, dev
->dev_attrib
.block_size
,
632 sgl
, sgl_nents
, cmd
->data_length
, 1);
634 * Perform implicit vfs_fsync_range() for fd_do_writev() ops
635 * for SCSI WRITEs with Forced Unit Access (FUA) set.
636 * Allow this to happen independent of WCE=0 setting.
638 if (ret
> 0 && (cmd
->se_cmd_flags
& SCF_FUA
)) {
639 loff_t start
= cmd
->t_task_lba
*
640 dev
->dev_attrib
.block_size
;
643 if (cmd
->data_length
)
644 end
= start
+ cmd
->data_length
- 1;
648 vfs_fsync_range(fd_dev
->fd_file
, start
, end
, 1);
651 if (ret
> 0 && cmd
->prot_type
&& dev
->dev_attrib
.pi_prot_type
) {
652 ret
= fd_do_rw(cmd
, pfile
, dev
->prot_length
,
653 cmd
->t_prot_sg
, cmd
->t_prot_nents
,
654 cmd
->prot_length
, 1);
656 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
661 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
663 target_complete_cmd(cmd
, SAM_STAT_GOOD
);
667 static sense_reason_t
668 fd_execute_rw(struct se_cmd
*cmd
, struct scatterlist
*sgl
, u32 sgl_nents
,
669 enum dma_data_direction data_direction
)
671 struct se_device
*dev
= cmd
->se_dev
;
672 struct fd_dev
*fd_dev
= FD_DEV(dev
);
675 * We are currently limited by the number of iovecs (2048) per
676 * single vfs_[writev,readv] call.
678 if (cmd
->data_length
> FD_MAX_BYTES
) {
679 pr_err("FILEIO: Not able to process I/O of %u bytes due to"
680 "FD_MAX_BYTES: %u iovec count limitation\n",
681 cmd
->data_length
, FD_MAX_BYTES
);
682 return TCM_LOGICAL_UNIT_COMMUNICATION_FAILURE
;
685 if (fd_dev
->fbd_flags
& FDBD_HAS_ASYNC_IO
)
686 return fd_execute_rw_aio(cmd
, sgl
, sgl_nents
, data_direction
);
687 return fd_execute_rw_buffered(cmd
, sgl
, sgl_nents
, data_direction
);
691 Opt_fd_dev_name
, Opt_fd_dev_size
, Opt_fd_buffered_io
,
692 Opt_fd_async_io
, Opt_err
695 static match_table_t tokens
= {
696 {Opt_fd_dev_name
, "fd_dev_name=%s"},
697 {Opt_fd_dev_size
, "fd_dev_size=%s"},
698 {Opt_fd_buffered_io
, "fd_buffered_io=%d"},
699 {Opt_fd_async_io
, "fd_async_io=%d"},
703 static ssize_t
fd_set_configfs_dev_params(struct se_device
*dev
,
704 const char *page
, ssize_t count
)
706 struct fd_dev
*fd_dev
= FD_DEV(dev
);
707 char *orig
, *ptr
, *arg_p
, *opts
;
708 substring_t args
[MAX_OPT_ARGS
];
709 int ret
= 0, arg
, token
;
711 opts
= kstrdup(page
, GFP_KERNEL
);
717 while ((ptr
= strsep(&opts
, ",\n")) != NULL
) {
721 token
= match_token(ptr
, tokens
, args
);
723 case Opt_fd_dev_name
:
724 if (match_strlcpy(fd_dev
->fd_dev_name
, &args
[0],
725 FD_MAX_DEV_NAME
) == 0) {
729 pr_debug("FILEIO: Referencing Path: %s\n",
730 fd_dev
->fd_dev_name
);
731 fd_dev
->fbd_flags
|= FBDF_HAS_PATH
;
733 case Opt_fd_dev_size
:
734 arg_p
= match_strdup(&args
[0]);
739 ret
= kstrtoull(arg_p
, 0, &fd_dev
->fd_dev_size
);
742 pr_err("kstrtoull() failed for"
746 pr_debug("FILEIO: Referencing Size: %llu"
747 " bytes\n", fd_dev
->fd_dev_size
);
748 fd_dev
->fbd_flags
|= FBDF_HAS_SIZE
;
750 case Opt_fd_buffered_io
:
751 ret
= match_int(args
, &arg
);
755 pr_err("bogus fd_buffered_io=%d value\n", arg
);
760 pr_debug("FILEIO: Using buffered I/O"
761 " operations for struct fd_dev\n");
763 fd_dev
->fbd_flags
|= FDBD_HAS_BUFFERED_IO_WCE
;
765 case Opt_fd_async_io
:
766 ret
= match_int(args
, &arg
);
770 pr_err("bogus fd_async_io=%d value\n", arg
);
775 pr_debug("FILEIO: Using async I/O"
776 " operations for struct fd_dev\n");
778 fd_dev
->fbd_flags
|= FDBD_HAS_ASYNC_IO
;
787 return (!ret
) ? count
: ret
;
790 static ssize_t
fd_show_configfs_dev_params(struct se_device
*dev
, char *b
)
792 struct fd_dev
*fd_dev
= FD_DEV(dev
);
795 bl
= sprintf(b
+ bl
, "TCM FILEIO ID: %u", fd_dev
->fd_dev_id
);
796 bl
+= sprintf(b
+ bl
, " File: %s Size: %llu Mode: %s Async: %d\n",
797 fd_dev
->fd_dev_name
, fd_dev
->fd_dev_size
,
798 (fd_dev
->fbd_flags
& FDBD_HAS_BUFFERED_IO_WCE
) ?
799 "Buffered-WCE" : "O_DSYNC",
800 !!(fd_dev
->fbd_flags
& FDBD_HAS_ASYNC_IO
));
804 static sector_t
fd_get_blocks(struct se_device
*dev
)
806 struct fd_dev
*fd_dev
= FD_DEV(dev
);
807 struct file
*f
= fd_dev
->fd_file
;
808 struct inode
*i
= f
->f_mapping
->host
;
809 unsigned long long dev_size
;
811 * When using a file that references an underlying struct block_device,
812 * ensure dev_size is always based on the current inode size in order
813 * to handle underlying block_device resize operations.
815 if (S_ISBLK(i
->i_mode
))
816 dev_size
= i_size_read(i
);
818 dev_size
= fd_dev
->fd_dev_size
;
820 return div_u64(dev_size
- dev
->dev_attrib
.block_size
,
821 dev
->dev_attrib
.block_size
);
824 static int fd_init_prot(struct se_device
*dev
)
826 struct fd_dev
*fd_dev
= FD_DEV(dev
);
827 struct file
*prot_file
, *file
= fd_dev
->fd_file
;
829 int ret
, flags
= O_RDWR
| O_CREAT
| O_LARGEFILE
| O_DSYNC
;
830 char buf
[FD_MAX_DEV_PROT_NAME
];
833 pr_err("Unable to locate fd_dev->fd_file\n");
837 inode
= file
->f_mapping
->host
;
838 if (S_ISBLK(inode
->i_mode
)) {
839 pr_err("FILEIO Protection emulation only supported on"
844 if (fd_dev
->fbd_flags
& FDBD_HAS_BUFFERED_IO_WCE
)
847 snprintf(buf
, FD_MAX_DEV_PROT_NAME
, "%s.protection",
848 fd_dev
->fd_dev_name
);
850 prot_file
= filp_open(buf
, flags
, 0600);
851 if (IS_ERR(prot_file
)) {
852 pr_err("filp_open(%s) failed\n", buf
);
853 ret
= PTR_ERR(prot_file
);
856 fd_dev
->fd_prot_file
= prot_file
;
861 static int fd_format_prot(struct se_device
*dev
)
864 int unit_size
= FDBD_FORMAT_UNIT_SIZE
* dev
->dev_attrib
.block_size
;
867 if (!dev
->dev_attrib
.pi_prot_type
) {
868 pr_err("Unable to format_prot while pi_prot_type == 0\n");
872 buf
= vzalloc(unit_size
);
874 pr_err("Unable to allocate FILEIO prot buf\n");
878 pr_debug("Using FILEIO prot_length: %llu\n",
879 (unsigned long long)(dev
->transport
->get_blocks(dev
) + 1) *
882 ret
= fd_do_prot_fill(dev
, 0, dev
->transport
->get_blocks(dev
) + 1,
888 static void fd_free_prot(struct se_device
*dev
)
890 struct fd_dev
*fd_dev
= FD_DEV(dev
);
892 if (!fd_dev
->fd_prot_file
)
895 filp_close(fd_dev
->fd_prot_file
, NULL
);
896 fd_dev
->fd_prot_file
= NULL
;
899 static struct exec_cmd_ops fd_exec_cmd_ops
= {
900 .execute_rw
= fd_execute_rw
,
901 .execute_sync_cache
= fd_execute_sync_cache
,
902 .execute_write_same
= fd_execute_write_same
,
903 .execute_unmap
= fd_execute_unmap
,
906 static sense_reason_t
907 fd_parse_cdb(struct se_cmd
*cmd
)
909 return sbc_parse_cdb(cmd
, &fd_exec_cmd_ops
);
912 static const struct target_backend_ops fileio_ops
= {
914 .inquiry_prod
= "FILEIO",
915 .inquiry_rev
= FD_VERSION
,
916 .owner
= THIS_MODULE
,
917 .attach_hba
= fd_attach_hba
,
918 .detach_hba
= fd_detach_hba
,
919 .alloc_device
= fd_alloc_device
,
920 .configure_device
= fd_configure_device
,
921 .destroy_device
= fd_destroy_device
,
922 .free_device
= fd_free_device
,
923 .configure_unmap
= fd_configure_unmap
,
924 .parse_cdb
= fd_parse_cdb
,
925 .set_configfs_dev_params
= fd_set_configfs_dev_params
,
926 .show_configfs_dev_params
= fd_show_configfs_dev_params
,
927 .get_device_type
= sbc_get_device_type
,
928 .get_blocks
= fd_get_blocks
,
929 .init_prot
= fd_init_prot
,
930 .format_prot
= fd_format_prot
,
931 .free_prot
= fd_free_prot
,
932 .tb_dev_attrib_attrs
= sbc_attrib_attrs
,
935 static int __init
fileio_module_init(void)
937 return transport_backend_register(&fileio_ops
);
940 static void __exit
fileio_module_exit(void)
942 target_backend_unregister(&fileio_ops
);
945 MODULE_DESCRIPTION("TCM FILEIO subsystem plugin");
946 MODULE_AUTHOR("nab@Linux-iSCSI.org");
947 MODULE_LICENSE("GPL");
949 module_init(fileio_module_init
);
950 module_exit(fileio_module_exit
);