From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mx0b-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2B4FB3B9929 for ; Wed, 1 Jul 2026 08:38:36 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=148.163.158.5 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782895118; cv=none; b=aX04Gj3SXIzuLb7x5WG+W+cXHqa/jdmIq6xd66jEPNyog66VNHx0A369ycgaFgQAtkgs71eoWUWbvIsxaYg2CQiAGrX683s2jWMX8NZsWlhs4nN4D/ydDXbHcCeM00doDqP8fmMvasL8P836bZPbFxy4SUoBp3hwn4Uo1fDh8M0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782895118; c=relaxed/simple; bh=ohbvTGgOCFqnOkRMwtrL6/iLhp2TxeTAVUaMgbNfqzE=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=uAArRJ7REBTm6NeWOmT13Uu5qNMCrJjRty6qTsjB5ttEbCe7sZ1orGaaW48hmeqFW0YLtlZq9GG6XiO61iiKQTh/ayuGcZYcNy3BgHOn07toO9j41oRlzZk+OApqZh03iahq9Q+JWQxOHCeLHRHu+Bo2lxF4XpeX8zH1Bpqnngk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.ibm.com; spf=pass smtp.mailfrom=linux.ibm.com; dkim=pass (2048-bit key) header.d=ibm.com header.i=@ibm.com header.b=JOlOcU4i; arc=none smtp.client-ip=148.163.158.5 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.ibm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.ibm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=ibm.com header.i=@ibm.com header.b="JOlOcU4i" Received: from pps.filterd (m0356516.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 6618Ih2r236526; Wed, 1 Jul 2026 08:38:33 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=cc :content-transfer-encoding:date:from:in-reply-to:message-id :mime-version:references:subject:to; s=pp1; bh=VqGMFuUT6g3w1AWT/ gPGiHpUT3ls0dKUM6LylJMzlLI=; b=JOlOcU4igrT4ERmTIfDN8aVcj3KLhROBV E6KJ8tlsrpcowWu+heCumuidHKY83xAb5uTQovxXd07bw1DZYoQw/+397Dk8T9lc vsF8N3RTo5hLwvel2QUPsBiAey2MgI8azS9YQPbzCcbFkeU4PYs6CYqPqyorDn0T orDjNjpMRcAlbf3Tl0P5qxAnXJBP2lWDVOZmCV/FNXlbta5flR0MhTVom62ltHVq 6+of2U73FKLJI87y+LvZOu7/XD0ChdGs1jyqmf/UYNxRPQmk8MDOP8uHjXGLO7Da n0tVnrHwwgcMxzzhpR/9TmncYy7xz1ngokDmuayt6vQbXuUlLPIOQ== Received: from ppma11.dal12v.mail.ibm.com (db.9e.1632.ip4.static.sl-reverse.com [50.22.158.219]) by mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 4f26qa34y4-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 01 Jul 2026 08:38:33 +0000 (GMT) Received: from pps.filterd (ppma11.dal12v.mail.ibm.com [127.0.0.1]) by ppma11.dal12v.mail.ibm.com (8.18.1.7/8.18.1.7) with ESMTP id 6618Ychl000663; Wed, 1 Jul 2026 08:38:32 GMT Received: from smtprelay01.fra02v.mail.ibm.com ([9.218.2.227]) by ppma11.dal12v.mail.ibm.com (PPS) with ESMTPS id 4f2uhye6my-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 01 Jul 2026 08:38:32 +0000 (GMT) Received: from smtpav05.fra02v.mail.ibm.com (smtpav05.fra02v.mail.ibm.com [10.20.54.104]) by smtprelay01.fra02v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id 6618cQr150397680 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 1 Jul 2026 08:38:26 GMT Received: from smtpav05.fra02v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B7BD020040; Wed, 1 Jul 2026 08:38:26 +0000 (GMT) Received: from smtpav05.fra02v.mail.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 77C2E2004B; Wed, 1 Jul 2026 08:38:24 +0000 (GMT) Received: from localhost.localdomain (unknown [9.124.212.11]) by smtpav05.fra02v.mail.ibm.com (Postfix) with ESMTP; Wed, 1 Jul 2026 08:38:24 +0000 (GMT) From: Athira Rajeev To: linuxppc-dev@lists.ozlabs.org, maddy@linux.ibm.com Cc: linux-perf-users@vger.kernel.org, atrajeev@linux.ibm.com, hbathini@linux.vnet.ibm.com, tejas05@linux.ibm.com, venkat88@linux.ibm.com, tshah@linux.ibm.com Subject: [PATCH 4/5] docs: ABI: sysfs-bus-event_source-devices-htm: Document sysfs event format entries for htm pmu Date: Wed, 1 Jul 2026 14:08:05 +0530 Message-Id: <20260701083806.79358-5-atrajeev@linux.ibm.com> X-Mailer: git-send-email 2.39.5 (Apple Git-154) In-Reply-To: <20260701083806.79358-1-atrajeev@linux.ibm.com> References: <20260701083806.79358-1-atrajeev@linux.ibm.com> Precedence: bulk X-Mailing-List: linux-perf-users@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-TM-AS-GCONF: 00 X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNzAxMDA4NCBTYWx0ZWRfX13mx/TZzTCTe pxaaJLCZZRvnYiM/enFQHRhL6nuXy96i/uKJX4Cl1/ZjNrx9ghGtDUzZjduZJj6tRN/+gXGjXt4 KZmqEkleeuAgbFtGOvjJG/kycZ4BnsN2kyiZ63Y+FddCo3xzdBVzCizz5DWeRRr6GNLAzQvPTIn SsmkS6P+yZEbDAgTW3D7tgQkfSUFKx8xSruONBuItLQp/Kc5qwndN2pwdexBIsFmKwUXjyoeBmN q4XxOGMPohEAGp77YCQISYE4QFZ/knyWM4CNbDX0BKiETDYza7RYII1h3M1HoJYrONIlgDFBpvy DRSpVTLa+8ULSNuV+sARK2uPRkXZngw1QTJPOrT/5QwFVgY20wEJT2sc/BHveoQuPlOmIJbAprh K62bQVlmuMCyNRk2L7wkZY1SicVdiStVJCx/mokZ9PxoJ7V0z7NCWZAO8EUNfGNj131bixERMlm wtWPxJVk1kULXN1Mm8g== X-Proofpoint-Spam-Info: AW1haW4tMjYwNzAxMDA4NCBTYWx0ZWRfX7jCAnzO9pRPC IAi1+Ao0qCLtLzW/mqVuwMbxI/BM2a8kLQbBvN+hsLYNJsHiUuyhLZ8tLTg7jzALR1yRe65CSMe Cc0wAQ2zqJT7nIHjcBJa0Y2T+R/y8jY= X-Proofpoint-GUID: fl_15Np0M90CMsAiuk4Llo9nsAxuLs9C X-Proofpoint-ORIG-GUID: fl_15Np0M90CMsAiuk4Llo9nsAxuLs9C X-Authority-Analysis: v=2.4 cv=WZ88rUhX c=1 sm=1 tr=0 ts=6a44d209 cx=c_pps a=aDMHemPKRhS1OARIsFnwRA==:117 a=aDMHemPKRhS1OARIsFnwRA==:17 a=RAioF0-LDSMA:10 a=VkNPw1HP01LnGYTKEx00:22 a=RnoormkPH1_aCDwRdu11:22 a=Y2IxJ9c9Rs8Kov3niI8_:22 a=VnNF1IyMAAAA:8 a=voM4FWlXAAAA:8 a=aXd4d0V2UHYFZ3CtnQMA:9 a=IC2XNlieTeVoXbcui8wp:22 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.125,FMLib:17.12.100.49 definitions=2026-07-01_02,2026-06-26_01,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 adultscore=0 phishscore=0 clxscore=1015 bulkscore=0 impostorscore=0 priorityscore=1501 lowpriorityscore=0 suspectscore=0 malwarescore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606150000 definitions=main-2607010084 Details are added for the htm pmu event and format attributes in the ABI documentation. Signed-off-by: Athira Rajeev --- .../sysfs-bus-event_source-devices-htm | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-bus-event_source-devices-htm diff --git a/Documentation/ABI/testing/sysfs-bus-event_source-devices-htm b/Documentation/ABI/testing/sysfs-bus-event_source-devices-htm new file mode 100644 index 000000000000..784ba7c31b89 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-htm @@ -0,0 +1,21 @@ +What: /sys/bus/event_source/devices/htm/format +Date: June 2026 +Contact: Linux on PowerPC Developer List +Description: Read-only. Attribute group to describe the magic bits + that go into perf_event_attr.config for a particular pmu. + (See ABI/testing/sysfs-bus-event_source-devices-format). + + Each attribute under this group defines a bit range of the + perf_event_attr.config. Supported attribute are listed + below:: + + event = "config:0-27" - event ID + +What: /sys/bus/event_source/devices/htm/events +Date: June 2026 +Contact: Linux on PowerPC Developer List +Description: (RO) Attribute group to describe performance monitoring events + for the Hardware Trace Macro (HTM) trace. Each attribute in + this group describes a single performance monitoring event + supported by htm pmu. The name of the file is the name of + the event (See ABI/testing/sysfs-bus-event_source-devices-events). -- 2.52.0