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 63519C54ED1 for ; Sat, 28 Jun 2025 18:59:03 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 012E66B00A3; Sat, 28 Jun 2025 14:59:03 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id F2BD26B00A4; Sat, 28 Jun 2025 14:59:02 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id E69486B00A5; Sat, 28 Jun 2025 14:59:02 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id D52296B00A3 for ; Sat, 28 Jun 2025 14:59:02 -0400 (EDT) Received: from smtpin29.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 57B8F1D7871 for ; Sat, 28 Jun 2025 18:59:02 +0000 (UTC) X-FDA: 83605721724.29.54C9160 Received: from casper.infradead.org (casper.infradead.org [90.155.50.34]) by imf16.hostedemail.com (Postfix) with ESMTP id A534C180003 for ; Sat, 28 Jun 2025 18:59:00 +0000 (UTC) Authentication-Results: imf16.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=hBtKZEdi ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1751137140; 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=oA2jHaW6+CJOzNjSaXU3VpNLWqFmvE+xVZ3Wrn3GAbo=; b=GywZyVAqfylrej4l5tV003NdhbBFKvoyFpsydnyPyxGRkiacLJ/HGRJZJrGUU5XGCUVoQf TtU+0GQNMd8mXiUylT1eFWBxD5iHwM/subBd8fYIhVZrQYL6rX+hDBIzeYUulS5B7ldfCC OGwbHQuqKbPMpHpcONWFmSQ2lqncdaA= ARC-Authentication-Results: i=1; imf16.hostedemail.com; dkim=pass header.d=infradead.org header.s=casper.20170209 header.b=hBtKZEdi; spf=none (imf16.hostedemail.com: domain of rdunlap@infradead.org has no SPF policy when checking 90.155.50.34) smtp.mailfrom=rdunlap@infradead.org; dmarc=none ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1751137140; a=rsa-sha256; cv=none; b=cg9Ojm0p1+p6zA+JsDVO+rPIAUirHQGCu88CMk31YJn9vnJ4QWDPd8hexAG7U+i2OoBpm+ azpUmKBNQ5Fe/ceszdSj1om5HyYDfaebQTwnnK97UAkIOP8jbTkUI/h1FIO7gf6UJv2djO iWG1T3PeiAiOGobx+iC/RBnQxsuvxWI= 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=oA2jHaW6+CJOzNjSaXU3VpNLWqFmvE+xVZ3Wrn3GAbo=; b=hBtKZEdiItL4RXCnEM/iUx6SGo 2UxnkpxJUlb1IDaEdlxbe27QcNxWrufZYhUupqRp+54G6DRKGAyAiApTkNGqCwzJMGt0QQafN30eq LIQDBa9SFL4CBgT+76aYGm2457x1HOOs06B/oc9IwNu2Lg0AqY1d+pXPTwPiXfWsUJaIPkPeHnyXp 3ZGr0VyxSXUsyjyCp5IseljfZu1/BOglwKvKQRD7mSAO0PylPD4F7SwtPajnmLEddMWQQwweOfYsc 85pt8XgJchWLLne+TijUJlq171r5Zv3TJxwCvfOHOmjSwLKOBJS/BbH77j7fkLVlZJEXSTqPIGVRk StDXuDkw==; 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 1uValM-0000000H7rb-1MKn; Sat, 28 Jun 2025 18:58:56 +0000 Message-ID: <0e66cd54-fd37-40d6-8a22-b191938bf53f@infradead.org> Date: Sat, 28 Jun 2025 11:58:53 -0700 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v2 6/8] docs: dma-api: clarify DMA addressing limitations 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-7-ptesarik@suse.com> Content-Language: en-US From: Randy Dunlap In-Reply-To: <20250627101015.1600042-7-ptesarik@suse.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Rspam-User: X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: A534C180003 X-Stat-Signature: hjwb6bujxhcj16hk61gatxpubztfcex7 X-HE-Tag: 1751137140-310250 X-HE-Meta: U2FsdGVkX19eiBjNMDqW9mUuMPVRyix9b31Bvxfu5HEdziTWehA6AkQYhZ5BE/Cf40TK2kadDEqhNmV+EUO4VlBQC8bmlkCjVjr9gWHxujdFg1nNLSSHIgJp1Q+3JvQ1ts20zgesZgPYRYRR+ZL0k9T1M5TiyxzjNm1eUUN8Nsz96xg1vXW8myDdETBr4GdB09OxnJZkKRbPqJEaX+XF7DRCW/Scs7nLmEn/uDrl3b/Jy87rLfbE3kIbN1s/5Oy/IliaDy4pI3Wmor6+Z3NUnpJHY+ZGDOwGprK9sQwKmIOR7QutVc6X8WSDhRTChDO9IXoWZ+JiazpX1fvtCoovAnFJ1M/O3RESdpFj54U8IilqlhY10bQC+b4uFqwc0q70A7q+fnuk1SMBlp09u5qgaYWVFL2Bf2e42P1jVfC0WJSCDiFeCbH9cxaiXV6z6i1feuNDhXtfYx/u97skmmaZsMOdspEiyd/bzEGmM4Qgp7qym1vNNS1b4qiUqns/PZgi0Fp3MwLV8DwfwkjMRILRXJ34fJHE/mWBTSAGi0m9FWIl+a4FdjUvhXFkMrhxU/4fW5++MOuvQ2jqeHjKfxzDrwQdDTFc4aT+Ykc/vqs67I1hWZ0vI1+w8Ph15FCZ8FadQ3fEjd+OjTv5oI7KrGsHPobVt2NOaqtpgaRaztYfv3OhXkZ/i01cNJW8Tz32AfGS0EOdpqARwvjdEIGDRjwDYZ1y1pmS5C2AryJdY1H9PXlkpeRIsg6pM4AFSlEHFUowvySo4rtlBtp8TA3Rd3BFaZmhhBNC0pWmS5a6WX3NjqXZ3trw62JPTkTEeFI/w3Z77+nNzaauRzXBZMpUpb+12usle48HRM7Sukf98fu52P0VTsMF+vVNoA5NE8SS4HKQOMOCmvtg8Mmzfdp4vYvAL1Z7VjTPYbB0vXSEiFkJaM8O5oEga/x7bgRIo8TgHqfipgcRq4yX06pZFt8cjsV 7VdTCExk 5ttIwlbj81osMrGkslv+RzdTnN19C0w9lVHoAg/5TcxnTFveVlLgKo+r3Iig4f3m4+kmgw9Y0jVD6GOEYCzpse935bZ3Yq4F72b4PhEsQjWKz5U184I0pYs4oRS5ntowdqj28BFZrF5DXNcHHy/tn/OqgNsds0I6nGrlA8f692re0MNUPXjqqKo4W6KF/UT6Q7EMeRRmrviUbBJ5VUrQLtPneaRimR7vXoc9D7Z4wfM9RKN8NnA9kZnnn8k2/WlgHt2n05qgzbZPr+XpZ2Vjfqzp8+UVASclT8WauHuGJ4QkDI6brn/P0ezpQ5wmhHGpbg8rgZS6NyLICaFqtSGLrIi5oW3O/8J/N0uhO 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: > Move the description of DMA mask from the documentation of dma_map_single() > to Part Ic - DMA addressing limitations and improve the wording. > > Explain when a mask setting function may fail, and do not repeat this > explanation for each individual function. > > Clarify which device parameters are updated by each mask setting function. > > Signed-off-by: Petr Tesarik > Reviewed-by: Bagas Sanjaya Tested-by: Randy Dunlap Thanks. > --- > Documentation/core-api/dma-api.rst | 35 +++++++++++++++--------------- > 1 file changed, 18 insertions(+), 17 deletions(-) -- ~Randy