2 * Copyright (C) 2001 Jens Axboe <axboe@suse.de>
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License version 2 as
6 * published by the Free Software Foundation.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public Licens
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-
19 #include <linux/kernel.h>
20 #include <linux/errno.h>
21 #include <linux/string.h>
22 #include <linux/module.h>
23 #include <linux/blkdev.h>
24 #include <linux/capability.h>
25 #include <linux/completion.h>
26 #include <linux/cdrom.h>
27 #include <linux/ratelimit.h>
28 #include <linux/slab.h>
29 #include <linux/times.h>
30 #include <linux/uio.h>
31 #include <asm/uaccess.h>
33 #include <scsi/scsi.h>
34 #include <scsi/scsi_ioctl.h>
35 #include <scsi/scsi_cmnd.h>
37 struct blk_cmd_filter
{
38 unsigned long read_ok
[BLK_SCSI_CMD_PER_LONG
];
39 unsigned long write_ok
[BLK_SCSI_CMD_PER_LONG
];
42 static struct blk_cmd_filter blk_default_cmd_filter
;
44 /* Command group 3 is reserved and should never be used. */
45 const unsigned char scsi_command_size_tbl
[8] =
50 EXPORT_SYMBOL(scsi_command_size_tbl
);
54 static int sg_get_version(int __user
*p
)
56 static const int sg_version_num
= 30527;
57 return put_user(sg_version_num
, p
);
60 static int scsi_get_idlun(struct request_queue
*q
, int __user
*p
)
62 return put_user(0, p
);
65 static int scsi_get_bus(struct request_queue
*q
, int __user
*p
)
67 return put_user(0, p
);
70 static int sg_get_timeout(struct request_queue
*q
)
72 return jiffies_to_clock_t(q
->sg_timeout
);
75 static int sg_set_timeout(struct request_queue
*q
, int __user
*p
)
77 int timeout
, err
= get_user(timeout
, p
);
80 q
->sg_timeout
= clock_t_to_jiffies(timeout
);
85 static int max_sectors_bytes(struct request_queue
*q
)
87 unsigned int max_sectors
= queue_max_sectors(q
);
89 max_sectors
= min_t(unsigned int, max_sectors
, INT_MAX
>> 9);
91 return max_sectors
<< 9;
94 static int sg_get_reserved_size(struct request_queue
*q
, int __user
*p
)
96 int val
= min_t(int, q
->sg_reserved_size
, max_sectors_bytes(q
));
98 return put_user(val
, p
);
101 static int sg_set_reserved_size(struct request_queue
*q
, int __user
*p
)
103 int size
, err
= get_user(size
, p
);
111 q
->sg_reserved_size
= min(size
, max_sectors_bytes(q
));
116 * will always return that we are ATAPI even for a real SCSI drive, I'm not
117 * so sure this is worth doing anything about (why would you care??)
119 static int sg_emulated_host(struct request_queue
*q
, int __user
*p
)
121 return put_user(1, p
);
124 static void blk_set_cmd_filter_defaults(struct blk_cmd_filter
*filter
)
126 /* Basic read-only commands */
127 __set_bit(TEST_UNIT_READY
, filter
->read_ok
);
128 __set_bit(REQUEST_SENSE
, filter
->read_ok
);
129 __set_bit(READ_6
, filter
->read_ok
);
130 __set_bit(READ_10
, filter
->read_ok
);
131 __set_bit(READ_12
, filter
->read_ok
);
132 __set_bit(READ_16
, filter
->read_ok
);
133 __set_bit(READ_BUFFER
, filter
->read_ok
);
134 __set_bit(READ_DEFECT_DATA
, filter
->read_ok
);
135 __set_bit(READ_CAPACITY
, filter
->read_ok
);
136 __set_bit(READ_LONG
, filter
->read_ok
);
137 __set_bit(INQUIRY
, filter
->read_ok
);
138 __set_bit(MODE_SENSE
, filter
->read_ok
);
139 __set_bit(MODE_SENSE_10
, filter
->read_ok
);
140 __set_bit(LOG_SENSE
, filter
->read_ok
);
141 __set_bit(START_STOP
, filter
->read_ok
);
142 __set_bit(GPCMD_VERIFY_10
, filter
->read_ok
);
143 __set_bit(VERIFY_16
, filter
->read_ok
);
144 __set_bit(REPORT_LUNS
, filter
->read_ok
);
145 __set_bit(SERVICE_ACTION_IN
, filter
->read_ok
);
146 __set_bit(RECEIVE_DIAGNOSTIC
, filter
->read_ok
);
147 __set_bit(MAINTENANCE_IN
, filter
->read_ok
);
148 __set_bit(GPCMD_READ_BUFFER_CAPACITY
, filter
->read_ok
);
150 /* Audio CD commands */
151 __set_bit(GPCMD_PLAY_CD
, filter
->read_ok
);
152 __set_bit(GPCMD_PLAY_AUDIO_10
, filter
->read_ok
);
153 __set_bit(GPCMD_PLAY_AUDIO_MSF
, filter
->read_ok
);
154 __set_bit(GPCMD_PLAY_AUDIO_TI
, filter
->read_ok
);
155 __set_bit(GPCMD_PAUSE_RESUME
, filter
->read_ok
);
157 /* CD/DVD data reading */
158 __set_bit(GPCMD_READ_CD
, filter
->read_ok
);
159 __set_bit(GPCMD_READ_CD_MSF
, filter
->read_ok
);
160 __set_bit(GPCMD_READ_DISC_INFO
, filter
->read_ok
);
161 __set_bit(GPCMD_READ_CDVD_CAPACITY
, filter
->read_ok
);
162 __set_bit(GPCMD_READ_DVD_STRUCTURE
, filter
->read_ok
);
163 __set_bit(GPCMD_READ_HEADER
, filter
->read_ok
);
164 __set_bit(GPCMD_READ_TRACK_RZONE_INFO
, filter
->read_ok
);
165 __set_bit(GPCMD_READ_SUBCHANNEL
, filter
->read_ok
);
166 __set_bit(GPCMD_READ_TOC_PMA_ATIP
, filter
->read_ok
);
167 __set_bit(GPCMD_REPORT_KEY
, filter
->read_ok
);
168 __set_bit(GPCMD_SCAN
, filter
->read_ok
);
169 __set_bit(GPCMD_GET_CONFIGURATION
, filter
->read_ok
);
170 __set_bit(GPCMD_READ_FORMAT_CAPACITIES
, filter
->read_ok
);
171 __set_bit(GPCMD_GET_EVENT_STATUS_NOTIFICATION
, filter
->read_ok
);
172 __set_bit(GPCMD_GET_PERFORMANCE
, filter
->read_ok
);
173 __set_bit(GPCMD_SEEK
, filter
->read_ok
);
174 __set_bit(GPCMD_STOP_PLAY_SCAN
, filter
->read_ok
);
176 /* Basic writing commands */
177 __set_bit(WRITE_6
, filter
->write_ok
);
178 __set_bit(WRITE_10
, filter
->write_ok
);
179 __set_bit(WRITE_VERIFY
, filter
->write_ok
);
180 __set_bit(WRITE_12
, filter
->write_ok
);
181 __set_bit(WRITE_VERIFY_12
, filter
->write_ok
);
182 __set_bit(WRITE_16
, filter
->write_ok
);
183 __set_bit(WRITE_LONG
, filter
->write_ok
);
184 __set_bit(WRITE_LONG_2
, filter
->write_ok
);
185 __set_bit(ERASE
, filter
->write_ok
);
186 __set_bit(GPCMD_MODE_SELECT_10
, filter
->write_ok
);
187 __set_bit(MODE_SELECT
, filter
->write_ok
);
188 __set_bit(LOG_SELECT
, filter
->write_ok
);
189 __set_bit(GPCMD_BLANK
, filter
->write_ok
);
190 __set_bit(GPCMD_CLOSE_TRACK
, filter
->write_ok
);
191 __set_bit(GPCMD_FLUSH_CACHE
, filter
->write_ok
);
192 __set_bit(GPCMD_FORMAT_UNIT
, filter
->write_ok
);
193 __set_bit(GPCMD_REPAIR_RZONE_TRACK
, filter
->write_ok
);
194 __set_bit(GPCMD_RESERVE_RZONE_TRACK
, filter
->write_ok
);
195 __set_bit(GPCMD_SEND_DVD_STRUCTURE
, filter
->write_ok
);
196 __set_bit(GPCMD_SEND_EVENT
, filter
->write_ok
);
197 __set_bit(GPCMD_SEND_KEY
, filter
->write_ok
);
198 __set_bit(GPCMD_SEND_OPC
, filter
->write_ok
);
199 __set_bit(GPCMD_SEND_CUE_SHEET
, filter
->write_ok
);
200 __set_bit(GPCMD_SET_SPEED
, filter
->write_ok
);
201 __set_bit(GPCMD_PREVENT_ALLOW_MEDIUM_REMOVAL
, filter
->write_ok
);
202 __set_bit(GPCMD_LOAD_UNLOAD
, filter
->write_ok
);
203 __set_bit(GPCMD_SET_STREAMING
, filter
->write_ok
);
204 __set_bit(GPCMD_SET_READ_AHEAD
, filter
->write_ok
);
207 int blk_verify_command(unsigned char *cmd
, fmode_t has_write_perm
)
209 struct blk_cmd_filter
*filter
= &blk_default_cmd_filter
;
211 /* root can do any command. */
212 if (capable(CAP_SYS_RAWIO
))
215 /* Anybody who can open the device can do a read-safe command */
216 if (test_bit(cmd
[0], filter
->read_ok
))
219 /* Write-safe commands require a writable open */
220 if (test_bit(cmd
[0], filter
->write_ok
) && has_write_perm
)
225 EXPORT_SYMBOL(blk_verify_command
);
227 static int blk_fill_sghdr_rq(struct request_queue
*q
, struct request
*rq
,
228 struct sg_io_hdr
*hdr
, fmode_t mode
)
230 if (copy_from_user(rq
->cmd
, hdr
->cmdp
, hdr
->cmd_len
))
232 if (blk_verify_command(rq
->cmd
, mode
& FMODE_WRITE
))
236 * fill in request structure
238 rq
->cmd_len
= hdr
->cmd_len
;
240 rq
->timeout
= msecs_to_jiffies(hdr
->timeout
);
242 rq
->timeout
= q
->sg_timeout
;
244 rq
->timeout
= BLK_DEFAULT_SG_TIMEOUT
;
245 if (rq
->timeout
< BLK_MIN_SG_TIMEOUT
)
246 rq
->timeout
= BLK_MIN_SG_TIMEOUT
;
251 static int blk_complete_sghdr_rq(struct request
*rq
, struct sg_io_hdr
*hdr
,
257 * fill in all the output members
259 hdr
->status
= rq
->errors
& 0xff;
260 hdr
->masked_status
= status_byte(rq
->errors
);
261 hdr
->msg_status
= msg_byte(rq
->errors
);
262 hdr
->host_status
= host_byte(rq
->errors
);
263 hdr
->driver_status
= driver_byte(rq
->errors
);
265 if (hdr
->masked_status
|| hdr
->host_status
|| hdr
->driver_status
)
266 hdr
->info
|= SG_INFO_CHECK
;
267 hdr
->resid
= rq
->resid_len
;
270 if (rq
->sense_len
&& hdr
->sbp
) {
271 int len
= min((unsigned int) hdr
->mx_sb_len
, rq
->sense_len
);
273 if (!copy_to_user(hdr
->sbp
, rq
->sense
, len
))
274 hdr
->sb_len_wr
= len
;
279 r
= blk_rq_unmap_user(bio
);
286 static int sg_io(struct request_queue
*q
, struct gendisk
*bd_disk
,
287 struct sg_io_hdr
*hdr
, fmode_t mode
)
289 unsigned long start_time
;
294 char sense
[SCSI_SENSE_BUFFERSIZE
];
297 if (hdr
->interface_id
!= 'S')
300 if (hdr
->dxfer_len
> (queue_max_hw_sectors(q
) << 9))
304 switch (hdr
->dxfer_direction
) {
307 case SG_DXFER_TO_DEV
:
310 case SG_DXFER_TO_FROM_DEV
:
311 case SG_DXFER_FROM_DEV
:
314 if (hdr
->flags
& SG_FLAG_Q_AT_HEAD
)
318 rq
= blk_get_request(q
, writing
? WRITE
: READ
, GFP_KERNEL
);
321 blk_rq_set_block_pc(rq
);
323 if (hdr
->cmd_len
> BLK_MAX_CDB
) {
324 rq
->cmd
= kzalloc(hdr
->cmd_len
, GFP_KERNEL
);
326 goto out_put_request
;
330 if (blk_fill_sghdr_rq(q
, rq
, hdr
, mode
))
334 if (hdr
->iovec_count
) {
336 struct iovec
*iov
= NULL
;
338 ret
= rw_copy_check_uvector(-1, hdr
->dxferp
, hdr
->iovec_count
,
348 /* SG_IO howto says that the shorter of the two wins */
349 if (hdr
->dxfer_len
< iov_data_len
) {
350 hdr
->iovec_count
= iov_shorten(iov
,
353 iov_data_len
= hdr
->dxfer_len
;
356 ret
= blk_rq_map_user_iov(q
, rq
, NULL
, (struct sg_iovec
*) iov
,
358 iov_data_len
, GFP_KERNEL
);
360 } else if (hdr
->dxfer_len
)
361 ret
= blk_rq_map_user(q
, rq
, NULL
, hdr
->dxferp
, hdr
->dxfer_len
,
368 memset(sense
, 0, sizeof(sense
));
373 start_time
= jiffies
;
375 /* ignore return value. All information is passed back to caller
376 * (if he doesn't check that is his problem).
377 * N.B. a non-zero SCSI status is _not_ necessarily an error.
379 blk_execute_rq(q
, bd_disk
, rq
, at_head
);
381 hdr
->duration
= jiffies_to_msecs(jiffies
- start_time
);
383 ret
= blk_complete_sghdr_rq(rq
, hdr
, bio
);
386 if (rq
->cmd
!= rq
->__cmd
)
394 * sg_scsi_ioctl -- handle deprecated SCSI_IOCTL_SEND_COMMAND ioctl
395 * @file: file this ioctl operates on (optional)
396 * @q: request queue to send scsi commands down
397 * @disk: gendisk to operate on (option)
398 * @sic: userspace structure describing the command to perform
400 * Send down the scsi command described by @sic to the device below
401 * the request queue @q. If @file is non-NULL it's used to perform
402 * fine-grained permission checks that allow users to send down
403 * non-destructive SCSI commands. If the caller has a struct gendisk
404 * available it should be passed in as @disk to allow the low level
405 * driver to use the information contained in it. A non-NULL @disk
406 * is only allowed if the caller knows that the low level driver doesn't
407 * need it (e.g. in the scsi subsystem).
410 * - This interface is deprecated - users should use the SG_IO
411 * interface instead, as this is a more flexible approach to
412 * performing SCSI commands on a device.
413 * - The SCSI command length is determined by examining the 1st byte
414 * of the given command. There is no way to override this.
415 * - Data transfers are limited to PAGE_SIZE
416 * - The length (x + y) must be at least OMAX_SB_LEN bytes long to
417 * accommodate the sense buffer when an error occurs.
418 * The sense buffer is truncated to OMAX_SB_LEN (16) bytes so that
419 * old code will not be surprised.
420 * - If a Unix error occurs (e.g. ENOMEM) then the user will receive
421 * a negative return and the Unix error code in 'errno'.
422 * If the SCSI command succeeds then 0 is returned.
423 * Positive numbers returned are the compacted SCSI error codes (4
424 * bytes in one int) where the lowest byte is the SCSI status.
426 #define OMAX_SB_LEN 16 /* For backward compatibility */
427 int sg_scsi_ioctl(struct request_queue
*q
, struct gendisk
*disk
, fmode_t mode
,
428 struct scsi_ioctl_command __user
*sic
)
432 unsigned int in_len
, out_len
, bytes
, opcode
, cmdlen
;
433 char *buffer
= NULL
, sense
[SCSI_SENSE_BUFFERSIZE
];
439 * get in an out lengths, verify they don't exceed a page worth of data
441 if (get_user(in_len
, &sic
->inlen
))
443 if (get_user(out_len
, &sic
->outlen
))
445 if (in_len
> PAGE_SIZE
|| out_len
> PAGE_SIZE
)
447 if (get_user(opcode
, sic
->data
))
450 bytes
= max(in_len
, out_len
);
452 buffer
= kzalloc(bytes
, q
->bounce_gfp
| GFP_USER
| __GFP_NOWARN
);
458 rq
= blk_get_request(q
, in_len
? WRITE
: READ
, __GFP_WAIT
);
463 blk_rq_set_block_pc(rq
);
465 cmdlen
= COMMAND_SIZE(opcode
);
468 * get command and data to send to device, if any
471 rq
->cmd_len
= cmdlen
;
472 if (copy_from_user(rq
->cmd
, sic
->data
, cmdlen
))
475 if (in_len
&& copy_from_user(buffer
, sic
->data
+ cmdlen
, in_len
))
478 err
= blk_verify_command(rq
->cmd
, mode
& FMODE_WRITE
);
482 /* default. possible overriden later */
486 case SEND_DIAGNOSTIC
:
488 rq
->timeout
= FORMAT_UNIT_TIMEOUT
;
492 rq
->timeout
= START_STOP_TIMEOUT
;
495 rq
->timeout
= MOVE_MEDIUM_TIMEOUT
;
497 case READ_ELEMENT_STATUS
:
498 rq
->timeout
= READ_ELEMENT_STATUS_TIMEOUT
;
500 case READ_DEFECT_DATA
:
501 rq
->timeout
= READ_DEFECT_DATA_TIMEOUT
;
505 rq
->timeout
= BLK_DEFAULT_SG_TIMEOUT
;
509 if (bytes
&& blk_rq_map_kern(q
, rq
, buffer
, bytes
, __GFP_WAIT
)) {
510 err
= DRIVER_ERROR
<< 24;
514 memset(sense
, 0, sizeof(sense
));
518 blk_execute_rq(q
, disk
, rq
, 0);
520 err
= rq
->errors
& 0xff; /* only 8 bit SCSI status */
522 if (rq
->sense_len
&& rq
->sense
) {
523 bytes
= (OMAX_SB_LEN
> rq
->sense_len
) ?
524 rq
->sense_len
: OMAX_SB_LEN
;
525 if (copy_to_user(sic
->data
, rq
->sense
, bytes
))
529 if (copy_to_user(sic
->data
, buffer
, out_len
))
539 EXPORT_SYMBOL_GPL(sg_scsi_ioctl
);
541 /* Send basic block requests */
542 static int __blk_send_generic(struct request_queue
*q
, struct gendisk
*bd_disk
,
548 rq
= blk_get_request(q
, WRITE
, __GFP_WAIT
);
551 blk_rq_set_block_pc(rq
);
552 rq
->timeout
= BLK_DEFAULT_SG_TIMEOUT
;
556 err
= blk_execute_rq(q
, bd_disk
, rq
, 0);
562 static inline int blk_send_start_stop(struct request_queue
*q
,
563 struct gendisk
*bd_disk
, int data
)
565 return __blk_send_generic(q
, bd_disk
, GPCMD_START_STOP_UNIT
, data
);
568 int scsi_cmd_ioctl(struct request_queue
*q
, struct gendisk
*bd_disk
, fmode_t mode
,
569 unsigned int cmd
, void __user
*arg
)
580 case SG_GET_VERSION_NUM
:
581 err
= sg_get_version(arg
);
583 case SCSI_IOCTL_GET_IDLUN
:
584 err
= scsi_get_idlun(q
, arg
);
586 case SCSI_IOCTL_GET_BUS_NUMBER
:
587 err
= scsi_get_bus(q
, arg
);
590 err
= sg_set_timeout(q
, arg
);
593 err
= sg_get_timeout(q
);
595 case SG_GET_RESERVED_SIZE
:
596 err
= sg_get_reserved_size(q
, arg
);
598 case SG_SET_RESERVED_SIZE
:
599 err
= sg_set_reserved_size(q
, arg
);
601 case SG_EMULATED_HOST
:
602 err
= sg_emulated_host(q
, arg
);
605 struct sg_io_hdr hdr
;
608 if (copy_from_user(&hdr
, arg
, sizeof(hdr
)))
610 err
= sg_io(q
, bd_disk
, &hdr
, mode
);
614 if (copy_to_user(arg
, &hdr
, sizeof(hdr
)))
618 case CDROM_SEND_PACKET
: {
619 struct cdrom_generic_command cgc
;
620 struct sg_io_hdr hdr
;
623 if (copy_from_user(&cgc
, arg
, sizeof(cgc
)))
625 cgc
.timeout
= clock_t_to_jiffies(cgc
.timeout
);
626 memset(&hdr
, 0, sizeof(hdr
));
627 hdr
.interface_id
= 'S';
628 hdr
.cmd_len
= sizeof(cgc
.cmd
);
629 hdr
.dxfer_len
= cgc
.buflen
;
631 switch (cgc
.data_direction
) {
632 case CGC_DATA_UNKNOWN
:
633 hdr
.dxfer_direction
= SG_DXFER_UNKNOWN
;
636 hdr
.dxfer_direction
= SG_DXFER_TO_DEV
;
639 hdr
.dxfer_direction
= SG_DXFER_FROM_DEV
;
642 hdr
.dxfer_direction
= SG_DXFER_NONE
;
650 hdr
.dxferp
= cgc
.buffer
;
653 hdr
.mx_sb_len
= sizeof(struct request_sense
);
654 hdr
.timeout
= jiffies_to_msecs(cgc
.timeout
);
655 hdr
.cmdp
= ((struct cdrom_generic_command __user
*) arg
)->cmd
;
656 hdr
.cmd_len
= sizeof(cgc
.cmd
);
658 err
= sg_io(q
, bd_disk
, &hdr
, mode
);
666 cgc
.buflen
= hdr
.resid
;
667 if (copy_to_user(arg
, &cgc
, sizeof(cgc
)))
674 * old junk scsi send command ioctl
676 case SCSI_IOCTL_SEND_COMMAND
:
677 printk(KERN_WARNING
"program %s is using a deprecated SCSI ioctl, please convert it to SG_IO\n", current
->comm
);
682 err
= sg_scsi_ioctl(q
, bd_disk
, mode
, arg
);
685 err
= blk_send_start_stop(q
, bd_disk
, 0x03);
688 err
= blk_send_start_stop(q
, bd_disk
, 0x02);
696 EXPORT_SYMBOL(scsi_cmd_ioctl
);
698 int scsi_verify_blk_ioctl(struct block_device
*bd
, unsigned int cmd
)
700 if (bd
&& bd
== bd
->bd_contains
)
703 /* Actually none of these is particularly useful on a partition,
707 case SCSI_IOCTL_GET_IDLUN
:
708 case SCSI_IOCTL_GET_BUS_NUMBER
:
709 case SCSI_IOCTL_GET_PCI
:
710 case SCSI_IOCTL_PROBE_HOST
:
711 case SG_GET_VERSION_NUM
:
714 case SG_GET_RESERVED_SIZE
:
715 case SG_SET_RESERVED_SIZE
:
716 case SG_EMULATED_HOST
:
718 case CDROM_GET_CAPABILITY
:
719 /* Keep this until we remove the printk below. udev sends it
720 * and we do not want to spam dmesg about it. CD-ROMs do
721 * not have partitions, so we get here only for disks.
728 if (capable(CAP_SYS_RAWIO
))
731 /* In particular, rule out all resets and host-specific ioctls. */
732 printk_ratelimited(KERN_WARNING
733 "%s: sending ioctl %x to a partition!\n", current
->comm
, cmd
);
737 EXPORT_SYMBOL(scsi_verify_blk_ioctl
);
739 int scsi_cmd_blk_ioctl(struct block_device
*bd
, fmode_t mode
,
740 unsigned int cmd
, void __user
*arg
)
744 ret
= scsi_verify_blk_ioctl(bd
, cmd
);
748 return scsi_cmd_ioctl(bd
->bd_disk
->queue
, bd
->bd_disk
, mode
, cmd
, arg
);
750 EXPORT_SYMBOL(scsi_cmd_blk_ioctl
);
752 static int __init
blk_scsi_ioctl_init(void)
754 blk_set_cmd_filter_defaults(&blk_default_cmd_filter
);
757 fs_initcall(blk_scsi_ioctl_init
);