scsi: sd: Fix function descriptions
Fix argument names and description of function documentation comments. No functional change is introduced by this patch. [mkp: verbify] Signed-off-by: Damien Le Moal <damien.lemoal@wdc.com> Reviewed-by: Christoph Hellwig <hch@lst.de> Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
parent
b1391a5bf8
commit
7529fbb008
|
@ -705,11 +705,10 @@ static void sd_config_discard(struct scsi_disk *sdkp, unsigned int mode)
|
|||
|
||||
/**
|
||||
* sd_setup_discard_cmnd - unmap blocks on thinly provisioned device
|
||||
* @sdp: scsi device to operate on
|
||||
* @rq: Request to prepare
|
||||
* @cmd: command to prepare
|
||||
*
|
||||
* Will issue either UNMAP or WRITE SAME(16) depending on preference
|
||||
* indicated by target device.
|
||||
* Will set up either UNMAP, WRITE SAME(16) or WRITE SAME(10) depending
|
||||
* on the provisioning mode of the target device.
|
||||
**/
|
||||
static int sd_setup_discard_cmnd(struct scsi_cmnd *cmd)
|
||||
{
|
||||
|
@ -827,8 +826,8 @@ out:
|
|||
* sd_setup_write_same_cmnd - write the same data to multiple blocks
|
||||
* @cmd: command to prepare
|
||||
*
|
||||
* Will issue either WRITE SAME(10) or WRITE SAME(16) depending on
|
||||
* preference indicated by target device.
|
||||
* Will set up either WRITE SAME(10) or WRITE SAME(16) depending on
|
||||
* the preference indicated by the target device.
|
||||
**/
|
||||
static int sd_setup_write_same_cmnd(struct scsi_cmnd *cmd)
|
||||
{
|
||||
|
@ -1190,8 +1189,8 @@ static void sd_uninit_command(struct scsi_cmnd *SCpnt)
|
|||
|
||||
/**
|
||||
* sd_open - open a scsi disk device
|
||||
* @inode: only i_rdev member may be used
|
||||
* @filp: only f_mode and f_flags may be used
|
||||
* @bdev: Block device of the scsi disk to open
|
||||
* @mode: FMODE_* mask
|
||||
*
|
||||
* Returns 0 if successful. Returns a negated errno value in case
|
||||
* of error.
|
||||
|
@ -1267,8 +1266,8 @@ error_out:
|
|||
/**
|
||||
* sd_release - invoked when the (last) close(2) is called on this
|
||||
* scsi disk.
|
||||
* @inode: only i_rdev member may be used
|
||||
* @filp: only f_mode and f_flags may be used
|
||||
* @disk: disk to release
|
||||
* @mode: FMODE_* mask
|
||||
*
|
||||
* Returns 0.
|
||||
*
|
||||
|
@ -1324,8 +1323,8 @@ static int sd_getgeo(struct block_device *bdev, struct hd_geometry *geo)
|
|||
|
||||
/**
|
||||
* sd_ioctl - process an ioctl
|
||||
* @inode: only i_rdev/i_bdev members may be used
|
||||
* @filp: only f_mode and f_flags may be used
|
||||
* @bdev: target block device
|
||||
* @mode: FMODE_* mask
|
||||
* @cmd: ioctl command number
|
||||
* @arg: this is third argument given to ioctl(2) system call.
|
||||
* Often contains a pointer.
|
||||
|
@ -2713,7 +2712,7 @@ static void sd_read_app_tag_own(struct scsi_disk *sdkp, unsigned char *buffer)
|
|||
|
||||
/**
|
||||
* sd_read_block_limits - Query disk device for preferred I/O sizes.
|
||||
* @disk: disk to query
|
||||
* @sdkp: disk to query
|
||||
*/
|
||||
static void sd_read_block_limits(struct scsi_disk *sdkp)
|
||||
{
|
||||
|
@ -2779,7 +2778,7 @@ static void sd_read_block_limits(struct scsi_disk *sdkp)
|
|||
|
||||
/**
|
||||
* sd_read_block_characteristics - Query block dev. characteristics
|
||||
* @disk: disk to query
|
||||
* @sdkp: disk to query
|
||||
*/
|
||||
static void sd_read_block_characteristics(struct scsi_disk *sdkp)
|
||||
{
|
||||
|
@ -2827,7 +2826,7 @@ static void sd_read_block_characteristics(struct scsi_disk *sdkp)
|
|||
|
||||
/**
|
||||
* sd_read_block_provisioning - Query provisioning VPD page
|
||||
* @disk: disk to query
|
||||
* @sdkp: disk to query
|
||||
*/
|
||||
static void sd_read_block_provisioning(struct scsi_disk *sdkp)
|
||||
{
|
||||
|
|
Loading…
Reference in New Issue