From nobody Thu Feb 12 23:17:33 2026 Received: from mail-yw1-f202.google.com (mail-yw1-f202.google.com [209.85.128.202]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 50FEC1EB48 for ; Thu, 6 Jun 2024 04:50:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.202 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1717649431; cv=none; b=XEix1cd2RjqLpuEnQM4Jhd/eERPk/4DgUjs+os5wHzWWC8vzCAUac0WqBf6+NGxMn9OQbLwJTZ6AlmWEfKMrwdzUcdaDwO/wQXKMsmw1MWFnBWdgCEXidWFQK0658V0EqWNcBFdw5hEdxlbE6z2mi/FxxuNIezH53+QsLPQr1hw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1717649431; c=relaxed/simple; bh=US+QMTUc3wd/lRECrzRRq/Jrw2igRhAZggK2xtNfDeY=; h=Date:Message-Id:Mime-Version:Subject:From:To:Content-Type; b=lQ/e02c4JxsbaEo/GpZdzq8XXzKb6Umd28rLktojOPHpHxgXExPbFT2VGInWUgqhlegumkvRL1apU66BFu/La2rS8iPaodhDE3iSafRUup+0TrAMPjSZfF68McFYWWWLa/J+Ee4eEZw13q9P8SdioECQfH26Lu5j8YaM+kBZWd8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--irogers.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=wmimBJ7f; arc=none smtp.client-ip=209.85.128.202 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--irogers.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="wmimBJ7f" Received: by mail-yw1-f202.google.com with SMTP id 00721157ae682-62a2aec8521so8634607b3.0 for ; Wed, 05 Jun 2024 21:50:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1717649429; x=1718254229; darn=vger.kernel.org; h=to:from:subject:mime-version:message-id:date:from:to:cc:subject :date:message-id:reply-to; bh=sU/hwIG64bV5IWEExdmUt3ZFDG1ToaRtz2uIVfkz1z8=; b=wmimBJ7fLk5+f1TRLT+Lo+L18enf0LdIMzDnAOu0l0KOdsIYGFD7Ri4TTe+HMD1gGp IRDrtzp4m+77BczAgZg5Cl9EM7EfIankbNEdQBmDHnbJ1maCM1dk8klE2XJiRWsaFa8E mSynZjTse3NBZ+5+MCjekBed/yDMpbxN8ifpa57u8uZKWZG7CPvBdW08xbjuB5hKTR6k dVGcILF3nEgFc1HeffEFpKyB7rxvJ87e2M2o3nFn4froxee2VeMrMMJq+HNpMwdtP/9c abgthRPK1dCvFD3iitDEAU1jNJXL6BREya58PUtDjBEAggXgbDJ41qYBJ7P58L0k12iN 1y7A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1717649429; x=1718254229; h=to:from:subject:mime-version:message-id:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=sU/hwIG64bV5IWEExdmUt3ZFDG1ToaRtz2uIVfkz1z8=; b=JrnecNBdfSlbAdvckwRfPfZ/XM+LVhxMX0770THBoHLDu4C1UJyGecrfDJCrGS6FHe WyJ3U9iHKNL4bsCwZq4n1FG2BPIOkT0jEiEzAKuYWN57aODqR3qnYcdo4xMxXwWDzXFQ SSr2JOhXyUeBdZmv+farmPKTG82JBpZl90gawscM3gKOjoIr6wEPBWiq4NeyZIrfUOIu gA15ZJtEoWrtsyFkVgTahDO1N5HrONuby76zVZbIcssNiKCU7cfk6XkBG38Aw3aEBm9K TbkmW1SZQGKrkQMI6lPrmDRg9D1DdfdUzYN0TEUBKTXMD9HhhrfIij5G1exFBXmvVG0B gpwQ== X-Forwarded-Encrypted: i=1; AJvYcCWxlE7u0v8rRGBX8JVs0mead2mFMxHPirgHu4ic7VkTF1PEC38s/eyCpQRWUAP9RaZVhRWbKbh2/mbLdGanZPEU2OKHK5Hr5BWligEW X-Gm-Message-State: AOJu0Yy1e04+UuQIt7V9Dgjh/Y8moGJTmCqrSlVIJVPYeKjWUN1rAC+M mu2F5OBc6PVHNG5BlGaPIUfA6QA5oS1ZSHtdch5OKgZQipLgzytE9J8Eui4UnFfF5w+aMkeM0DO I3Rn2dA== X-Google-Smtp-Source: AGHT+IFIdAmSjHSPbLuhpCiNynPVxG4bwwIVKPhcB5sVsgFMEOnEMx0c8t1g9bC4Cq84jxLbBT6+FwEIvit+ X-Received: from irogers.svl.corp.google.com ([2620:15c:2a3:200:86ae:b6a7:27de:e7df]) (user=irogers job=sendgmr) by 2002:a05:690c:6604:b0:61b:ec22:8666 with SMTP id 00721157ae682-62cbb309e50mr12877617b3.0.1717649429253; Wed, 05 Jun 2024 21:50:29 -0700 (PDT) Date: Wed, 5 Jun 2024 21:49:59 -0700 Message-Id: <20240606044959.335715-1-irogers@google.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 X-Mailer: git-send-email 2.45.1.467.gbab1589fc0-goog Subject: [RFC PATCH v2] perf Documentation: Describe the PMU naming convention From: Ian Rogers To: Randy Dunlap , Tuan Phan , Robin Murphy , Thomas Richter , Bhaskara Budiredla , Bharat Bhushan , Peter Zijlstra , Ingo Molnar , Arnaldo Carvalho de Melo , Namhyung Kim , Mark Rutland , Alexander Shishkin , Jiri Olsa , Ian Rogers , Adrian Hunter , Kan Liang , James Clark , Ravi Bangoria , linux-perf-users@vger.kernel.org, linux-kernel@vger.kernel.org, Will Deacon , Stephane Eranian Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" It is an existing convention to use suffixes with PMU names. Try to capture that convention so that future PMU devices may adhere to it. The name of the file and date within the file try to follow existing conventions, particularly sysfs-bus-event_source-devices-events. Signed-off-by: Ian Rogers Reviewed-by: Randy Dunlap Reviewed-by: James Clark Reviewed-by: Kan Liang Reviewed-by: Leo Yan --- .../testing/sysfs-bus-event_source-devices | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-bus-event_source-devices diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices b/Doc= umentation/ABI/testing/sysfs-bus-event_source-devices new file mode 100644 index 000000000000..79b268319df1 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices @@ -0,0 +1,24 @@ +What: /sys/bus/event_source/devices/ +Date: 2014/02/24 +Contact: Linux kernel mailing list +Description: Performance Monitoring Unit () + + Each directory, for a PMU device, is a name + optionally followed by an underscore and then either a + decimal or hexadecimal number. For example, cpu is a + PMU name without a suffix as is intel_bts, + uncore_imc_0 is a PMU name with a 0 numeric suffix, + ddr_pmu_87e1b0000000 is a PMU name with a hex + suffix. The hex suffix must be more than two + characters long to avoid ambiguity with PMUs like the + S390 cpum_cf. + + Tools can treat PMUs with the same name that differ by + suffix as instances of the same PMU for the sake of, + for example, opening an event. For example, the PMUs + uncore_imc_free_running_0 and + uncore_imc_free_running_1 have an event data_read; + opening the data_read event on a PMU specified as + uncore_imc_free_running should be treated as opening + the data_read event on PMU uncore_imc_free_running_0 + and PMU uncore_imc_free_running_1. --=20 2.45.1.467.gbab1589fc0-goog