From patchwork Sat Dec 10 13:57:58 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Steven Rostedt X-Patchwork-Id: 32034 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp1332756wrr; Sat, 10 Dec 2022 06:14:31 -0800 (PST) X-Google-Smtp-Source: AA0mqf57E0hV2XXWgHPYFLMdtibxlBqqzfp/MAVftW7CzB8wvQUySuBLD2vjKpKTRJmdd4QZoo1c X-Received: by 2002:a17:907:a078:b0:7c0:f213:4485 with SMTP id ia24-20020a170907a07800b007c0f2134485mr8440956ejc.73.1670680781751; Sat, 10 Dec 2022 05:59:41 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1670680781; cv=none; d=google.com; s=arc-20160816; b=0Toji1h8VHds6YxhwdPf+WSbb//ynp84Af18PdKFqEFq84kCceGuSUSfFPN8DPM3J1 /EtZxACEC2KuO6uKNO4kZKDSuPQdcUmfw/TlccpYp1ocsmz5yaNhbcSxal0HTrfVysXZ Uf5pajjuQx38+D/kH2NJ7bTW3izMRuo458+yNuEW+O2IXoF71udmYR8QHUgS/hZXjRJf vkAovL2cV5iWrFu3s9yN18xOcPUCEcHEvLSTiM61MSMRyBRrBYZWHAGNIt3uw70/yrFo dsPeV6IxEXOLsG66DYIb2qnTUZm0jSrQLre3/AlsQZhFp2H96dIFQwCbXzmqbC/LoA3v TcQw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:references:subject:cc:to:from:date :user-agent:message-id; bh=k9ajDjaOVyd2GEYK7bFfVOJBH40BwLSSuU8z+JnkPIc=; b=Q76lN8S+3zI/XsfZ9D/ZL9KpZjIHfuRxanfp+KKu80SbICDAfRbEp+mFhnBl10LLrf jtPD2nf153eZEp8W20+pVFkPLwbYgLa2H1ygbWsjVWCzYG2EEkSIuh6Cv9pJ+2frc+jG fi7csPCNxHTjtzzcjHG8nTopziNrQNRQuS/QpslFjQ5WyhfpLv8gAYe0L4WhxLerVZYO rW8Ehrkz02e8zbc2WA13bj640dNKcWHRQdrwhtubaRYHZFU26SLcrwiYkVg7anjf2/5u SlVuwMbxt8xx6Dih0l/6AzXyxMpgVD+h1yrlHvziIdj9yD9sa3I2lNFhUVUEeBYv4WId 4DpQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id jr8-20020a170906a98800b007c137f5352asi1686790ejb.387.2022.12.10.05.59.18; Sat, 10 Dec 2022 05:59:41 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229918AbiLJN6m (ORCPT + 99 others); Sat, 10 Dec 2022 08:58:42 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34858 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229658AbiLJN61 (ORCPT ); Sat, 10 Dec 2022 08:58:27 -0500 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 74C0F15A1F for ; Sat, 10 Dec 2022 05:58:26 -0800 (PST) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 0F73060C1D for ; Sat, 10 Dec 2022 13:58:26 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 76BA3C433B3; Sat, 10 Dec 2022 13:58:25 +0000 (UTC) Received: from rostedt by gandalf.local.home with local (Exim 4.96) (envelope-from ) id 1p40My-000koK-1w; Sat, 10 Dec 2022 08:58:24 -0500 Message-ID: <20221210135824.466047951@goodmis.org> User-Agent: quilt/0.66 Date: Sat, 10 Dec 2022 08:57:58 -0500 From: Steven Rostedt To: linux-kernel@vger.kernel.org Cc: Masami Hiramatsu , Andrew Morton , Tom Zanussi Subject: [for-next][PATCH 08/25] tracing: docs: Update histogram doc for .percent/.graph and nohitcount References: <20221210135750.425719934@goodmis.org> MIME-Version: 1.0 X-Spam-Status: No, score=-6.7 required=5.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,RCVD_IN_DNSWL_HI,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1751835771049042930?= X-GMAIL-MSGID: =?utf-8?q?1751835771049042930?= From: "Masami Hiramatsu (Google)" Update histogram document for .percent/.graph suffixes and 'nohitcount' option. Link: https://lore.kernel.org/linux-trace-kernel/166610815604.56030.4124933216911828519.stgit@devnote2 Signed-off-by: Masami Hiramatsu (Google) Reviewed-by: Tom Zanussi Tested-by: Tom Zanussi --- Documentation/trace/histogram.rst | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/Documentation/trace/histogram.rst b/Documentation/trace/histogram.rst index 87bd772836c0..f95459aa984f 100644 --- a/Documentation/trace/histogram.rst +++ b/Documentation/trace/histogram.rst @@ -25,7 +25,7 @@ Documentation written by Tom Zanussi hist:keys=[:values=] [:sort=][:size=#entries][:pause][:continue] - [:clear][:name=histname1][:.] [if ] + [:clear][:name=histname1][:nohitcount][:.] [if ] When a matching event is hit, an entry is added to a hash table using the key(s) and value(s) named. Keys and values correspond to @@ -79,6 +79,8 @@ Documentation written by Tom Zanussi .log2 display log2 value rather than raw number .buckets=size display grouping of values rather than raw number .usecs display a common_timestamp in microseconds + .percent display a number of percentage value + .graph display a bar-graph of a value ============= ================================================= Note that in general the semantics of a given field aren't @@ -137,6 +139,12 @@ Documentation written by Tom Zanussi existing trigger, rather than via the '>' operator, which will cause the trigger to be removed through truncation. + The 'nohitcount' (or NOHC) parameter will suppress display of + raw hitcount in the histogram. This option requires at least one + value field which is not a 'raw hitcount'. For example, + 'hist:...:vals=hitcount:nohitcount' is rejected, but + 'hist:...:vals=hitcount.percent:nohitcount' is OK. + - enable_hist/disable_hist The enable_hist and disable_hist triggers can be used to have one