From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f169.google.com (mail-pl1-f169.google.com [209.85.214.169]) (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 8A7E228BAB9 for ; Sun, 3 May 2026 10:16:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.169 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777803368; cv=none; b=HOEtZZRtTs7dSVEPsxu9vqd3Tdi1vM+IfnwVo34fAFLO/hNycFKGlcfXECHn0hD3t05MBp6MtqLFgOmKH1v4Byvd+FDT9o4sgIG5EPt/jvCDvGsTxz6dnAO/EozdYhXIlzkdca1EeSuvBTpfgBCJ8z895joeNcv0R/xyjTP4VhI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777803368; c=relaxed/simple; bh=/sxu5CvfKPXFXux+hejCCTZxZSIi+ftDnW9cLquSvuo=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=CfV8ylWBNsYyI1/nVKF0s6TXQpcyRXEj00NNeBfL8G6kVyEWkfGJHEM2u/F/JzCRPrwOx8ZnWnzCtlBGTePi4OFHXCroZ2NTg+xW4kthnlEyobDrzswdT7b+Jxv/iHVZg3Jvzrz6n5LwtJOw8T+M6U4Mvn9UTuSNUl0q0DtGPGo= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=NYWdWSSl; arc=none smtp.client-ip=209.85.214.169 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="NYWdWSSl" Received: by mail-pl1-f169.google.com with SMTP id d9443c01a7336-2ad9f316d68so11926485ad.2 for ; Sun, 03 May 2026 03:16:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1777803367; x=1778408167; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=LbjMdqiCjFlkGqVQVI9QTUqfUWAzRgH3Vd+pPoavZZc=; b=NYWdWSSlsTMeYJMIaUmvG1Dhdov+/UjFH9C8K2XI5iQoudqBz2FdMgtrFOxiTOYhfY 28hfaiLAKj8QiwYJA5ztzDG6A3j2iHHK6QvYEQxrdRommI36W0EnIJ2isrCe+2sZfbCt ORo2MeD4uZewFyDjsr0uGKeqBvhGOLwFolmr0V54fBfW7KPRCxfMbdLCDibXcbA+SYtC 2uRfPY6S//AF0rwMurl0QQrCTSQ47B40h/x/SepZQ7elglsIXBpd1VEX96+RD8lHkrW6 rACrcO/FpnJaNaFLFeFzJ597J4F5knk1Sr8a39Rjrcl4rr2WJ7wV5rjGw2NNxuZ2478z tkmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777803367; x=1778408167; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=LbjMdqiCjFlkGqVQVI9QTUqfUWAzRgH3Vd+pPoavZZc=; b=ImgxepaoPN8MbdHzM9IV9paoPa8Or+hQEXKkJhay89uKv1MAauWCRfwFfld8boV6GG 9hnJmGU2u94VgaEyNjpynJ2IjtE68IGE2BXuw6QTXycCwJoWocaqIygHoPV5XZRWO3Vn 98GFepuX/+F8id70OaRxbeiR8XWJz0a7/ffSpSWvfMEqh6glnI1qV4j/avOgEapT4X1o A23fmyxRYXR9V3N2ytqBArKgUA/OOGq4XHUZ7QIHuT9DXKe4d7KAxXmEUrKe/1lIcf+8 uS3Fi6TkDfPq6GxM4OS+FmBolUIPxrlL8AkMTaU+OaX92N4ujpdF6ead8lyZaFZGQBCN iApg== X-Forwarded-Encrypted: i=1; AFNElJ9mlWFVveho8I8qONpNlog7VS7xMbVYx08zK9cpHbv1Z28ftRqmLQFfY36GXmGUedqtOHMWPkTNSkklzEM=@vger.kernel.org X-Gm-Message-State: AOJu0YwWymmrLVletvX6GMg8UUVnc2hzKUr4a0btPbqgAls7IY1gSGBJ cp3Id6W5KYzByGMgZwCuuiJlqy7GwXej2hyhznn/yO7Kihj4lLBX1dij X-Gm-Gg: AeBDievwAIrQJImCKlruu3v65etWOiBvgbLiDV3b7uN9IrbCllAA9MdSfdsOO2ztCVL lnZbwWTuidpKjbODs4aE2TI2JcbyuEITkbG+u3LHiv7KB3tyB/639UHHrwlpwtp88eA5cpU64mm s5H/KesHrW8vUCet0LzC5YgttctJo5bNkKTW87BVRRGZOsFCB4jOb1MLWVbTJFLxjP5679fCW1A 6jw9KR/czsbBX2XQMBrRW7P0ExFVlIFdoslK9lh5gNvpOdb19wRFcU4bXgLo6B2skhrNZiAa3NN HAyaynhZqW5hZ2yG5o22p8POZe4bMwp0ebIMFNgtgutKzNkkn/O0L5OGcG4sTG311ffhBEWtqz4 MGkzAZyijSv+EFCIjQl1JOyejOwDr26K2Bou4RKX7onGQT9+7Xn1jXVq2QUtnCvbJ0YVoilOXct pxfBxoQl0Bjh9dMSAO4kj6pJvozw== X-Received: by 2002:a17:903:1b0b:b0:2b0:6e60:9582 with SMTP id d9443c01a7336-2b9f258971fmr50427385ad.18.1777803366918; Sun, 03 May 2026 03:16:06 -0700 (PDT) Received: from apt ([140.123.97.23]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2b9caad2bd7sm81073455ad.36.2026.05.03.03.16.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 03 May 2026 03:16:06 -0700 (PDT) From: Cheng-Han Wu To: Jonathan Corbet , Shuah Khan Cc: Randy Dunlap , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Cheng-Han Wu Subject: [PATCH 3/4] docs: admin-guide: clarify perf bench all behavior Date: Sun, 3 May 2026 18:14:28 +0800 Message-ID: <20260503101429.254394-4-hank20010209@gmail.com> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20260503101429.254394-1-hank20010209@gmail.com> References: <20260503101429.254394-1-hank20010209@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit The workload tracing guide lists a fixed set of benchmarks for "perf bench all". This list is stale and can become outdated when perf adds, removes, or renames benchmark collections or individual benchmarks. Describe "perf bench all" as running all available benchmarks in the perf bench framework instead. Also document how to list the collections and benchmarks available on a given system. Signed-off-by: Cheng-Han Wu --- .../admin-guide/workload-tracing.rst | 20 +++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/Documentation/admin-guide/workload-tracing.rst b/Documentation/admin-guide/workload-tracing.rst index 43a3c8098654..c49c2a00a8b8 100644 --- a/Documentation/admin-guide/workload-tracing.rst +++ b/Documentation/admin-guide/workload-tracing.rst @@ -243,13 +243,21 @@ which can help mitigate performance regressions. It also acts as a common benchmarking framework, enabling developers to easily create test cases, integrate transparently, and use performance-rich tooling. -"perf bench all" command runs the following benchmarks: +"perf bench all" runs all available benchmarks in the perf bench +framework. The exact set of benchmarks depends on the perf version and on +the features enabled when perf was built. - * sched/messaging - * sched/pipe - * syscall/basic - * mem/memcpy - * mem/memset +To list the benchmark collections available on the current system, run:: + + perf bench + +To list benchmarks in a collection, run:: + + perf bench + +For example, to list the benchmarks in the mem collection, run:: + + perf bench mem What is stress-ng and how do we use it? ======================================= -- 2.52.0