From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f181.google.com (mail-pl1-f181.google.com [209.85.214.181]) (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 C1E771531DB for ; Tue, 7 Jan 2025 04:07:51 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.181 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736222874; cv=none; b=PAigvCQvGAZSCqOKZ9eqUDzzYIqgjIHhOwPxrQ8lSgM3Rp44jKOkLYZkTwlH4OJ2kZNOPGnAEpFa2D76VdnNVnaeg4+scv/hodoc19pKNenZOO7XshcYTTp4Y6n4P9hJAw6S6sVVVsLidSjlpTi0z5rA7O2mzf1APqT/uTWgiyw= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1736222874; c=relaxed/simple; bh=4zCJ3HPcN5gKu/Wsg5mqzz9IqKY+qHjGEO3bpZXvQyU=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=UIOUvxkFCXRsDsG3kVlrs509DzG2lUEn4DC6KDx/bugBKWfSmQjeT2D3+a2RREaPq/tH75SEoz6+HzMTfnoZU++uhROOPYKVwH2qH50UjXslEMu86nOWDgxuKMXpFwokFVBedVyWlhQmcl+hpV+0tvyCbjNXCfMKZtbibr7KmeY= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=rivosinc.com; spf=pass smtp.mailfrom=rivosinc.com; dkim=pass (2048-bit key) header.d=rivosinc-com.20230601.gappssmtp.com header.i=@rivosinc-com.20230601.gappssmtp.com header.b=xZuYrrv1; arc=none smtp.client-ip=209.85.214.181 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=rivosinc.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=rivosinc.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=rivosinc-com.20230601.gappssmtp.com header.i=@rivosinc-com.20230601.gappssmtp.com header.b="xZuYrrv1" Received: by mail-pl1-f181.google.com with SMTP id d9443c01a7336-2163bd70069so29049815ad.0 for ; Mon, 06 Jan 2025 20:07:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rivosinc-com.20230601.gappssmtp.com; s=20230601; t=1736222871; x=1736827671; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=G3WA9RC/J2CdgcwvvfKOzrREm+E/JTqa3o3ODJz2qsc=; b=xZuYrrv1rFbVB5sz2ZVH94abPRzxMzgKWSdaEAvBZFp4vD7+oY5lF+WYPCwgyKm07H G9da3PLNcj5nS08stwnOtZJPZNAgo4OxMT6wpfVAnFzAhg/m7RfQQFzsUNYWMEcRtgcm +hAjTz46vO64FOn6BvzyiQ2n71kqTJXC6VoDze55L3BHR+0cHGz1d8zYXahcqby5Zav+ Bm6zre8n3DUpf3f0aNNThSRyAcNygzgT4fDuHwcJH56u9KNa3GMOYMyfvuq4NAut9Xrs zGWLjKGHKdSX/4oKAYksUT1jhC4xxt2eIv+BlIp/CJu2+DitGO757dmlpsobS6FgmCrD iflA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1736222871; x=1736827671; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=G3WA9RC/J2CdgcwvvfKOzrREm+E/JTqa3o3ODJz2qsc=; b=Fi6mco385yB65eIWvCN1ugCWmXPQcPFUNJqhcHcbfuh/WJKuTgPEIZWehPfXUElRpI gt5PVTpZqa3mmLbmFwwofOVzzDPJwO2M3hGnEhRzS5Tf+Sbi3LIz3z3ViMjph+7j7hVt DyB6coxbdqoLFlZ+oG/f1JqEIi/oi3hLgll9WO7a9+EWwz6QLoqiRAGBWOUsJcm3qAEM MVbenNNYLrVmwSYwGRUeZZa1kjOP46wZpBpXDt3rhNKaa+oc9Q0lSk5WVf1+ejaiOLxd 9zyW94gi3aSiQLRxDk6KVW0CGvrBzlvgEmYKMQE+NmOkp6OHbsjLK5smJJc+0F/5L5wl L/sg== X-Forwarded-Encrypted: i=1; AJvYcCWGDCIAYqZq+6hBKByNx6zGxb7Ct0slGULIPY8zRPXZMTbCXLe+DdGlPu/kFqUG8D605EnIuumnctLDOBA=@vger.kernel.org X-Gm-Message-State: AOJu0Yy+XTtHDX+Ax+mITJIMQOAYxsbJfyseVUoaI0NisonMpKTWfK/O YDFs/5VJGANReokMRbRP4xeAyx7/wyhWMkLin6no6B6koMMyHQ+xqQqQAEp/Xoc= X-Gm-Gg: ASbGncsjheOM/dUbHaJeDMNf8CfTOBYsvNw0ioFdzq1XBNn82hHc2rDLNqb8TWPyap4 Gd6xXF8Ido+h7GwgV3EWqc1vOiCsJK6ku4GNZePeCp0l4a6LVJyDoEWIuvEG5SPwq6+u5aVBZL/ sXhh1WO+RTkCoVmy5GVQ8uwdlOQhSIXZr9stkH0LLsFDFH/5xR+/2JlHxpCtgTB55jFob2HmOtJ DdGBYUJTlTXyb4UzWVIF8JXk1jSXFKSJ3nM52gGN8jC5bfPWA5TCuQLSE4Rx4dF2XZvSWjU X-Google-Smtp-Source: AGHT+IF3RRD3VcmkzOx1BljxfoO5FHNKfhr8KfB+1qgv6dppTmsdMS9hABVyJWGIf4ekNScl8j63tQ== X-Received: by 2002:a05:6a20:e347:b0:1e1:f5a:c027 with SMTP id adf61e73a8af0-1e5e0846a43mr86645071637.43.1736222871140; Mon, 06 Jan 2025 20:07:51 -0800 (PST) Received: from charlie.ba.rivosinc.com ([64.71.180.162]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-92587c62eacsm11698726a12.21.2025.01.06.20.07.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 Jan 2025 20:07:50 -0800 (PST) From: Charlie Jenkins Date: Mon, 06 Jan 2025 20:07:33 -0800 Subject: [PATCH v3 2/3] perf: Document PERF_EVENT_IOC_INC_EVENT_LIMIT Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20250106-perf_set_event_limit-v3-2-dbde0e90ddde@rivosinc.com> References: <20250106-perf_set_event_limit-v3-0-dbde0e90ddde@rivosinc.com> In-Reply-To: <20250106-perf_set_event_limit-v3-0-dbde0e90ddde@rivosinc.com> To: Peter Zijlstra , Ingo Molnar , Arnaldo Carvalho de Melo , Namhyung Kim , Mark Rutland , Alexander Shishkin , Jiri Olsa , Ian Rogers , Adrian Hunter , Atish Patra Cc: linux-perf-users@vger.kernel.org, linux-kernel@vger.kernel.org, Charlie Jenkins X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=942; i=charlie@rivosinc.com; h=from:subject:message-id; bh=4zCJ3HPcN5gKu/Wsg5mqzz9IqKY+qHjGEO3bpZXvQyU=; b=owGbwMvMwCHWx5hUnlvL8Y3xtFoSQ3rNiokb1G8LvWR8umjpmgkL/4duliueuLTS7PHdGZ/WT XawbPp3oqOUhUGMg0FWTJGF51oDc+sd/bKjomUTYOawMoEMYeDiFICJNPUx/DOVe+LtlqHdMsGO 4e2lsnplv1dm6vv4ilW5J5dOe/cs6ggjw1nvw9rnX/4NKWKrrpcRTN5rrX2rRTtoU76enuHqqtf WzAA= X-Developer-Key: i=charlie@rivosinc.com; a=openpgp; fpr=7D834FF11B1D8387E61C776FFB10D1F27D6B1354 Introduce PERF_EVENT_IOC_INC_EVENT_LIMIT and explain the differences between it and PERF_EVENT_IOC_REFRESH. Signed-off-by: Charlie Jenkins --- tools/perf/design.txt | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/tools/perf/design.txt b/tools/perf/design.txt index aa8cfeabb7432d4011005f34a981fa3381caab09..1626ae83785a5773c255cc5219c2e9e0525dda19 100644 --- a/tools/perf/design.txt +++ b/tools/perf/design.txt @@ -439,6 +439,11 @@ Additionally, non-inherited overflow counters can use to enable a counter for 'nr' events, after which it gets disabled again. +PERF_EVENT_IOC_REFRESH will increment the event limit by 'nr' and enable the +event. To increment the event limit without enabling it, use the following: + + ioctl(fd, PERF_EVENT_IOC_INC_EVENT_LIMIT, nr); + A process can enable or disable all the counter groups that are attached to it, using prctl: -- 2.34.1