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 730C9C07545 for ; Tue, 24 Oct 2023 08:33:53 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 12BE36B01A3; Tue, 24 Oct 2023 04:33:53 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 0B5856B01A4; Tue, 24 Oct 2023 04:33:53 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id E71A66B01A5; Tue, 24 Oct 2023 04:33:52 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id CFEC46B01A3 for ; Tue, 24 Oct 2023 04:33:52 -0400 (EDT) Received: from smtpin24.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id A0A13140E71 for ; Tue, 24 Oct 2023 08:33:52 +0000 (UTC) X-FDA: 81379691904.24.6924D19 Received: from mail-pf1-f179.google.com (mail-pf1-f179.google.com [209.85.210.179]) by imf24.hostedemail.com (Postfix) with ESMTP id D28A1180006 for ; Tue, 24 Oct 2023 08:33:50 +0000 (UTC) Authentication-Results: imf24.hostedemail.com; dkim=pass header.d=bytedance.com header.s=google header.b=eIvWP2R5; dmarc=pass (policy=quarantine) header.from=bytedance.com; spf=pass (imf24.hostedemail.com: domain of zhangpeng.00@bytedance.com designates 209.85.210.179 as permitted sender) smtp.mailfrom=zhangpeng.00@bytedance.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1698136430; 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-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=mFyp/FJQdSo4OvDS2koRMpNI0AcMCWskpm09jBYSG+0=; b=R/yo1rd1hMhsSjZF13O+yDvfO0lhQRWl28rGn2KkzN8n8ii4o0enRj1ngNEzbmzL3uONq5 c0J1gQrfsOdDnYMqL5Pb4wtbRW/Hl08l90tAPbkRKW6Iabd0rtE/AphAAKafGVI+mue1kN qcFBI7GBJU05Bvxf6bElbc1nz/QbP84= ARC-Authentication-Results: i=1; imf24.hostedemail.com; dkim=pass header.d=bytedance.com header.s=google header.b=eIvWP2R5; dmarc=pass (policy=quarantine) header.from=bytedance.com; spf=pass (imf24.hostedemail.com: domain of zhangpeng.00@bytedance.com designates 209.85.210.179 as permitted sender) smtp.mailfrom=zhangpeng.00@bytedance.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1698136430; a=rsa-sha256; cv=none; b=LzdUQaUDk5m6scJCdseyIaz6ZxYmMmtAoAqda/MWFaLJpOPZoTV/y699xKOqZrDT94xodn PM+K3YL6twnU+WCM7Tbrf9g0rRD1a/2zLUa9ibmgY54Foe8+I5y+SpgdfAUrirxQKmy4tR cOl+0cZFw9e9OKsODS6UPh3IFrJVmBY= Received: by mail-pf1-f179.google.com with SMTP id d2e1a72fcca58-6b77ab73c6fso3055137b3a.1 for ; Tue, 24 Oct 2023 01:33:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bytedance.com; s=google; t=1698136430; x=1698741230; darn=kvack.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=mFyp/FJQdSo4OvDS2koRMpNI0AcMCWskpm09jBYSG+0=; b=eIvWP2R5GFg23PKpQMt/tCqFdilyKkGl6A9yrCxz7be0+I7WLR/dUfMqyfa4Iqx4Q7 dXF0slWiYtEjhH/OowytcE2ZMLVyCoNhb9bMRpC8k4XAlwg71HVRL5AWPd3t/dE966VA PB4rC6/r+WOmAddxKS56qDjqpDTc8vloExqiNrjLnD6z3RiEI/1rklagN/zTyk5iS20y QRknQIxvj7O9uzEBtcWq+OS8L/6lHimWlTQB2b0ywlOE0hfS3umZUdbkAwWO5n1UNCAm /o2BQvxONR9E+8InyMqFGjpIfIPKHqvWveYcUYzQAJ3+IsUrjtchHtrQk/wN+qsnFEQp ljoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1698136430; x=1698741230; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=mFyp/FJQdSo4OvDS2koRMpNI0AcMCWskpm09jBYSG+0=; b=XAPeXXcpAIzM1sk/W7wRcDmXAYBHPaZUrKuM0CJBASNZp7l/PQ/QGI3Mcl7vjduAfU AADCgkOj3E6RM8rnJWTjYMOmjmdQI3wSsvhZgqSp6xM6zrqsXPiPaZmKOjNxcLEZY/MF iQao2ozUjnD/zgJrp0Z4W/wGjhv8J1GTLf7+jdAIdZSWHnS8DzJgWAuN7IuyG9ySeUaO Vw40DpR0sJtFvZFSpRI4jtozPD+QJry5YoxkB+9JWpjg4ha1u3/5V8oONtwNIrnLfOA/ VdlkSZ/gJ0Exfhb24oAZdgV7ATZ5iGTmCv2PkndYSfv9ObYnFavfbc5Id4Nk1gNcKIji sETQ== X-Gm-Message-State: AOJu0YxDJxeHvnXDAlalzxDd3AiL10KK6/MkvSiF2YgbzfFVyN9xJRta VkA75m8XBTeH+kp2mLEilWCtew== X-Google-Smtp-Source: AGHT+IFGRqPLSl0xQjtZhF9R2vYQNinwziWDialz1aZ2psT6bnUbvTADzmyVrOS+Nnq8WOBVXot69w== X-Received: by 2002:aa7:8885:0:b0:68e:2c2a:5172 with SMTP id z5-20020aa78885000000b0068e2c2a5172mr16021661pfe.6.1698136429778; Tue, 24 Oct 2023 01:33:49 -0700 (PDT) Received: from GL4FX4PXWL.bytedance.net ([203.208.167.147]) by smtp.gmail.com with ESMTPSA id y21-20020aa79af5000000b0068be348e35fsm7236977pfp.166.2023.10.24.01.33.43 (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Tue, 24 Oct 2023 01:33:49 -0700 (PDT) From: Peng Zhang To: Liam.Howlett@oracle.com, corbet@lwn.net, akpm@linux-foundation.org, willy@infradead.org, brauner@kernel.org, surenb@google.com, michael.christie@oracle.com, mjguzik@gmail.com, mathieu.desnoyers@efficios.com, npiggin@gmail.com, peterz@infradead.org, oliver.sang@intel.com, mst@redhat.com Cc: zhangpeng.00@bytedance.com, maple-tree@lists.infradead.org, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-fsdevel@vger.kernel.org Subject: [PATCH v6 06/10] maple_tree: Update the documentation of maple tree Date: Tue, 24 Oct 2023 16:32:54 +0800 Message-Id: <20231024083258.65750-7-zhangpeng.00@bytedance.com> X-Mailer: git-send-email 2.39.3 (Apple Git-145) In-Reply-To: <20231024083258.65750-1-zhangpeng.00@bytedance.com> References: <20231024083258.65750-1-zhangpeng.00@bytedance.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: D28A1180006 X-Rspam-User: X-Rspamd-Server: rspam02 X-Stat-Signature: z1doof17z3k3ytfkfki9ohtbtm36u63w X-HE-Tag: 1698136430-727317 X-HE-Meta: U2FsdGVkX1/Srojmt7r32zPQ6iUIAVSyqn44wt7EN3gEFQ0hYj0Qkt3pV98lLvkp1LCn64yN54MHNu8jcTDtvkqIFsgxZD/lpsjE+I7KBjMgXI+J16JMHxEpUyOOxamN8XldR7venzWYxk1AimW91oztqIfkMczzGrcGye4id9eIW41mFNv8Mnu0Hbmrq5aB4/uG4qhBTRawNkYT0UQ1IVlqYudffojI+XQnQhktGV/v46BBrlRs5dN6bGT3D4Mw96wcfxaOX5qcOxWuJDyncDo7pbi4f02om3j2kfy6uBWKSk7lFxYF4cfyh0rdysuuNpghbpvFjbRB46ZNfWebvREIp2QEfeYwhRevwqSlnPS+KCPv0/7Z71CP9/55/CQWDuemdUMF+MpgEcD+BGWEyErh+QXxakQRgpj6UM86/3xyXbKsV4/ZKB64lsesORl3GrGh39OhkkFHV+Ys0FrETzMDOuObrovXOwoLMXIJkjeKIptFQBe+jKsqcVaiMfRAO8cZ0mXW3K4TCFqL3KmLsmDdDvhVepyty3jP2cNIuFw5nhWvnma6Oi6IALlrI818isAu2vNTW1TiLCSnjI814AHDKugMHl8T2Xi2FsDINJala9GdhUPtz97BDDuysj72FTfL1mxWhIMxWdBtwMyTkGx8doyp/amGmU9b7ESkSljzG4WvUavO17/NAAaLBConSZHn3VoNhOxJkmYbYNgkphtd9McEqebhQczKmdAjAYFfS5TaeUFO6kM074HAQo+Fi2kT5mPp4kWqCoK5B9UVN601nLfFvKJRtRI3LqNEgPRTfzjmhqUdhW/re3dkQ+mGFP3w6XpERWN3+1J5MpiJi9wn83LieAKI2QpKAT7gtohrOHzQ+N3WlNTJwHs6WZikNm8nMxSxTbrXM+M0Acio44CJIejz67PjaV30IDDhkGSBc1HMx/2LOq84Wik70FX4r6ebs/mubYBjy3m9c/S ZCBEjmgy NOzjKPpTqQ8fnwle0Qv/VyY79J5TS1Y+2w/pjAZ+XizvI3FaFwkiAPYLl90CYsuOx3DCwupsWQN2aYB/uvRmZkCPHJbFQyIAn0RazpH7sX90+w0YUcLjU9Rc0wxuusT49A6qXJFYH6pxKTQfsg6KFifvgqeumQFG0PTkpoOUR49AvOJAPCpChfmlSxzmh1Ra7fpjwM8C9DI6/52b3ZbuJsXiMHTxSsNjoCpEN9WnWuz1XRheX7PAKy78XwOGMSY2cQzTTv6f3GpBvwEHor8eUWbA5iOO/YbFsuNQnhpxMK79O7mYurhId6fLdP3QqbhHVfRa8TLFZT5WwsJfPp0zU4t+aqqZy5aBtiJbTFthZ0y2Jo/a5ynn30LJZiJVXCOFL7+McvBkxVICGLhjbVQ1aBRXchcyCDGFDZbYA70XtSKIvwbJPsNwi9LFiOTGFwpA7Yp41mqnRBWiHerOp78zB6jmcCQ== 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: Introduce the new interface mtree_dup() in the documentation. Signed-off-by: Peng Zhang --- Documentation/core-api/maple_tree.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Documentation/core-api/maple_tree.rst b/Documentation/core-api/maple_tree.rst index 45defcf15da7..285e2d2b21ae 100644 --- a/Documentation/core-api/maple_tree.rst +++ b/Documentation/core-api/maple_tree.rst @@ -81,6 +81,9 @@ section. Sometimes it is necessary to ensure the next call to store to a maple tree does not allocate memory, please see :ref:`maple-tree-advanced-api` for this use case. +You can use mtree_dup() to duplicate an entire maple tree. It is a more +efficient way than inserting all elements one by one into a new tree. + Finally, you can remove all entries from a maple tree by calling mtree_destroy(). If the maple tree entries are pointers, you may wish to free the entries first. @@ -112,6 +115,7 @@ Takes ma_lock internally: * mtree_insert() * mtree_insert_range() * mtree_erase() + * mtree_dup() * mtree_destroy() * mt_set_in_rcu() * mt_clear_in_rcu() -- 2.20.1