From patchwork Thu Jul 20 16:30:45 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Valentin Schneider X-Patchwork-Id: 13320793 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6F9B6EB64DC for ; Thu, 20 Jul 2023 16:33:19 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 0C9E4280137; Thu, 20 Jul 2023 12:33:19 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 07A4D28004C; Thu, 20 Jul 2023 12:33:19 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id E35B7280137; Thu, 20 Jul 2023 12:33:18 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id D2EA328004C for ; Thu, 20 Jul 2023 12:33:18 -0400 (EDT) Received: from smtpin30.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id A5E0812020E for ; Thu, 20 Jul 2023 16:33:18 +0000 (UTC) X-FDA: 81032535276.30.09E4E64 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by imf01.hostedemail.com (Postfix) with ESMTP id CFE084001F for ; Thu, 20 Jul 2023 16:33:16 +0000 (UTC) Authentication-Results: imf01.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b="X/5UOLEm"; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf01.hostedemail.com: domain of vschneid@redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=vschneid@redhat.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1689870796; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=thuwuWrD51j/PCw+xxhEtLF5o2/5RQb/+JUh6XwKh6w=; b=vMdyL2b+V0tLW4bNghb62k9dzCVd6f1CRXVAnfsQlJXa82oEJbSJgeiahiQf1qNcuYpHbU ZU2f4PZQTFSW+SYiYlqOCPQeuhXQ/wyukemoK5U2rdiIFdnAEu2Gc3Zbr0jOswuAhPfz1i DJ8ZPigDRjM3mh8MuHvFKko1LvRYj0E= ARC-Authentication-Results: i=1; imf01.hostedemail.com; dkim=pass header.d=redhat.com header.s=mimecast20190719 header.b="X/5UOLEm"; dmarc=pass (policy=none) header.from=redhat.com; spf=pass (imf01.hostedemail.com: domain of vschneid@redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=vschneid@redhat.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1689870796; a=rsa-sha256; cv=none; b=FL9YB1MAQrmHLDRvvuED/iBZKKwb1AuuSrpcliYdpEYaVXA75vJeuftT52Fv39ndIKGqOV vu6Y5y65H93K7+0AtiIFutwHyCTjsZfGZEMCbLEzfb2qSOxFVsf5vu4TEaaLnPPVesKpR/ r7/43W4G7H+kvLPRxQXhYZXVmJ8Lqyg= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1689870796; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=thuwuWrD51j/PCw+xxhEtLF5o2/5RQb/+JUh6XwKh6w=; b=X/5UOLEm5Rxsv2pFWbaBfNTyqIvyyXberChj9zp1iTWsNC6XWtzBw9h+3ptcZ3CYKt9+Yx 9RvQYUzMVgy7vzHpxXsRQLL4fmbqdQ0G81KqCHemqA65jV+9UZY45o40TSRsUYUMnuHpJm QjxPOUooVULKXiAjN3jVYeap+AXWhxQ= Received: from mimecast-mx02.redhat.com (66.187.233.73 [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-578-oEUvXGKYOk2j8KZachUjlQ-1; Thu, 20 Jul 2023 12:33:13 -0400 X-MC-Unique: oEUvXGKYOk2j8KZachUjlQ-1 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 9CC113C1A6E4; Thu, 20 Jul 2023 16:33:10 +0000 (UTC) Received: from vschneid.remote.csb (unknown [10.42.28.48]) by smtp.corp.redhat.com (Postfix) with ESMTPS id CC9AD40C206F; Thu, 20 Jul 2023 16:33:02 +0000 (UTC) From: Valentin Schneider To: linux-kernel@vger.kernel.org, linux-trace-kernel@vger.kernel.org, linux-doc@vger.kernel.org, kvm@vger.kernel.org, linux-mm@kvack.org, bpf@vger.kernel.org, x86@kernel.org, rcu@vger.kernel.org, linux-kselftest@vger.kernel.org Cc: Steven Rostedt , Masami Hiramatsu , Jonathan Corbet , Thomas Gleixner , Ingo Molnar , Borislav Petkov , Dave Hansen , "H. Peter Anvin" , Paolo Bonzini , Wanpeng Li , Vitaly Kuznetsov , Andy Lutomirski , Peter Zijlstra , Frederic Weisbecker , "Paul E. McKenney" , Neeraj Upadhyay , Joel Fernandes , Josh Triplett , Boqun Feng , Mathieu Desnoyers , Lai Jiangshan , Zqiang , Andrew Morton , Uladzislau Rezki , Christoph Hellwig , Lorenzo Stoakes , Josh Poimboeuf , Jason Baron , Kees Cook , Sami Tolvanen , Ard Biesheuvel , Nicholas Piggin , Juerg Haefliger , Nicolas Saenz Julienne , "Kirill A. Shutemov" , Nadav Amit , Dan Carpenter , Chuang Wang , Yang Jihong , Petr Mladek , "Jason A. Donenfeld" , Song Liu , Julian Pidancet , Tom Lendacky , Dionna Glaze , =?utf-8?q?Thomas_Wei=C3=9Fschuh?= , Juri Lelli , Daniel Bristot de Oliveira , Marcelo Tosatti , Yair Podemsky Subject: [RFC PATCH v2 09/20] tracing/filters: Document cpumask filtering Date: Thu, 20 Jul 2023 17:30:45 +0100 Message-Id: <20230720163056.2564824-10-vschneid@redhat.com> In-Reply-To: <20230720163056.2564824-1-vschneid@redhat.com> References: <20230720163056.2564824-1-vschneid@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.1 X-Rspam-User: X-Stat-Signature: 7j5yosibjrmxxkdf9i3aj8bgom9eg3yf X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: CFE084001F X-HE-Tag: 1689870796-809609 X-HE-Meta: U2FsdGVkX183K4pLMTIQ2XWjLZo/ES9x0WBzUIAzssKSHFUQJzQtNpkJ7N0mZKIrKdAe7GNoQXhbySJmJE9cpu/SjQo356rNusdF7WVLuSXbAU4hhuKwTuJJgJRbVomsfVES9dflR33C28R3bmhrQOG6zF74kOw5XS3W5lJeK9BA0mpIaKntfYSKK+kyL67vPDpkE0UUoe2gwvNLR3CrD4BX275NQGDhpK9sU170I8rls3SDjE5gGnrHUO8qcsdxC/xRS4Bz8UZ3oQTke2RLRu1vZiA265Nei3jw5Tb0zW2szukB3kH/C1TwInIxz/Cls4oNJYE78SpOHPLxeeFpOfwJtzYnTaeE96RxdgEyqhk5Q1KWZh+6zdphT3D9EZYXktdV8gTPrmedJwXE3LjkqBeGVaUs0vZlmiq+FJ64+etXHzzxg2th5WeqJr3KQg8wBTk7Ogo6YcnONCiT3MAnWyOXpgF06tIy4cuDmwy+21D7IncNlZQQtGxdKO13AATTf4m+W7CuXdiJlUodmXf4SxsDUUfOCmUQjtbV0SKxmL5nPVXyG4pAKFT7JWDaR3b72KjSdnovQm/fq5Fe/C16RKwQIvKAHkgnsprlzvUsIFv4orO++nJNJmYVrvZFR2YjaSSg15uiHz/8Lv1T6PqOazZ6WYG+Pz6gPo7C6J2zJti+qbJ88/KKy3DZ8nQsrNQYQCAuHd6Cs6mYD80Vm+eOw5s4B5JPSxaUoqOHGw/ISKP6zKq/PTYkSPhXOoL0aHlc8nbthbU6TDz6Lm+eaPbg2bYX/4gjs/kxdwrxiNLeHm1H/kTwdsuAPAMnTWNTyprbfkpsvP/55qe+cwWJwrkxzFKTZFFwxFa85YiGSaIIUxy3anh5d6siNIG8FE6PT0DC1toC/xdVB0oZNFBcI4OT4FWUXAVCTxz2eRv7kHCYVZ4XhA2YAWAP+rD5/Oap4LeLmcUaZkDMutZ4DryeMG8 9/a62ZwQ C8DCt0U5Y1ZqGyc5AyTCt413vuhfvtjZdOLRBk+yoUIZShM8yILSt5TfeQkE/EWY9FrFIAhisBAa0LihJ65x5kXdjIHn/39O3oHtFLw4Gf/Yd+GEURlKCNbnnrO9eNdwIcgGu4TzGGdVQPhsz9eUq/7E+aRkI3sgVAPNLaitBzLXaTwt9UmJ9Vz7YZWRov/lt3ai0hfg/LVsFepwXPv3p2hZ7S6z/OHuZxKKdRxiBUQPabhGcRcpMqeCWUQ== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: Cpumask, scalar and CPU fields can now be filtered by a user-provided cpumask, document the syntax. Signed-off-by: Valentin Schneider --- Documentation/trace/events.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/Documentation/trace/events.rst b/Documentation/trace/events.rst index f5fcb8e1218f6..34108d5a55b41 100644 --- a/Documentation/trace/events.rst +++ b/Documentation/trace/events.rst @@ -219,6 +219,20 @@ the function "security_prepare_creds" and less than the end of that function. The ".function" postfix can only be attached to values of size long, and can only be compared with "==" or "!=". +Cpumask fields or scalar fields that encode a CPU number can be filtered using +a user-provided cpumask in cpulist format. The format is as follows:: + + CPUS{$cpulist} + +Operators available to cpumask filtering are: + +& (intersection), ==, != + +For example, this will filter events that have their .target_cpu field present +in the given cpumask:: + + target_cpu & CPUS{17-42} + 5.2 Setting filters -------------------