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;
From:   Kim Phillips <kim.phillips@amd.com>
To:     Arnaldo Carvalho de Melo <acme@redhat.com>, kim.phillips@amd.com
Cc:     Peter Zijlstra <peterz@infradead.org>,
        Ingo Molnar <mingo@redhat.com>,
        Arnaldo Carvalho de Melo <acme@kernel.org>,
        Mark Rutland <mark.rutland@arm.com>,
        Alexander Shishkin <alexander.shishkin@linux.intel.com>,
        Jiri Olsa <jolsa@redhat.com>,
        Namhyung Kim <namhyung@kernel.org>,
        Adrian Hunter <adrian.hunter@intel.com>,
        Stephane Eranian <eranian@google.com>,
        Alexey Budankov <alexey.budankov@linux.intel.com>,
        Tony Jones <tonyj@suse.de>, Jin Yao <yao.jin@linux.intel.com>,
        Ian Rogers <irogers@google.com>,
        "Paul A. Clarke" <pc@us.ibm.com>, linux-perf-users@vger.kernel.org,
        linux-kernel@vger.kernel.org, stable@vger.kernel.org
Subject: [PATCH] perf record/stat: Explicitly call out event modifiers in the documentation
Date:   Tue,  1 Sep 2020 16:58:53 -0500
Message-Id: <20200901215853.276234-1-kim.phillips@amd.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
Received: from 255.255.255.255 (255.255.255.255) by SN4PR0501CA0071.namprd05.prod.outlook.com (2603:10b6:803:41::48) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3348.8 via Frontend Transport; Tue, 1 Sep 2020 21:59:03 +0000
X-Mailer: git-send-email 2.27.0
X-Originating-IP: [165.204.77.11]
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-HT: Tenant
X-MS-Office365-Filtering-Correlation-Id: cae1b2fa-94db-4c40-c201-08d84ec23eb9
X-MS-TrafficTypeDiagnostic: BN6PR1201MB0019:
X-MS-Exchange-Transport-Forked: True
X-Microsoft-Antispam-PRVS: <BN6PR1201MB0019B3557E025E30B419A0FE872E0@BN6PR1201MB0019.namprd12.prod.outlook.com>
X-MS-Oob-TLC-OOBClassifiers: OLM:6430;
X-MS-Exchange-SenderADCheck: 1
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: Fj4l9gZzxNabIAPtKAILYmSCLLMCusm0J6zokuO08FMJCuHXqA59fl6W1tDdZeLDTjjBk6vijs+CCFXKFsYV+i9VSYMM/Tf/sH/ayI4mm4HVwtgEwEcT+TKwvYUe2ewESWh7+X+WkkgNZaNOvCsU/E+CiJF71ONgqcLnK+AtL/bzCvnFYhvCaH4OrWM9ekUD6/gr9Md6wE8oSSVxvvqFORw/VAyX6354yvVWRZe6kSfna89Z02OTkFHAl7xGdVH7+tj7gMkelsDYWdXNcyngm32XEI+m0cqNI4iuyXIbWoWZucd4y9D33h16gpZ46Z61wY6jsOqr7uoB7DCLNINb5A==
X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:BN8PR12MB2946.namprd12.prod.outlook.com;PTR:;CAT:NONE;SFS:(4636009)(376002)(346002)(39860400002)(366004)(396003)(136003)(2616005)(66476007)(66946007)(4326008)(5660300002)(2906002)(186003)(956004)(26005)(16576012)(316002)(1076003)(8936002)(478600001)(52116002)(86362001)(66556008)(6666004)(44832011)(36756003)(8676002)(7416002)(54906003)(6486002);DIR:OUT;SFP:1101;
X-MS-Exchange-AntiSpam-MessageData: CgCEz1ZOUa8UDWRPo3UeVWP+fa+l1FIq8czHvK137kIVq0lOiPAk7Ixjer8HNVex3Mlae1LjUh7opUGR2Ao3tD9eYw85z42+wlg9iKUhgu+QuyAkOhgBtWeaRNmPFaSmL3oPBNDMZoLuOHVUspDYiQ8PqpEvgGjY5RHOUPcnt4l08i8UHg9hS3OCSWWVUQO7c79eNhi38/dTTU2HfUOHv97MNZOUcsT8sqYovl9VcM42C2GU0Qj9CbakD464QKPHO9oEGOM2JvmZBhRCy6YHTY9JeQLIt/DUkJKjV3QoUtOi1CTHot98fsyteSxLoY4poAVhYfeW64VIZ2PvhL67sTyiw5LPshsCQ+15S7HXdWRWSEFMb3jOSLuJ5XERLM7uKIcL2yZYpF5blbmgwEawezaCY4o/tG2/nGnnuwVfSMQ5O4PWZKzSXkW1PMTD7lhyG2N/A5+6bdvj8BtlloW2u/PFVN1ldMUQs1Udbj5WiSLrRn/2mlcSXEc5eSOluILkcGEKu3hpkBTyDbtZSZ6glqBWuQAR3QAJQHfkkeWrZkrpzJckAv//6L524USpFegQkbw2yNHqxyus1XE4uJPd+ivAaKvVapUPMRv70ze+x+jUfPuRudhcrtpE4rDR+MfvzSXK2RNzskx/eqrh5c2uJg==
X-OriginatorOrg: amd.com
X-MS-Exchange-CrossTenant-Network-Message-Id: cae1b2fa-94db-4c40-c201-08d84ec23eb9
X-MS-Exchange-CrossTenant-AuthSource: BN8PR12MB2946.namprd12.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 01 Sep 2020 21:59:05.7617
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: UjJvm6SAI9sjvIKHnBr/lO1R/zl49obcvVsmDFJ7/ngWzyfW4xAwV0R8mzrbrNse+tTQ8roYVq9ECf3cAXBfDQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN6PR1201MB0019
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

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.

Signed-off-by: Kim Phillips <kim.phillips@amd.com>
Fixes: 2055fdaf8703 ("perf list: Document precise event sampling for AMD IBS")
Cc: Peter Zijlstra <peterz@infradead.org> 
Cc: Ingo Molnar <mingo@redhat.com> 
Cc: Arnaldo Carvalho de Melo <acme@kernel.org> 
Cc: Mark Rutland <mark.rutland@arm.com> 
Cc: Alexander Shishkin <alexander.shishkin@linux.intel.com> 
Cc: Jiri Olsa <jolsa@redhat.com> 
Cc: Namhyung Kim <namhyung@kernel.org> 
Cc: Adrian Hunter <adrian.hunter@intel.com> 
Cc: Stephane Eranian <eranian@google.com> 
Cc: Alexey Budankov <alexey.budankov@linux.intel.com> 
Cc: Tony Jones <tonyj@suse.de> 
Cc: Jin Yao <yao.jin@linux.intel.com> 
Cc: Ian Rogers <irogers@google.com> 
Cc: "Paul A. Clarke" <pc@us.ibm.com> 
Cc: linux-perf-users@vger.kernel.org
Cc: linux-kernel@vger.kernel.org
Cc: stable@vger.kernel.org
---
 tools/perf/Documentation/perf-record.txt | 4 ++++
 tools/perf/Documentation/perf-stat.txt   | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/tools/perf/Documentation/perf-record.txt b/tools/perf/Documentation/perf-record.txt
index 3f72d8e261f3..bd50cdff08a8 100644
--- 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/<pmu>/format/*.
diff --git a/tools/perf/Documentation/perf-stat.txt b/tools/perf/Documentation/perf-stat.txt
index c9bfefc051fb..a4b1d11fefc8 100644
--- 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/<pmu>/format/*
-- 
2.27.0