From nobody Tue Nov 26 17:29:48 2024 Received: from mail-yw1-f201.google.com (mail-yw1-f201.google.com [209.85.128.201]) (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 B24B11C1AC0 for ; Thu, 17 Oct 2024 06:36:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729146976; cv=none; b=L4z6F0xT2Xr8BNKby/Th51hgZnaOgkZJ4yGha6W0J33kP8B6xOWyUa0C9VK8EpNMUnF/yRjjmklQ/Ctpv/k82zCIeBnSAmAwiIyCWCJPQ8hHi3tc8mQ/xGNs0cswNt8QPt+xuL1cx47x4xmlmbQ8/N15GtAUvAjXii+AEM1LnEk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1729146976; c=relaxed/simple; bh=NsEtgw/CJP+vWxhnvnmyKpgsDQikpVmmCdzQcCK46q0=; h=Date:In-Reply-To:Message-Id:Mime-Version:References:Subject:From: To:Content-Type; b=HfAbPIijF9CUp0xZXLatrEZZAdE8s8vfYqx+0LLeNIBll3q0+QrEFFZW3T68OLcS344IYTLTKGh5WTbNR0N0b2WnMqsSjd9zpPowv+83CC0fKO5pSIAfc/ov1+XKArkZEODCc6VliiAL8DHUo4kTCD2EVj4RAScm4zvUAR0PgGc= 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=xbkLaDZG; arc=none smtp.client-ip=209.85.128.201 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="xbkLaDZG" Received: by mail-yw1-f201.google.com with SMTP id 00721157ae682-6e2e5e376fcso14473567b3.2 for ; Wed, 16 Oct 2024 23:36:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1729146973; x=1729751773; darn=vger.kernel.org; h=to:from:subject:references:mime-version:message-id:in-reply-to:date :from:to:cc:subject:date:message-id:reply-to; bh=LP+cSsClwrfeGY5lVINq2DuZ9v0AJGV/q8mYM74dFsk=; b=xbkLaDZGVTZFjYccd55qBuyra1VC6PrhdyInyfCbBTTvDVy2OhpgB0h7+MZp9cqqtw rh1dVymQpxu28Jn4uSveyA+5KvKEFNESlPLahqbw6FLO/Y/FAkEasBnkPDBTBbD46Q42 w3ZhoGTDmsfIjlRM3ZS7ks9UQ2FCcgmZFRNlZXeEXbLHSUKqfY2o4PdiLUDKPkWja847 tHTb1vFbJC9cMSnJkU7owgDTjb+dpmh3Y0CijCYrH8Ub/8qU8sxqmyojWI4MaQhCI/dK QcvgxYVNQE/HVAALdx56Bv/M8eU+7FtSoqU6dC0w5NQgrCHQ9MkkEaoxJuTbLPC0uXPt 0Avw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1729146973; x=1729751773; h=to:from:subject:references:mime-version:message-id:in-reply-to:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=LP+cSsClwrfeGY5lVINq2DuZ9v0AJGV/q8mYM74dFsk=; b=IRjBPxekn3KFrm8TC66uYJjtpd/P2SD6+WKQ6Sr5UKN9FAR5Ypcn/C4YMB0dhDdpVm gdgkcbGzxT6Lgufc+RQPJxnazl7/83XMOGt7pOLIxkerdTDnALBM6eCS1A5v4woaNcfE qbxoxsAM65y8wkrYM8UuNhplqcYBY6Znegit9KIx33cr+Vx9blj9icsPM8Yxxgst0LZO lavPkqsv/y/W0o++W7omKDqyudBh5POlR/levZ3ealHxG5d9vC898CW33qodtwneOLK7 h8iBC2l2g5J58sML77Krqt9aeTPhyC84DWT2TPtq1jKKD5nnT4a4Eqi0XJnV/cgzDfhz xKnw== X-Forwarded-Encrypted: i=1; AJvYcCUJQf+ikF4n2dc5Ml9Xs7n0zqr+JyFmZIMPQOznkURToTov+sWr7wdf26Yz4w/0hINeQZGUsMeI11sJNdE=@vger.kernel.org X-Gm-Message-State: AOJu0YzKk8w16w2Ebz/NkaY0py0CiueQMnlkhlkUNGBgH9eTUwo+vxZL dJCveizTLeUZZ7ElC1I1d7TJ02pjniM5vWZLNRmOYHjfZOIUC8dAG1agQXBvYxYiikCpIAhEdJB zdUkLEw== X-Google-Smtp-Source: AGHT+IFh/DwzJxNwyNBb88Qd8pE9dOxJnoqNpWZY4e7FOxNmTYaPoDIFzsaEM3UF2fO9xSxiLmo6I0/JT5cJ X-Received: from irogers.svl.corp.google.com ([2620:15c:2c5:11:98a5:142e:8c2e:e9e5]) (user=irogers job=sendgmr) by 2002:a05:690c:6e0a:b0:6e3:345e:5f89 with SMTP id 00721157ae682-6e3d3bdc32bmr1475887b3.0.1729146973536; Wed, 16 Oct 2024 23:36:13 -0700 (PDT) Date: Wed, 16 Oct 2024 23:35:55 -0700 In-Reply-To: <20241017063555.366065-1-irogers@google.com> Message-Id: <20241017063555.366065-6-irogers@google.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 References: <20241017063555.366065-1-irogers@google.com> X-Mailer: git-send-email 2.47.0.105.g07ac214952-goog Subject: [PATCH v5 5/5] perf docs: Document tool and hwmon events From: Ian Rogers To: Peter Zijlstra , Ingo Molnar , Arnaldo Carvalho de Melo , Namhyung Kim , Mark Rutland , Alexander Shishkin , Jiri Olsa , Ian Rogers , Adrian Hunter , Kan Liang , Ravi Bangoria , Weilin Wang , Yoshihiro Furudera , James Clark , Athira Jajeev , Howard Chu , Oliver Upton , Changbin Du , Ze Gao , Junhao He , linux-kernel@vger.kernel.org, linux-perf-users@vger.kernel.org Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add a few paragraphs on tool and hwmon events. Signed-off-by: Ian Rogers --- tools/perf/Documentation/perf-list.txt | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/tools/perf/Documentation/perf-list.txt b/tools/perf/Documentat= ion/perf-list.txt index 14621f39b375..d0c65fad419a 100644 --- a/tools/perf/Documentation/perf-list.txt +++ b/tools/perf/Documentation/perf-list.txt @@ -243,6 +243,21 @@ For accessing trace point events perf needs to have re= ad access to /sys/kernel/tracing, even when perf_event_paranoid is in a relaxed setting. =20 +TOOL/HWMON EVENTS +----------------- + +Some events don't have an associated PMU instead reading values +available to software without perf_event_open. As these events don't +support sampling they can only really be read by tools like perf stat. + +Tool events provide times and certain system parameters. Examples +include duration_time, user_time, system_time and num_cpus_online. + +Hwmon events provide easy access to hwmon sysfs data typically in +/sys/class/hwmon. This information includes temperatures, fan speeds +and energy usage. + + TRACING ------- =20 --=20 2.47.0.105.g07ac214952-goog