From patchwork Mon Oct 24 17:46:18 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 9964 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp614088wru; Mon, 24 Oct 2022 12:22:54 -0700 (PDT) X-Google-Smtp-Source: AMsMyM7Bzu4bpy2csbQYDO0YD12qsh9VAgY5yEIf0UvkrdSM0vU8tA0YERws26nTyLa+U/Gi9v9x X-Received: by 2002:aa7:c7d1:0:b0:461:2a82:497e with SMTP id o17-20020aa7c7d1000000b004612a82497emr20497637eds.267.1666639374409; Mon, 24 Oct 2022 12:22:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666639374; cv=none; d=google.com; s=arc-20160816; b=wc9QFAZ+h0tpYj+AU5GtYYr03saYxsWYS2WuueC2OPzlpG0t3+6Ai1aSiqnEQrLYxZ 3RuWi3BwLGZyBe4VjWurM7MyfMqlrYwQHwMDlguQXsjQHjENYZbd451rHC+b0K21yeVL RAC5DFlilIH5C/Cy9V19O4Mj3LNNibai5aN7X0SE+/oesoMImdk4yW56MBrgHxzjuxoj g1cZUPDpLQ0LdjzJAH6ZSkhfkBFMkuDSrAN47eTj9Vd+YHgHaijCprt+WbGhhphAzb8Q 0gIkaX2aILzR/SIKBmHO8ihB3vOaixSJFEwY6CrahTQMOSyYebIQkqDGo9B+y9EanzQ2 ovmQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=SCKyNRY/90uoyc/wHqrrQ5eRjpGflxMtHjvnMUiUkTo=; b=eHJ4hg/iAmHKbHd5l7950PmyRY0Luu3Pvv3+AGi0KFXlfj5Je5F83s5YLlvj7RnEa6 c6D6uuOjhfBhJDL5j+pdA2o1PnnrcsjKVGMtMB2VTgqhR2BfmQ84FtkoBDUdFtJoFCWw m/vy7li+VJbtPepeY4N0r2BxTg8zE5Lj+Vhg48p53LjXyLFZmrZ78LYqgsoiSLC+fV9A S8tXQDoUbfvRgwRy6GstPHmnpvt4kHn+51R1AcuaUeeBmaeKzADrLcIu0r8ABo2sN7E8 Sv+q4bJz2tasO9ZhW1MXD7eYU159TK90gT+sMC7MRfVW9IlZKDl/EyEo+Ohme4GhorBd TBvg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=MLsERA71; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id 5-20020a508e45000000b00458cbb6b6easi609017edx.167.2022.10.24.12.22.30; Mon, 24 Oct 2022 12:22:54 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=MLsERA71; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233221AbiJXTNL (ORCPT + 99 others); Mon, 24 Oct 2022 15:13:11 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:47788 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232994AbiJXTMb (ORCPT ); Mon, 24 Oct 2022 15:12:31 -0400 Received: from ams.source.kernel.org (ams.source.kernel.org [IPv6:2604:1380:4601:e00::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2746918F0E5; Mon, 24 Oct 2022 10:50:56 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id DC240B81142; Mon, 24 Oct 2022 17:46:28 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id E9C63C433B5; Mon, 24 Oct 2022 17:46:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1666633587; bh=lV8oUGKGj7ZDIO/tmDfk1VdZPNBMnBKsnbsjH0pe+m4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=MLsERA71D+0f1bI2hLFm02yZWXy7V4t4J5aBlCTtR7UBsixm3HQJ04xiUvdl+gWYW IR6ZBLnPq8d9XPQesG1OmXEH11O7o7Qi8vmRcuBUGVOExTPbnImg8uq0NYjIYW8SVC W1Lco5wuKDJg37THPKPkpDSBLdmcP+RyQoW0Fs2Q3rdyQwSdkeOhCAC3cN9Q2tT9Ls p4xuRqwCOdPp0jpN/i+04kihcUNFpWixl+ZB+apzgqC3Smw0s11nL6W4Z9Thki86f6 iFvzyNxQUxUv4vSy3cEK8xlyutYJfHWAN8qRHlzL6MkuXDyMsDrmR8K7kuvui/MBi0 TvZVSo1tvnB9A== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Vinicius Petrucci Subject: [PATCH 1/2] Docs/admin-guide/mm/damon/usage: describe the rules of sysfs region directories Date: Mon, 24 Oct 2022 17:46:18 +0000 Message-Id: <20221024174619.15600-2-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20221024174619.15600-1-sj@kernel.org> References: <20221024174619.15600-1-sj@kernel.org> MIME-Version: 1.0 X-Spam-Status: No, score=-7.6 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_HI, SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1747598049099699478?= X-GMAIL-MSGID: =?utf-8?q?1747598049099699478?= Target region directories of DAMON sysfs interface should contain no overlap and sorted by the address, but not clearly documented. Actually, a user had an issue[1] due to the poor documentation. Add clear description of it on the usage document. [1] https://lore.kernel.org/damon/CAEZ6=UNUcH2BvJj++OrT=XQLdkidU79wmCO=tantSOB36pPNTg@mail.gmail.com/ Reported-by: Vinicius Petrucci Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index b47b0cbbd491..89d9a4f75a29 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -235,6 +235,9 @@ In each region directory, you will find two files (``start`` and ``end``). You can set and get the start and end addresses of the initial monitoring target region by writing to and reading from the files, respectively. +Each region should not overlap with others. ``end`` of directory ``N`` should +be equal or smaller than ``start`` of directory ``N+1``. + contexts//schemes/ ---------------------