mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2026-08-30 15:43:08 -04:00
scsi: qla2xxx: Clarify MPI optrom address/length units
The kdoc for qla29xx_mpi_optrom_data() described @offset as an "Offset into the device memory", which reads like a byte address and invites confusion with the per-chunk word-granular address advance in the transfer loop. MBC_LOAD_DUMP_MPI_RAM is word-addressed: @offset is an MPI RAM address in 32-bit words, and @length is a byte count that is converted internally to a word count. Document this to reflect the existing behavior. No functional change. Reported-by: Sashiko <sashiko-dev@google.com> Signed-off-by: Nilesh Javali <njavali@marvell.com> Link: https://patch.msgid.link/20260730155838.2119230-6-njavali@marvell.com Signed-off-by: Martin K. Petersen (Oracle) <mkp@kernel.org>
This commit is contained in:
committed by
Martin K. Petersen (Oracle)
parent
19788a55ca
commit
f20e00e0a1
@@ -560,8 +560,9 @@ static void set_chunk_mpi_bits(uint16_t *options, int count, int total)
|
||||
* @vha: Pointer to SCSI QLogic host structure.
|
||||
* @opts: Options for the operation.
|
||||
* @buf: Buffer to read from/write to.
|
||||
* @offset: Offset into the device memory.
|
||||
* @length: Length of data, in bytes.
|
||||
* @offset: MPI RAM address, in 32-bit words (MBC_LOAD_DUMP_MPI_RAM is
|
||||
* word-addressed; not a byte offset).
|
||||
* @length: Length of data, in bytes (converted internally to a word count).
|
||||
* @op: Operation, either QLA29XX_MPI_OP_DUMP or QLA29XX_MPI_OP_LOAD.
|
||||
*
|
||||
* Returns:
|
||||
|
||||
Reference in New Issue
Block a user