Received: by 2002:a25:31c3:0:0:0:0:0 with SMTP id x186csp1383675ybx; Thu, 7 Nov 2019 11:09:59 -0800 (PST) X-Google-Smtp-Source: APXvYqyhWThx+7srCyLJt9gBYSVJYkvXdpEOjh8rImAU33fjpab5DxETnlqgeO31zzmBgvRJEvmh X-Received: by 2002:a17:906:3501:: with SMTP id r1mr4475277eja.301.1573153799164; Thu, 07 Nov 2019 11:09:59 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1573153799; cv=none; d=google.com; s=arc-20160816; b=z+ma0Nfkgs7lnaXrtVUz6SdIs4AAzi+imWo0iuZfwU0rIlw7Vjy23FV5sepNX69jYj yBYcckILlbIO7BPdgMsBQTGPIEQOac9/ZcFJfDJLhu0YFjpoegAw4ZcAM+MJbSOELLul PZTQBgvCJJYfFwKz6XL7+Ev/CYd+Jh+ft9GDWa4fgyGmwWegWPFRbYfcOzCDtp04cmps 4wR1nv+CK0i0dBvWDmZUlnh2fWk6jEvKHCEjSm7hrZOKlzbir/tLaTZSGh8Q7djr5mtB 9/gfZstIld0T7w6erceCcr1ifXEYwcieUqRYdASF3Ujasax5khw/Kf7BdZvDIRjfweQH EpLA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=W47odrIZjcYj4z0Bgkfmue2TCHoiOu56PCWwIh8207g=; b=UoMLYWdBiCciAcKKX6kWPLCEGxSPV7AyH2th2tnkWWnK2nwH1gIh0M9mBksXuuci6l UkAFGJjkR6vKCVaetz8YW7Z3lVR0ZJB0NNoWxBVusjhdTml20iyWK3cwom6IYmBbjuN/ oDBOB5Xyn739Rq1c7vyanCO2CZGIyAkjUAytjvTvvpgqcyOWyM3ZeFJ9dwO4utcq48Kq ZUzoTeCeo/T6bNA98bIJOHd6qWgSt3BQfyO7AQ9qDZGMtNaey93Y5zKS6e2Vrnhd+H7r e3lLCdPzDS0Jrnr7SdSfaEB8/De9p6/RnI1zuGWyohBvV0Q9EYTJi9z2RIpM0yDSZfp4 4cfA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=mMKqtIsq; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id b29si2253581ede.118.2019.11.07.11.09.33; Thu, 07 Nov 2019 11:09:59 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=mMKqtIsq; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727030AbfKGTFw (ORCPT + 99 others); Thu, 7 Nov 2019 14:05:52 -0500 Received: from mail-qv1-f67.google.com ([209.85.219.67]:43767 "EHLO mail-qv1-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727352AbfKGTFw (ORCPT ); Thu, 7 Nov 2019 14:05:52 -0500 Received: by mail-qv1-f67.google.com with SMTP id cg2so1237643qvb.10; Thu, 07 Nov 2019 11:05:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=W47odrIZjcYj4z0Bgkfmue2TCHoiOu56PCWwIh8207g=; b=mMKqtIsq5pYYAfZq2O+8PKS6LuoNfzmmsez9yRUYkHSSU/sFfqaFYiuykAOrmHjpdO iPdMku3aBjtDrw1zEfGG1dz17wpBhtqcevu7Lo0iIM8jtfWqkOlyyoIWijjCJq5NVxqB X2xB9wMzKESpobnCUIqgKric4uF6oJHLVbvLT3sRVAbCmSA1sE0rc/+NJibDJJBbwL0/ EKXPuRTmPx7JAYngCv7bhF/FJitCOCP4Or/Q30CCMj+cNoZRNTlp/SvSetRPgG+2kkqM Ok1kS5o13/rZYYEOiza/EzqA34y9MN3peKdGtC1itTzYpEzLHQMgk7FPC/Tfg6iCARgF DVUA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=W47odrIZjcYj4z0Bgkfmue2TCHoiOu56PCWwIh8207g=; b=Pl7lnZ71yU/KJ8qRqKHPodXKS2I9rvbfJVERXO6ckvOq5Ikc7kxYbGXFZr67NaqXs2 PcG2yM2O5ojl/TE648qwSSuZ+jVUPgdJKL3HlRw/NymSZkmI80G+8NHGk2txgtQZADCG uaMgOzQ8h2T6ZNUXD25K7RF1PmAO/OUHhBwwI/H1YGP5X0+OmNJsstF0d2o8Rr81/3aI AZUrNN77t4BVfMbUdTXvdE1yA+boCX9wMcRzlT57vEnLq8ehl/8y1r/0yzU9t0tu4KvR IrwMnM2wY7GDNmTentxtnMRuQcvFxSCVlhRbQ6kG83YlNXGGcPVmaj5cKDRWT+mYJ9sX iIKA== X-Gm-Message-State: APjAAAVyyVXcNwmiN1ODE5qJ1igVVH44+IFjP0/GUlhSC/Jzm95oJ1Lv VrFaId14nVps9ejIlec2bJ0= X-Received: by 2002:a0c:a046:: with SMTP id b64mr5088475qva.6.1573153548680; Thu, 07 Nov 2019 11:05:48 -0800 (PST) Received: from localhost.localdomain ([2804:14d:72b1:8920:a2ce:f815:f14d:bfac]) by smtp.gmail.com with ESMTPSA id h21sm153692qkj.116.2019.11.07.11.05.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 07 Nov 2019 11:05:48 -0800 (PST) From: "Daniel W. S. Almeida" X-Google-Original-From: Daniel W. S. Almeida To: Frank.li@nxp.com, corbet@lwn.net, shawnguo@kernel.org, s.hauer@pengutronix.de, kernel@pengutronix.de, festevam@gmail.com, linux-imx@nxp.com Cc: "Daniel W. S. Almeida" , linux-arm-kernel@lists.infradead.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, skhan@linuxfoundation.org, linux-kernel-mentees@lists.linuxfoundation.org Subject: [RFC PATCH] Documentation: perf: fix kernel-doc warnings in imx-ddr.rst Date: Thu, 7 Nov 2019 15:57:55 -0300 Message-Id: <20191107185755.29586-1-dwlsalmeida@gmail.com> X-Mailer: git-send-email 2.24.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: "Daniel W. S. Almeida" Unexpected indentation errors were reported due to missing blank lines. Now fixed. No change in content otherwise. Signed-off-by: Daniel W. S. Almeida --- Documentation/admin-guide/perf/imx-ddr.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/admin-guide/perf/imx-ddr.rst b/Documentation/admin-guide/perf/imx-ddr.rst index 517a205abad6..75c8b46ba6f9 100644 --- a/Documentation/admin-guide/perf/imx-ddr.rst +++ b/Documentation/admin-guide/perf/imx-ddr.rst @@ -18,6 +18,7 @@ The "format" directory describes format of the config (event ID) and config1 devices/imx8_ddr0/format/. The "events" directory describes the events types hardware supported that can be used with perf tool, see /sys/bus/event_source/ devices/imx8_ddr0/events/. + e.g.:: perf stat -a -e imx8_ddr0/cycles/ cmd perf stat -a -e imx8_ddr0/read/,imx8_ddr0/write/ cmd @@ -31,16 +32,19 @@ in the driver. Filter is defined with two configuration parts: --AXI_ID defines AxID matching value. --AXI_MASKING defines which bits of AxID are meaningful for the matching. + 0:corresponding bit is masked. 1: corresponding bit is not masked, i.e. used to do the matching. AXI_ID and AXI_MASKING are mapped on DPCR1 register in performance counter. When non-masked bits are matching corresponding AXI_ID bits then counter is incremented. Perf counter is incremented if + AxID && AXI_MASKING == AXI_ID && AXI_MASKING This filter doesn't support filter different AXI ID for axid-read and axid-write event at the same time as this filter is shared between counters. + e.g.:: perf stat -a -e imx8_ddr0/axid-read,axi_mask=0xMMMM,axi_id=0xDDDD/ cmd perf stat -a -e imx8_ddr0/axid-write,axi_mask=0xMMMM,axi_id=0xDDDD/ cmd @@ -48,5 +52,6 @@ in the driver. NOTE: axi_mask is inverted in userspace(i.e. set bits are bits to mask), and it will be reverted in driver automatically. so that the user can just specify axi_id to monitor a specific id, rather than having to specify axi_mask. + e.g.:: perf stat -a -e imx8_ddr0/axid-read,axi_id=0x12/ cmd, which will monitor ARID=0x12 -- 2.24.0