The current scsi_init_io() documentation does not accurately explain what this function does. Make the scsi_init_io() documentation more accurate. Cc: Christoph Hellwig <hch@xxxxxx> Cc: Johannes Thumshirn <johannes.thumshirn@xxxxxxx> Cc: Hannes Reinecke <hare@xxxxxxx> Cc: Daniel Wagner <dwagner@xxxxxxx> Signed-off-by: Bart Van Assche <bvanassche@xxxxxxx> --- drivers/scsi/scsi_lib.c | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/drivers/scsi/scsi_lib.c b/drivers/scsi/scsi_lib.c index 7c42c00afb0d..b2b9bbaad9fe 100644 --- a/drivers/scsi/scsi_lib.c +++ b/drivers/scsi/scsi_lib.c @@ -961,8 +961,12 @@ static inline bool scsi_cmd_needs_dma_drain(struct scsi_device *sdev, } /** - * scsi_init_io - SCSI I/O initialization function. - * @cmd: command descriptor we wish to initialize + * scsi_init_io - Allocate and initialize data and integrity scatterlists + * @cmd: SCSI command data structure to initialize. + * + * Initializes @cmd->sdb and also @cmd->prot_sdb if data integrity is enabled + * for @cmd. Functions like scsi_sg_count(), scsi_sg_list() and scsi_bufflen() + * return the values stored by this function in the @cmd data structure. * * Returns: * * BLK_STS_OK - on success
