Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
Subject: Re: [PATCH] lib/scatterlist: Remove leftover from sg_page_iter
 comment
To:     Mukesh Ojha <mojha@codeaurora.org>, <linux-kernel@vger.kernel.org>
CC:     Jason Gunthorpe <jgg@mellanox.com>
References: <1553800491-28583-1-git-send-email-galpress@amazon.com>
 <8e313491-8859-d47f-f104-6d2d783cd63a@codeaurora.org>
From:   Gal Pressman <galpress@amazon.com>
Message-ID: <a232e623-b998-0d67-68ac-4e38ea9c4709@amazon.com>
Date:   Fri, 29 Mar 2019 12:40:40 +0300
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101
 Thunderbird/60.6.0
MIME-Version: 1.0
In-Reply-To: <8e313491-8859-d47f-f104-6d2d783cd63a@codeaurora.org>
Content-Type: text/plain; charset="utf-8"
Content-Language: en-US
Content-Transfer-Encoding: 8bit
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

On 29-Mar-19 11:36, Mukesh Ojha wrote:
> 
> On 3/29/2019 12:44 AM, Gal Pressman wrote:
>> Commit d901b2760dc6 ("lib/scatterlist: Provide a DMA page iterator")
>> added the sg DMA iterator but a leftover remained in the sg_page_iter
>> documentation, remove it.
>>
>> Cc: Jason Gunthorpe <jgg@mellanox.com>
>> Signed-off-by: Gal Pressman <galpress@amazon.com>
>> ---
>>   include/linux/scatterlist.h | 10 +++++-----
>>   1 file changed, 5 insertions(+), 5 deletions(-)
>>
>> diff --git a/include/linux/scatterlist.h b/include/linux/scatterlist.h
>> index b4be960c7e5d..30a9a55c28ba 100644
>> --- a/include/linux/scatterlist.h
>> +++ b/include/linux/scatterlist.h
>> @@ -340,11 +340,11 @@ int sg_alloc_table_chained(struct sg_table *table, int
>> nents,
>>    * sg page iterator
>>    *
>>    * Iterates over sg entries page-by-page.  On each successful iteration, you
>> - * can call sg_page_iter_page(@piter) to get the current page and its dma
>> - * address.
> 
> 
> It took me a while till i exact found what you meant by left over.
> 
> could have been more specific in the commit,but
> 
> Looks  good to me to be removed.
> 
> Reviewed-by: Mukesh Ojha <mojha@codeaurora.org>

You're right, should've been more specific.
Should I resubmit?

> 
> -Mukesh
> 
> 
>>   @piter->sg will point to the sg holding this page and
>> - * @piter->sg_pgoffset to the page's page offset within the sg. The iteration
>> - * will stop either when a maximum number of sg entries was reached or a
>> - * terminating sg (sg_last(sg) == true) was reached.
>> + * can call sg_page_iter_page(@piter) to get the current page.
>> + * @piter->sg will point to the sg holding this page and @piter->sg_pgoffset to
>> + * the page's page offset within the sg. The iteration will stop either when a
>> + * maximum number of sg entries was reached or a terminating sg
>> + * (sg_last(sg) == true) was reached.
>>    */
>>   struct sg_page_iter {
>>       struct scatterlist    *sg;        /* sg holding the page */