Received: by 2002:a05:6358:1087:b0:cb:c9d3:cd90 with SMTP id j7csp7287439rwi; Mon, 24 Oct 2022 12:23:46 -0700 (PDT) X-Google-Smtp-Source: AMsMyM7SKpClX3izCJY/aG4kvsY5yBCbAKfc/7hCpqQsOoq3n0c7aptsL2tVL3kn0Ju5Q9rlkK0g X-Received: by 2002:a17:906:8a6c:b0:7a8:2f09:d88d with SMTP id hy12-20020a1709068a6c00b007a82f09d88dmr5558301ejc.49.1666639426067; Mon, 24 Oct 2022 12:23:46 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666639426; cv=none; d=google.com; s=arc-20160816; b=a2IJD6WKe/Vtf+LO1y1g6ve8heiUQ8yELsbYUFBFqX0y+XeOYM4m80W4QQU2okqKs0 zPBCjel6n9PHtoPs5Z+kwbgxKuBKeAohesl/kNfnRBHuSBjsxViTZShJZevM62b5jQa6 igCx9kZdUG21F3uXCnb8iF4uiDnXhuJeRltLNGObb/1RkJm+Z7cbD5nab/UZjp+9wc7w VfhOeiTUNhgxXRFQ3kx1j3pg057WBDL3IomaeXORqUjSKnqDCN8vaA+a28BlKfUfP06F ajCgra+YUnG7xUPq7J0mym0/8JRemSD1d2YEZUQ/vT4cZSAD+qUqitDtLYUe3E/rrdnp vwfw== 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 Return-Path: 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.23.19; Mon, 24 Oct 2022 12:23:46 -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 Content-Transfer-Encoding: 8bit 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 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/ --------------------- -- 2.25.1