Re: [PATCH 4/6] block: remove obsolete comments for _blk/blk_rq_prep_clone

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 2020-02-28 07:05, Guoqing Jiang wrote:
> Both cmd and sense had been moved to scsi_request, so remove
> the related comments to avoid confusion.
> 
> Signed-off-by: Guoqing Jiang <guoqing.jiang@xxxxxxxxxxxxxxx>
> ---
>  block/blk-core.c | 3 ---
>  1 file changed, 3 deletions(-)
> 
> diff --git a/block/blk-core.c b/block/blk-core.c
> index 883ffda216e4..9094fd7d1b01 100644
> --- a/block/blk-core.c
> +++ b/block/blk-core.c
> @@ -1583,7 +1583,6 @@ EXPORT_SYMBOL_GPL(blk_rq_unprep_clone);
>  
>  /*
>   * Copy attributes of the original request to the clone request.
> - * The actual data parts (e.g. ->cmd, ->sense) are not copied.
>   */
>  static void __blk_rq_prep_clone(struct request *dst, struct request *src)
>  {

Although the removed comment is outdated, the new comment is not useful.

How about inlining __blk_rq_prep_clone() into its only caller and
removing the comment above that function entirely? It's not clear to me
why the code inside __blk_rq_prep_clone() ever was put into a separate
function.

>   *
>   * Description:
>   *     Clones bios in @rq_src to @rq, and copies attributes of @rq_src to @rq.
> - *     The actual data parts of @rq_src (e.g. ->cmd, ->sense)
> - *     are not copied, and copying such parts is the caller's responsibility.
>   *     Also, pages which the original bios are pointing to are not copied
>   *     and the cloned bios just point same pages.
>   *     So cloned bios must be completed before original bios, which means

Adding a comment that explains that some but not all struct request
members are copied and also why would be welcome.

Thanks,

Bart.





[Index of Archives]     [Linux RAID]     [Linux SCSI]     [Linux ATA RAID]     [IDE]     [Linux Wireless]     [Linux Kernel]     [ATH6KL]     [Linux Bluetooth]     [Linux Netdev]     [Kernel Newbies]     [Security]     [Git]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Device Mapper]

  Powered by Linux