From nobody Sun Jun 14 04:08:49 2026 Received: from mail-pj1-f44.google.com (mail-pj1-f44.google.com [209.85.216.44]) (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 0ACA04594A for ; Sun, 3 May 2026 10:16:03 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.44 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777803365; cv=none; b=uNaTBUiKkp+475dVs7bmafxJ2fGieonHf3HI7byRhJDteIZqbX4harkM05EuyOYF37GIwL+Y4xDN8/gRXgf0Ek9Z+po2YLSKG3ZHnB2+ue5o/tK6XlcGBGMvmRQDGHmFRBCZSe0eSuFqYuYvv+O8MG4AfoZy+Yh2Be/xI2a7dYk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777803365; c=relaxed/simple; bh=uvqHElgEGVKSXwRjONRcK3jel/mrbxQ2SoM4dYFCfLA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=aZBCgCa2SEwZ1O/mP722XqFQQHepeJi2e0pbIddBpMVFAwYMEpgICokt77N4ngT75Qa1aIrWDE7+gSN8lmGzpJaSwhB41vBAyQ65YH5OuYml/z+bV9TKj1RaoN3Q2fzwZcOOcPOrE9A4tLkUqRO7NRZ8vLyC/UJ/BKfX7f21LX4= 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=n74JjliD; arc=none smtp.client-ip=209.85.216.44 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="n74JjliD" Received: by mail-pj1-f44.google.com with SMTP id 98e67ed59e1d1-364f65f6eaeso1860405a91.0 for ; Sun, 03 May 2026 03:16:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1777803363; x=1778408163; 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=zhd8YbgFXopiqXteo8z5StANTU+DMgBMtEUjnYYd7kA=; b=n74JjliDE9yxmuYceC7oVTenrlC0IR57NDnLH2tdZz1lXObn4jZTFYSZuph3q+L4Kc bv/uD27NXkC6OGJ3MMmknq6VV+2iqn36QM6caO8pk1KDXVn96A09LNEc4eIC1Z9Py+Hd jMTUil9TjbPg9FdcVU4G8ZhoGIwPhdpKviKB7gA5lLRzpJ5Y0Bp0fGC1O+brLytXnvTy TSQcvYEz6dyR9EZqVYhI/dpa9JvgU2MQqlHCSQlZ9x4cUF6GCZZtRw5MbR+52ZMeaTuS ZyWnfCyjzVCfsRquKINmn1BFuuH3u+U2zh0iXZNnLQ4zEfSUekQ2hPaGCZxq3pSD330w n2Kg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777803363; x=1778408163; 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=zhd8YbgFXopiqXteo8z5StANTU+DMgBMtEUjnYYd7kA=; b=S4wtEIN87wykHytj9dm7IWRmhvu+BmOhTaxrtirB6F5dtbGz7AIyOVSlR4nsTPQ4+T 58lZrffEzXv5LNhqNwVpA0QKaVaRRhyK2/OML/xjvUvokx8I19CgHISeuJ0ydzF+JFtq XkbZksu/k3ykP44EdUV4MMhodLiKB4XQmuT1pegZofrORTMAAqL0TTNOyouMv0v1l6CI 9NwpPXWRrQAS+FFzBeJxYSfBnT4dEiM7EyywV8+ZcbJbW4z2AA1yYxouseHZRBNLArKx Phm7hekK/a9naNGgGAI+osvYOczVVHpmOOLphEM3C1SK17ooH8evlm9rVMUx9fNPBSqK RMkQ== X-Forwarded-Encrypted: i=1; AFNElJ/vlsv3iP23JyzGxhqXRMltD33FUsj1JAJ1gGCZ6rGVo9p8zzvMPDI/GaX8s/dNmPKyFgaV/ybraR43Cgk=@vger.kernel.org X-Gm-Message-State: AOJu0Yx4rl2BuU307eNiKkIwTns6T+dqWIxvVmXO2jt1e2+uTuGOmPQX hiIlYSpqAYCVag66rsD86sA/KaNQGt99Qt8jn3bumfSLjFkXlH63/txq X-Gm-Gg: AeBDiesuI5nou/iF8vP1bJNe7S28WO48P/7qkCaeTeo7psigO2oWi0k22xX5OXaAe01 I/UPZHy/Kq+O8ejQhtgRwqsRdsI7HsqYR+UOtbCt0PQtSM/TQTdZWFAOGwUcrZj7/3XRP5LKM47 R/U8aRDe+sfiVi5e87z25I5wqTGqBf9zMlK1g64sR1bW9ZgNV3VEmoXWo0PCCFYe+nJi3C68xwY FIJ+SJLQe7Bb8SCSFvBNd62uj2wR3pPHFs/geZ9pdbFMgzOMyCWMq8fwwtexTyM9/834nk8kk35 dHwkjygrsJLCsZWIAybUK7UvGla5ms48WaGhJRKur3aY3RM/vM2agk9qwxuG/xB+mttOGDJQFzJ wQVRAuaR/8cNYGw0LWa7EWlHIkLOpNmj78suIFafhJlxOjM5AmfRZituSpXAnT//6mvsNrZOqBJ Hw0qermqpPnvHk7Q9DdNTUxsAiXQ== X-Received: by 2002:a17:90b:4ec5:b0:361:45df:f5 with SMTP id 98e67ed59e1d1-3650ce8ee94mr6243459a91.16.1777803363368; Sun, 03 May 2026 03:16:03 -0700 (PDT) Received: from apt ([140.123.97.23]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2b9caad2bd7sm81073455ad.36.2026.05.03.03.16.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 03 May 2026 03:16:03 -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 1/4] docs: admin-guide: fix typos in workload tracing guide Date: Sun, 3 May 2026 18:14:26 +0800 Message-ID: <20260503101429.254394-2-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: quoted-printable Content-Type: text/plain; charset="utf-8" Fix several typos in the workload tracing guide: - sys_opennat() -> sys_openat() - annotate the to view -> annotate the output to view - sys_getegid -> sys_getegid() Signed-off-by: Cheng-Han Wu Reviewed-by: Shuah Khan --- Documentation/admin-guide/workload-tracing.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/admin-guide/workload-tracing.rst b/Documentation= /admin-guide/workload-tracing.rst index 35963491b9f1..22cb05025ffc 100644 --- a/Documentation/admin-guide/workload-tracing.rst +++ b/Documentation/admin-guide/workload-tracing.rst @@ -278,8 +278,8 @@ associated with a process. This command records the pro= filing data in the perf.data file in the same directory. =20 Using the following commands you can record the events associated with the -netdev stressor, view the generated report perf.data and annotate the to -view the statistics of each instruction of the program:: +netdev stressor, view the generated report perf.data and annotate the outp= ut +to view the statistics of each instruction of the program:: =20 perf record stress-ng --netdev 1 -t 60 --metrics command. perf report @@ -349,13 +349,13 @@ times each system call is invoked, and the correspond= ing Linux subsystem. +-------------------+-----------+-----------------+-----------------------= --+ | geteuid | 1 | Process Mgmt. | sys_geteuid() = | +-------------------+-----------+-----------------+-----------------------= --+ -| getegid | 1 | Process Mgmt. | sys_getegid = | +| getegid | 1 | Process Mgmt. | sys_getegid() = | +-------------------+-----------+-----------------+-----------------------= --+ | close | 49951 | Filesystem | sys_close() = | +-------------------+-----------+-----------------+-----------------------= --+ | pipe | 604 | Filesystem | sys_pipe() = | +-------------------+-----------+-----------------+-----------------------= --+ -| openat | 48560 | Filesystem | sys_opennat() = | +| openat | 48560 | Filesystem | sys_openat() = | +-------------------+-----------+-----------------+-----------------------= --+ | fstat | 8338 | Filesystem | sys_fstat() = | +-------------------+-----------+-----------------+-----------------------= --+ --=20 2.52.0 From nobody Sun Jun 14 04:08:49 2026 Received: from mail-pl1-f170.google.com (mail-pl1-f170.google.com [209.85.214.170]) (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 CF7C028F949 for ; Sun, 3 May 2026 10:16:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.170 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777803367; cv=none; b=HSxTl5Sjnj2IAHA6mvIKng6PbDMMdtZ3kRcNTWOWr5rZ4WfYlAc3axPkEpMyZy3XfEW/toXGC01FUdvi/Ytx97ld3ExQyFJjiF/YQqBgyj1OlxRf+ZM35FrZT5Bk007hI0BkIYD13xmSJCOlPhtcvLEFu4Vpim4NsGF3tMkR97g= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777803367; c=relaxed/simple; bh=9EMxK9OalY8fJMjFtb28mqdI0He9EG/3ZVZngEVDCvY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=LsuTiq+5KYsJOGH81xv3swhezlUrCj9Hd4h1bpqp1K8LcqE7JdX0hkUI25KDxyNYrf9SKdkPU5OxHzec/pQY20mz+S55pV1IFcIR35b0FqfTAaRRGlF2W03Bnt0zFIIUqO4OotE3Dy/0VlmOY358BxUcr/IfM8TeZg5jMV/1Zuw= 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=BjEq0Vfh; arc=none smtp.client-ip=209.85.214.170 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="BjEq0Vfh" Received: by mail-pl1-f170.google.com with SMTP id d9443c01a7336-2ba21d32776so276285ad.2 for ; Sun, 03 May 2026 03:16:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1777803365; x=1778408165; 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=S+apMOgQJGL/Dg0EAkgqPrTSh2luK0OyGBeLibjvZ/s=; b=BjEq0VfhdNYgsE/5dpKcttZF8GUwnim5ZGDrIRLy1iXr6IEcC8MyOCUeWVCFMaZmBw QEIlcY7RFdyxeN7dL39V2GbUraJIh2PcvrBV6zvileNhvocGw4BmoreiqCWWqjal/6VQ cw2xH2ZuE242lv2KSV7kvkWvpXhddJtLhcGbIT234H5ii9ZIVHimYH5ViCP87u6L/9dC 4OJcEHWKM8PNE624skEvhIsycwLOY68ALmoqcT3hD2A/z3N4rHW1ofGmAya9z7uukaz/ kTOeKOVYJfS+7PkgKmn/RP026WjA15kLXsRnxYTiLSW3hsOV6H5wBRuDuCTySIdbv46n DoBQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777803365; x=1778408165; 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=S+apMOgQJGL/Dg0EAkgqPrTSh2luK0OyGBeLibjvZ/s=; b=YXc1tGtL2PBP+Ogp3Ps47UVMnOPWhm0cn/Jm7jq8P33UmQem0KT2CemOf69srFCCKr WME50i1pdDVYIj95y6/dYzs2E/zUvciQcY5Ms4YmmJNAZ3RQnpNe0mvrWcP8BLI8XKLU XY8AZLfw40kEjB54u3b7G7ecLn7TxF3Z05tl3ozyTgcMO62PF9hsgk6H9VPnHd2LUXb1 5jsHC5P8wyqV8pnoXRU0/rGu5wDhl7xGUeRne+RzfkYakNjtb+1xm2U74HvlPxpFS67k ncNt3+tD5okHVsIe63APm679jP0PLQR85B1JF88r68pUQ+k1A3uzgaZGwAtc6BdJ9XHt oxTA== X-Forwarded-Encrypted: i=1; AFNElJ86IbFJXmcN+9Sbe9ilqygBqiBaL8pYNIW6XhWDRkFGE3w8VblOhCIWPs66ybJo3/R0tyhHZDIiqhV1K8U=@vger.kernel.org X-Gm-Message-State: AOJu0YxNeXjVR11HqsXNh94mF/Wr0/L3kgq1GwjeOvHRmNoEjilTRj3v 9gH8gs1USv6wL3Sz9nseFsrL6g9yW2kLILrRqJidKlZpJ7m8ZXea10qI X-Gm-Gg: AeBDiesEfcQZAf0Yw8Vm0LbngYl5UFlGZ+F3F8Qn+aBhUuzPr4qSbw1XntXGMvvx6zH x/mBLB33tF0spyysJ5NqfDFh43RXrDd/dMNREnRTfzdUrAJ5GYxcynKQ8fQcHwEtnchPRcFXXGv xXaYfednEKXDL3DoPrtXKY+U2+2TuV5fuPdqMJ0ncfSNVwoc5QfI22ooLcLG0EOiFw1JuHolSYb k6w0usVladH6RwAq+KGtLB80eKNAYMm6GZDqZR/3r2BqdDxWvPh9eouCKmlPJUaYY3U7cSbiJpi t/pS8WfzyVv3cC6FNLw0wY/Pmlh2+DFaCUMY4d2FFcVGvs0x3wP9eXiV+Nsk7XHtG2pv2PFxuJD 9rdf8zjosKH3yltLkiYlByqqoP9uz9Fz1BE8z8a+28gMhGHP9tpxiwySMBa0GqzFzBFLqeHHml6 KVyMJj7DiNLfBnMdVo/4iWs5s8Kw== X-Received: by 2002:a17:903:9cc:b0:2b0:61c2:8e83 with SMTP id d9443c01a7336-2b9f25df47dmr52626995ad.20.1777803365135; Sun, 03 May 2026 03:16:05 -0700 (PDT) Received: from apt ([140.123.97.23]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2b9caad2bd7sm81073455ad.36.2026.05.03.03.16.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 03 May 2026 03:16:04 -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 2/4] docs: admin-guide: fix stress-ng command examples Date: Sun, 3 May 2026 18:14:27 +0800 Message-ID: <20260503101429.254394-3-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: quoted-printable Content-Type: text/plain; charset="utf-8" The workload tracing guide includes stress-ng command examples with a stray "command." word at the end. This makes the examples invalid if they are copied and run directly. Remove the stray word from the stress-ng example. Also use "--" in the perf record example to clearly separate perf record options from the workload command being recorded. Signed-off-by: Cheng-Han Wu Reviewed-by: Shuah Khan --- Documentation/admin-guide/workload-tracing.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/admin-guide/workload-tracing.rst b/Documentation= /admin-guide/workload-tracing.rst index 22cb05025ffc..43a3c8098654 100644 --- a/Documentation/admin-guide/workload-tracing.rst +++ b/Documentation/admin-guide/workload-tracing.rst @@ -271,7 +271,7 @@ exercised: =20 The following command runs the stressor:: =20 - stress-ng --netdev 1 -t 60 --metrics command. + stress-ng --netdev 1 -t 60 --metrics =20 We can use the perf record command to record the events and information associated with a process. This command records the profiling data in the @@ -281,7 +281,7 @@ Using the following commands you can record the events = associated with the netdev stressor, view the generated report perf.data and annotate the outp= ut to view the statistics of each instruction of the program:: =20 - perf record stress-ng --netdev 1 -t 60 --metrics command. + perf record -- stress-ng --netdev 1 -t 60 --metrics perf report perf annotate =20 --=20 2.52.0 From nobody Sun Jun 14 04:08:49 2026 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: quoted-printable Content-Type: text/plain; charset="utf-8" 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 Reviewed-by: Shuah Khan --- .../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 a= lso acts as a common benchmarking framework, enabling developers to easily create test cases, integrate transparently, and use performance-rich tooling. =20 -"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. =20 - * 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 =20 What is stress-ng and how do we use it? =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.52.0 From nobody Sun Jun 14 04:08:49 2026 Received: from mail-pl1-f180.google.com (mail-pl1-f180.google.com [209.85.214.180]) (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 59267289367 for ; Sun, 3 May 2026 10:16:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.180 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777803370; cv=none; b=F5CPFVZHUloxwRv+RNUmmoQ8m2YUZ/RrDG9zdUo3Yy4ck1+tJG6f6YumcvJcJnBacf6hLdbyMFj/5Ca3KG6qgIVmoA2whKBBcatZpYmosieNiuuQoYEsnQOFZQWRZrQLquNjHRieC3GTpba2lrteAAss7akpOGy9+lu9/YTzP9Y= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777803370; c=relaxed/simple; bh=1btOSWinIznhILUWPU9SQybPSt0VmE+8i3i6zz1gQ84=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=hb/wZTr7nj8yaIQXlXbPEkeDURaoIuKUp9L2Juq0hgEGwE2o9QMYepMOY0ikrFMOlAQVmdqTX1XiwxIuW9nXaeUZuOv5bECz6+PrX6VXDL3PNo0Ea20eNethkdGetRXFMJWgsc/pnY7cswSIfGvDj+AwulXJPz/vnd7aUYTyuB8= 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=TfDzuL+A; arc=none smtp.client-ip=209.85.214.180 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="TfDzuL+A" Received: by mail-pl1-f180.google.com with SMTP id d9443c01a7336-2b4583f0a1aso18665105ad.3 for ; Sun, 03 May 2026 03:16:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1777803369; x=1778408169; 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=svXN+ZlAdU7VDLF9TtRXFpJ6BtWW3ljpT3ve/4UXduA=; b=TfDzuL+AosFUfIlhwGPlPmr0Kvwk9jwbOzPZ3hRyrBkWQefnjq4oavyT+2kbyw3y6H 16qgWM1N9Fris9KXcrcNkkBacFa1JH5LFJkRZnvsf3aYsGHuNmrFUMdupxnzg5yVeEGs ie5HUFBZjQXgbx1Z89XRBPRAMT9G5IdI+5Dukyq7PUxWfQXDCc9NCVO+aQdsIZ7jfXML KpWQKIgsXqBvzUrfs8P+Y6TE/G2h0yojt/10XwreShYz5YJoIY0IYZ9jrevVnKgP1XQf nGKKi6AJ6oJqQKvS7VgI8tCPRoPVLSb78f+6Mh2+3BzcQifEhMMbOw/JuAdigUPKo4nE wdAg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777803369; x=1778408169; 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=svXN+ZlAdU7VDLF9TtRXFpJ6BtWW3ljpT3ve/4UXduA=; b=p3dO36TTOVoxKGr2H02pvGxRww03d305dNh7TQ8sNzGu4em4Fkdhx4a05wydg0qMjY 4kvpNvhfcWVWgIc0lRE+cHlyV+gEn3T21TQxxFPERcfBVPA9kwCt52HrlmQhY07GrAPi AWDuHT/BwJsysWBO+NB4R0SCgT3iQZcdZkM7LV2g44MObDW1xHHI4iAzc+TAkkNCtdgw PkQfJDlvx0xJa0AlugnDHO+SoeKXJU+aeBi72DLGB+VKOc0jnAPfXK0Nhl3gQycOy/JJ GvlgjO2iK67DykjOcUG1BS/rArIBv1j6GCzR2A9ciMVPRQj7neLm3QSwL+f27udq8IoI fTEg== X-Forwarded-Encrypted: i=1; AFNElJ9WGXYdA2chJ347pG/P8ShRUkvNmyR8JRa3cWqCuPBTVG5VDKwIOeQuwEPgbJEyhuzj9N/VMG5qcZ1Eygo=@vger.kernel.org X-Gm-Message-State: AOJu0Yw2FXMu+ZgL5bE7onEasdBX9DJtu/sqF+fIPGRqE8unyVnDiDHp fOjlI3drMWx/8cc/ifPZWw8pApq5FlbZQmIOcocuygdBhN4C7dhKwyTMaeZU/OqW X-Gm-Gg: AeBDiet2mlWX4WYBT7icxnX7fY1vqOCJew9GLLs4XGu05XLymcHQp+QWVU2NwEI/mwi B6Utd64D9ZimO8dYctuVh6+pRwSBvSQATwUfqzr3Zg9Og4G7ieoj5g0aP1W0Z9oMaTHiIRKdHep GuS4UFaFa+jqcWvkKjzvE2+1pUMufjnlGFY+bauRbNcoH6J3XZIigMB+ELWDBT42sSXBeyxJY6b bZ1hTv8A289no/VibW/2sDbkg28noOtKS10ZNTfR/nWp9ZWMzBh89Awh05+gDrMDhZ9D6u196dy bsgQPuqJiXKYaD7vedhEyP/FAA6L3e0sfONYqbEPkU+eaM2g0mrdyYVu6gQX6VJkyycaLwSmKhF fjqcPbadf0ork3T7O+LepVAHie8QpX5Oa1VQ0CyXQKvIoCNm4QpEVEGKpbsKvdSoQY2QqtY30vE a4NsiodlVugVl90OKD+O5Gz+B3SQ== X-Received: by 2002:a17:903:1a86:b0:2b2:4d36:7ba with SMTP id d9443c01a7336-2b9f22144a6mr50304105ad.0.1777803368740; Sun, 03 May 2026 03:16:08 -0700 (PDT) Received: from apt ([140.123.97.23]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2b9caad2bd7sm81073455ad.36.2026.05.03.03.16.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 03 May 2026 03:16:08 -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 4/4] docs: admin-guide: add IGNORE_DIRS example for cscope Date: Sun, 3 May 2026 18:14:29 +0800 Message-ID: <20260503101429.254394-5-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: quoted-printable Content-Type: text/plain; charset="utf-8" The workload tracing guide shows how to build a cscope database by running cscope command directly. The kernel build system also provides a cscope target, which supports IGNORE_DIRS for excluding directories from the generated database. Mention make cscope and show how to exclude Documentation/ as an example. Signed-off-by: Cheng-Han Wu Reviewed-by: Shuah Khan --- Documentation/admin-guide/workload-tracing.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/Documentation/admin-guide/workload-tracing.rst b/Documentation= /admin-guide/workload-tracing.rst index c49c2a00a8b8..314e5f03474e 100644 --- a/Documentation/admin-guide/workload-tracing.rst +++ b/Documentation/admin-guide/workload-tracing.rst @@ -202,6 +202,15 @@ database. To get out of this mode press ctrl+d. -p opt= ion is used to specify the number of file path components to display. -p10 is optimal for browsing kernel sources. =20 +Alternatively, the kernel build system can generate the cscope database:: + + make cscope + +To exclude directories from the generated database, pass IGNORE_DIRS to +the cscope target. For example, to exclude Documentation/, run:: + + make IGNORE_DIRS=3D"Documentation" cscope + What is perf and how do we use it? =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 --=20 2.52.0