From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id AE470C54ED1 for ; Sat, 28 Jun 2025 19:00:21 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 4F7D36B008A; Sat, 28 Jun 2025 15:00:21 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4A74D6B00A2; Sat, 28 Jun 2025 15:00:21 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 396946B00A3; Sat, 28 Jun 2025 15:00:21 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 26E3C6B008A for ; Sat, 28 Jun 2025 15:00:21 -0400 (EDT) Received: from smtpin05.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id DC6745A0F0 for ; Sat, 28 Jun 2025 19:00:20 +0000 (UTC) X-FDA: 83605725000.05.158EA19 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf08.hostedemail.com (Postfix) with ESMTP id 29005160003 for ; Sat, 28 Jun 2025 19:00:18 +0000 (UTC) Authentication-Results: imf08.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b="MFtL5p/V" ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1751137219; a=rsa-sha256; cv=none; b=TBZ3neCk3g0C3U8F+a1NIWt8Z94PF97cYwOrPV/5z1aF4REcBVnJOeVe79Q+2by8OSxstW sEhScB4+s2+Z5lcv3yMSVkBgHkogWtP42enySRKoFTE69pi59tOmKjFhXFRlDs+JzJqdYG prNY22gB40R6Z5rgGo83O6OP1ehKMgI= ARC-Authentication-Results: i=1; imf08.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b="MFtL5p/V"; dmarc=none; spf=none (imf08.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=rdunlap@infradead.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1751137219; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=/wsm0WMBHfTVvC+lyHbNl2ZkewM8q9E14a8ndv6TdvU=; b=cojvp3qAvFEhuURfjiE7w3xiY6gwIlacrtZt59U2Yzz04aydcCYgFHwhNotgHzQMb5ReHp caa1dpSPm32CFDbhVeJt1asYUCdcfbOjdK5WXL7WfYpr6ds/S1L0KC9zeDJf60znl6FyQY /fDyeVxdTZ3Lu21UtTmE3BRGFuH4+4k= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:Content-Type: In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date:Message-ID:Sender :Reply-To:Content-ID:Content-Description; bh=/wsm0WMBHfTVvC+lyHbNl2ZkewM8q9E14a8ndv6TdvU=; b=MFtL5p/VF0SpyScstjg2FHOJWO T+EuvmCJvOOsRAurr9/vjE8rtrmZCPWyO45K4qUGuPw5pOS8gJFE7W5/S+cAgriOCuju2U7HI7zbw NilyMLR4fOGaQw08TXXDFyMAfFowM/fy66TzSzLTCqOXTGy0cpx4bulPTvq95lHMAVu2+yhUy/cPB umhnFsjECQvjamduAGLjro+/vt6bF1IzXUcof9uD6lgGXf1sxtCnCadHyofOmzzsPU48qL8bxlmaf pD/CsNT2g69eonCUzXV2c5acnoOFb9PyyKtis/Qn/tWOGxV+E952Uj9HP8fygwZwkQXxGE7K60Uyd NWfe0kwQ==; Received: from [50.53.25.54] (helo=[192.168.254.17]) by casper.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1uVamc-0000000H84G-343D; Sat, 28 Jun 2025 19:00:14 +0000 Message-ID: Date: Sat, 28 Jun 2025 12:00:11 -0700 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v2 8/8] docs: dma-api: clean up documentation of dma_map_sg() To: Petr Tesarik , Jonathan Corbet , Robin Murphy , Marek Szyprowski Cc: Andrew Morton , Keith Busch , Jens Axboe , Bagas Sanjaya , "open list:DOCUMENTATION" , open list , "open list:MEMORY MANAGEMENT" References: <20250627101015.1600042-1-ptesarik@suse.com> <20250627101015.1600042-9-ptesarik@suse.com> Content-Language: en-US From: Randy Dunlap In-Reply-To: <20250627101015.1600042-9-ptesarik@suse.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Stat-Signature: 67aunkgtxfpxuah6rhpjwxte9hfqbzr8 X-Rspamd-Server: rspam01 X-Rspamd-Queue-Id: 29005160003 X-Rspam-User: X-HE-Tag: 1751137218-160643 X-HE-Meta: U2FsdGVkX19rmmpntXDt7KM8WlSkY5qcv4Q4qEHSzfMlJXfLOljEe3wzbu3zKJOYVJBm4rEtbb1c5J1MlnUCIpZUV5bHgeAwytp3SmYLejwT6+XkRRNcQATzXW6LV1j2thkQIT6FTehAOZArj7Gq5ADASXPXHMjW71JucGOouN3L26WrAn2S48lhODgEflmyDtgdLx4niN64cdM0Is3evdYyJEykPacl2jNQIoilF/ZFO/p4NFOSvNKnhG2ma146yDN/Tr0s+cosRLLjIYpKK6m3Iug/Kx+A5Rc++M4uV7/bWdfpcmrgY5RhVgzaWG6ThA5vv8MwFywFoz5P/usU5qVt+KhRPr5N6AZgVgNf2nGdY9+pozGE4qTehYDXXkh5QXYwdMxLH0MpJMbLxTGq4jAtQxSyZGRTb/QW5T4Y+YPe9+rZUxyRWzLuSzuL/Ojww1uqtW2V0y5/3j37BObTJjzw1oqSgLuD+RYvt4PXFsrP+brZ8lm4/RwnvGgsIg1AztaYxx9DU5gKLTu24EiAS7e4yvXJzV0RD4alWunN8yvLi8fUC+bYfg7d0uZViClvHNItKEIUzEIbJ8KyiCnqP/rGJzcDUtGlUFgMocHsXyqNAo/0d3LBlbvhDgkhvveRjoDdZI8GYK7Qt9ImrEAQc+vwWg6g69i33pv9EdV40zqloWqCEVf7IeU9WHifpeUpnrU/Is5yCSUMV7oiyYkpixOR6bpzr2YvDB0D5r9UBWekR0btAst86CWaNnYyQT17u3sVfjTguya0kxanPNQJ19x3kUwGWPDkfL0YPkFuFTxhuBo/oo6NcCHUfxuy65FbZSnwkR6UlboDwfYl3o8lxZOH0GorOmE/Xi1on8mYAblzItbhkNyDttuNA5HCuosFAhusgMiztYD0WCYaRceFJL/lwSnWNIuiO4FEwspxe3Nsw0BR+n2xPfRXMCTWmcXbNBx4+O5KgKe14ojsv43 HgQGMgf8 RWzPv3Ifqtfmkt0hqQrsYWQpaBkqarYeBq8uHM95t1EQJsF9PLVxwBCORmeG4V+bSWIO5BF/soVP4fuulhj/qHOA8Tyb5JtIX6an2aUs6MHql10r/BB3rc3lEV1Dww2TkozMgO0XJLwUd4zE/Qxw4BE5GAoUenY9p2BfXbOCY4l2ZRjmCdx6Qq6uUAKVlp2U37lw8LoXBO+hou90opflj3pRG99HdL6UTpMmKCChPPFO1vDyJaxqdjhzOj2kghcEXZ7TIz/Ll6VLBFbnIr5M0iC8LdR3FIIkVrQDkywgCQ8iuH148a80N7/VPLrZhSF7LfHbMsfgsUuWp1pFpPScHNpxCZlKowZsVs+T2cOtqol8xSr8VQQxqGrH5l3Lh6uIdOevhUzDTqXSN9HT74G45lfiLDw== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: On 6/27/25 3:10 AM, Petr Tesarik wrote: > Describe in one sentence what the function does. > > Do not repeat example situations when the returned number is lower than > the number of segments on input. > > Signed-off-by: Petr Tesarik > Reviewed-by: Bagas Sanjaya Tested-by: Randy Dunlap Thanks. > --- > Documentation/core-api/dma-api.rst | 13 ++++++------- > 1 file changed, 6 insertions(+), 7 deletions(-) -- ~Randy