Received: by 2002:a05:6a10:22f:0:0:0:0 with SMTP id 15csp4116212pxk; Tue, 8 Sep 2020 11:06:20 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzi/mhRFPTBmxTuDbfcOYzvMCJxS/o7/tbx4UuITIZ+vkA+UyGg9LWJMfrIyIxVFioQA3RU X-Received: by 2002:a17:906:6d4c:: with SMTP id a12mr26229485ejt.64.1599588380636; Tue, 08 Sep 2020 11:06:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1599588380; cv=none; d=google.com; s=arc-20160816; b=SGibRgS2Kzt0QjD+Vi8b0z8g87iC2aJrmuieADN/XCZx1tACBuKW8HYGITrV1rd9zB AFgPe1E0tHwUaizuGtQ3gG6Q9TlsBUhd7BzF8WpcjHXzQuwl1Q70uCWaFothaSnDXQ4e aUPFsiePWN2FKKtNVroNSnD774fR1WQCP+ztUuAXiihgK/dx/HYp8FZ0u294GpNRPct0 uh+zamxG6hkjIY0FmZawRIE3lwEIUzWUN44fAYCjPNaUHgIoiy47ZWBFPtXIdzpvgVeb VBLvSL04BK3yFNIAl5cVMwObxkFsNmVPRCiywgQKyyHciR26PePJVLjY1uEtUfT8eFBi bYsQ== 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 :user-agent:references:in-reply-to:message-id:date:subject:cc:to :from:dkim-signature; bh=2Yfegq4+xVIvpstSjRfBoL0TwUNXn5zPaWvN1hd4bL4=; b=OnHNTTSSRWDHObGpGorO8vkWW8eXP6JZODxaoPSPjCQ9FlhmHsgKuWcguQVe7EQZ1n OBqGhbJnVtBfnz41dQGbowBG5KSxUXTtBCJK1OkTr5nR7J1vPHYQoMooAnUZZAuinMVC 87+gfVpLpWbP6y+yCQvqLoIzDPTGdrVhU8ha/CRy4VD+QN1MD2a4Cp2orPiHko1XV7jk ipDEe4CxcZf11r99+Tf2pBbBvXTDMU906IfF4UfsjS8ysawA13RnH8++movheZ4aNXNv iiDAQWTzDtNISD8/3kSy+37ryazRRnbT0wLFvWf7hj13548x9x0RqQQfiaGngBRpTQYi Qvmg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=vHczBkCd; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linuxfoundation.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id dp12si9025420ejc.155.2020.09.08.11.05.58; Tue, 08 Sep 2020 11:06:20 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=vHczBkCd; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linuxfoundation.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1732134AbgIHSEq (ORCPT + 99 others); Tue, 8 Sep 2020 14:04:46 -0400 Received: from mail.kernel.org ([198.145.29.99]:55394 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1731525AbgIHQMK (ORCPT ); Tue, 8 Sep 2020 12:12:10 -0400 Received: from localhost (83-86-74-64.cable.dynamic.v4.ziggo.nl [83.86.74.64]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id A39A2247BD; Tue, 8 Sep 2020 15:51:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1599580284; bh=Qoayjoiq0uSKgxLGXmLIhulkMjEAiiCj6O1lrgz1Tlc=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=vHczBkCd87lGh72ECWimUP+jO0BpRQL7NKLePr0ZdKGmZ7BOpHP0Pb8kmXnvI3ogb yMESldtRKXZhViwMskFO40FR618A4TIZxS8EhfYaQHOaYnFMl26bTAV5VtyGR1pBhU 9GWD58rEL7Jz1z64GRx+IX2gFAnVD+31GW5Tuohk= From: Greg Kroah-Hartman To: linux-kernel@vger.kernel.org Cc: Greg Kroah-Hartman , stable@vger.kernel.org, Kim Phillips , Adrian Hunter , Alexander Shishkin , Alexey Budankov , Ian Rogers , Jin Yao , Jiri Olsa , Mark Rutland , Namhyung Kim , Paul Clarke , Peter Zijlstra , Stephane Eranian , Tony Jones , Arnaldo Carvalho de Melo Subject: [PATCH 4.14 03/65] perf record/stat: Explicitly call out event modifiers in the documentation Date: Tue, 8 Sep 2020 17:25:48 +0200 Message-Id: <20200908152217.194473530@linuxfoundation.org> X-Mailer: git-send-email 2.28.0 In-Reply-To: <20200908152217.022816723@linuxfoundation.org> References: <20200908152217.022816723@linuxfoundation.org> User-Agent: quilt/0.66 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: Kim Phillips commit e48a73a312ebf19cc3d72aa74985db25c30757c1 upstream. Event modifiers are not mentioned in the perf record or perf stat manpages. Add them to orient new users more effectively by pointing them to the perf list manpage for details. Fixes: 2055fdaf8703 ("perf list: Document precise event sampling for AMD IBS") Signed-off-by: Kim Phillips Cc: Adrian Hunter Cc: Alexander Shishkin Cc: Alexey Budankov Cc: Ian Rogers Cc: Jin Yao Cc: Jiri Olsa Cc: Mark Rutland Cc: Namhyung Kim Cc: Paul Clarke Cc: Peter Zijlstra Cc: Stephane Eranian Cc: Tony Jones Cc: stable@vger.kernel.org Link: http://lore.kernel.org/lkml/20200901215853.276234-1-kim.phillips@amd.com Signed-off-by: Arnaldo Carvalho de Melo Signed-off-by: Greg Kroah-Hartman --- tools/perf/Documentation/perf-record.txt | 4 ++++ tools/perf/Documentation/perf-stat.txt | 4 ++++ 2 files changed, 8 insertions(+) --- a/tools/perf/Documentation/perf-record.txt +++ b/tools/perf/Documentation/perf-record.txt @@ -33,6 +33,10 @@ OPTIONS - a raw PMU event (eventsel+umask) in the form of rNNN where NNN is a hexadecimal event descriptor. + - a symbolic or raw PMU event followed by an optional colon + and a list of event modifiers, e.g., cpu-cycles:p. See the + linkperf:perf-list[1] man page for details on event modifiers. + - a symbolically formed PMU event like 'pmu/param1=0x3,param2/' where 'param1', 'param2', etc are defined as formats for the PMU in /sys/bus/event_source/devices//format/*. --- a/tools/perf/Documentation/perf-stat.txt +++ b/tools/perf/Documentation/perf-stat.txt @@ -39,6 +39,10 @@ report:: - a raw PMU event (eventsel+umask) in the form of rNNN where NNN is a hexadecimal event descriptor. + - a symbolic or raw PMU event followed by an optional colon + and a list of event modifiers, e.g., cpu-cycles:p. See the + linkperf:perf-list[1] man page for details on event modifiers. + - a symbolically formed event like 'pmu/param1=0x3,param2/' where param1 and param2 are defined as formats for the PMU in /sys/bus/event_source/devices//format/*