Received: by 2002:a05:6358:45e:b0:b5:b6eb:e1f9 with SMTP id 30csp549642rwe; Thu, 1 Sep 2022 04:13:40 -0700 (PDT) X-Google-Smtp-Source: AA6agR62nkTuHNSCJ4QI93oqnUfnh616xLIIsYxwTPCO6mfCZjynwogf4anbOaep2Bxuc+yUJTFh X-Received: by 2002:a17:907:7628:b0:73d:e0eb:2e51 with SMTP id jy8-20020a170907762800b0073de0eb2e51mr20828864ejc.237.1662030820218; Thu, 01 Sep 2022 04:13:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1662030820; cv=none; d=google.com; s=arc-20160816; b=AsthS1wlEFb21yO6NR391G1JfelAvIlFePKrkOemVjqg1MqB8mBeYV8mhGQAxda1Zw gytM+Pcn8XWQAlx+HpSjpXrL9UeS7SI0QSbkJbeAo2ygWt5k5KqCWWRDdpj3CZgdZ1VM nHP5J2xHph92VCPPEWZgFl63BGya2dTQBrSB7wJJEzO0vZvWCZzfdToiL0b/8PXD6uFs I174Xr0xCdXmRH9PhWUzSsC52AQJOdzJ/6LCvq/W0U22/YMj5N1MLrS2nU/DQtHwlc4S eLMZ++QyTFPF9tpv2UJRt9E1WlLGwlD+JrioosNeJixqq9hCf5vJxr8aWjrosZ7RYx4m zZ1g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:organization :mime-version:references:in-reply-to:message-id:date:subject:cc:to :from:dkim-signature; bh=sDaBvW21B+tMADWSXLwylztxBoP8xLMjqrLLUp2krYc=; b=E+wfFTXtjR/Zd7tiYEozRC8iHJVzkxBTKPt2HzbzvhHcawnk+Sb2tdI2LVtIRXvDU3 fwaF0HcGFthMuN0IcndJ0ejkOyFA82Z4+OQNMirwVT3vPjEXQYwX3dTiwQV6Vdi/HiCx o5esyqVPsvg7AMFcJIXJqFFbsFqiRJy47qPAWjaV6c+m2Z754aC6zTOHqSNFUx0smY+T IJEHSYgLD4eMicSZma37Pp76D4xMrPZMeT6vo8ApoeJOO/P35Afgv+fCNIKLsEHgHkha Gsw4WoQ+M4D7JjAEpJSfeo8UoYk8jdNSpSfgA/jRmN8Ct5TCu6B4irBS7FI0t/sTvVv8 VOXw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=D4Nl6jfQ; 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; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id cf26-20020a0564020b9a00b004469a602b4esi1202576edb.66.2022.09.01.04.13.13; Thu, 01 Sep 2022 04:13:40 -0700 (PDT) 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; dkim=pass header.i=@intel.com header.s=Intel header.b=D4Nl6jfQ; 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; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234010AbiIALBN (ORCPT + 99 others); Thu, 1 Sep 2022 07:01:13 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38432 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234395AbiIALBB (ORCPT ); Thu, 1 Sep 2022 07:01:01 -0400 Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4D0C5116E2E for ; Thu, 1 Sep 2022 04:00:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1662030052; x=1693566052; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=jVjFF2PrM6dAz3NWg11gPo9wUvf69s9ymJGLw6hFwC0=; b=D4Nl6jfQ/2tj719SZwMY5RFIf755hLoHuQoVjjiXcPEXU0goS4uM6qq2 ZW9v47FVBUyLw9PqO6bY88FgrRoCFakMJ9qg30s2sRcyRqdpd34ov4gzg au4LQJ679lnNt+70rXgFe13v1bMDZ0Ohl1UcGxGmWXgs9Nm2nE1vaVoJs WyzeVTnHBpuEp09jNatBBNg0mo6EhPxGDfMCmxkQ5/BSWqWItaxW74XVe URym8LhvHpWJ/1TyMBuEvkiHV03MudAL3VxRFFqeSWTljx+0alx9ul2Q4 bjmHcSyE142HVsIKey4fk0gI/JDbdw9z5mfh+geezV67RyzkocQSrPUdI Q==; X-IronPort-AV: E=McAfee;i="6500,9779,10456"; a="294424805" X-IronPort-AV: E=Sophos;i="5.93,280,1654585200"; d="scan'208";a="294424805" Received: from fmsmga008.fm.intel.com ([10.253.24.58]) by fmsmga104.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 01 Sep 2022 04:00:52 -0700 X-IronPort-AV: E=Sophos;i="5.93,280,1654585200"; d="scan'208";a="673799651" Received: from ahunter6-mobl1.ger.corp.intel.com (HELO ahunter-VirtualBox.home\044ger.corp.intel.com) ([10.252.42.13]) by fmsmga008-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 01 Sep 2022 04:00:50 -0700 From: Adrian Hunter To: Arnaldo Carvalho de Melo Cc: Jiri Olsa , Namhyung Kim , Ian Rogers , Andi Kleen , linux-kernel@vger.kernel.org Subject: [PATCH 3/5] perf intel-pt: Improve man page layout slightly Date: Thu, 1 Sep 2022 14:00:30 +0300 Message-Id: <20220901110032.9226-4-adrian.hunter@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220901110032.9226-1-adrian.hunter@intel.com> References: <20220901110032.9226-1-adrian.hunter@intel.com> MIME-Version: 1.0 Organization: Intel Finland Oy, Registered Address: PL 281, 00181 Helsinki, Business Identity Code: 0357606 - 4, Domiciled in Helsinki Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED, SPF_HELO_NONE,SPF_NONE,T_SCC_BODY_TEXT_LINE 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 Improve man page layout slightly by adding blank lines. Signed-off-by: Adrian Hunter --- tools/perf/Documentation/perf-intel-pt.txt | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/tools/perf/Documentation/perf-intel-pt.txt b/tools/perf/Documentation/perf-intel-pt.txt index 3dc3f0ccbd51..d5ddb968bcf4 100644 --- a/tools/perf/Documentation/perf-intel-pt.txt +++ b/tools/perf/Documentation/perf-intel-pt.txt @@ -943,12 +943,15 @@ event packets are recorded only if the "pwr_evt" config term was used. Refer to the config terms section above. The power events record information about C-state changes, whereas CBR is indicative of CPU frequency. perf script "event,synth" fields display information like this: + cbr: cbr: 22 freq: 2189 MHz (200%) mwait: hints: 0x60 extensions: 0x1 pwre: hw: 0 cstate: 2 sub-cstate: 0 exstop: ip: 1 pwrx: deepest cstate: 2 last cstate: 2 wake reason: 0x4 + Where: + "cbr" includes the frequency and the percentage of maximum non-turbo "mwait" shows mwait hints and extensions "pwre" shows C-state transitions (to a C-state deeper than C0) and @@ -956,6 +959,7 @@ Where: "exstop" indicates execution stopped and whether the IP was recorded exactly, "pwrx" indicates return to C0 + For more details refer to the Intel 64 and IA-32 Architectures Software Developer Manuals. @@ -969,8 +973,10 @@ are quite important. Users must know if what they are seeing is a complete picture or not. The "e" option may be followed by flags which affect what errors will or will not be reported. Each flag must be preceded by either '+' or '-'. The flags supported by Intel PT are: + -o Suppress overflow errors -l Suppress trace data lost errors + For example, for errors but not overflow or data lost errors: --itrace=e-o-l @@ -980,9 +986,11 @@ decoded packets and instructions. Note that this option slows down the decoder and that the resulting file may be very large. The "d" option may be followed by flags which affect what debug messages will or will not be logged. Each flag must be preceded by either '+' or '-'. The flags support by Intel PT are: + -a Suppress logging of perf events +a Log all perf events +o Output to stdout instead of "intel_pt.log" + By default, logged perf events are filtered by any specified time ranges, but flag +a overrides that. -- 2.25.1