From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-10.1 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 81F0DC433DF for ; Wed, 12 Aug 2020 12:46:58 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 5C58A207F7 for ; Wed, 12 Aug 2020 12:46:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1597236418; bh=ilhcDmgMlsDXN38LhqCS7AxhDTnahSaoCo+rTTF26kg=; h=Date:From:To:Cc:Subject:References:In-Reply-To:List-ID:From; b=hmqLQpvvQvALWVXXIDRuPQLkiF++r608zEhsV/RCWpCsLD30mpY8ia9l8ulRLP1Rk yPvwd+VJqmbUjP1H07xGenrGOQZQAqdm4ZjPhf1IYnrEsWziZWhWT0X+DHKdrjrC/T slqdGTJHhZ8XetbFuoJujD8g/u8WWjuBMuCZUVng= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727879AbgHLMq5 (ORCPT ); Wed, 12 Aug 2020 08:46:57 -0400 Received: from mail.kernel.org ([198.145.29.99]:55492 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726804AbgHLMq4 (ORCPT ); Wed, 12 Aug 2020 08:46:56 -0400 Received: from quaco.ghostprotocols.net (179.176.8.134.dynamic.adsl.gvt.net.br [179.176.8.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id AEFCF2065C; Wed, 12 Aug 2020 12:46:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1597236416; bh=ilhcDmgMlsDXN38LhqCS7AxhDTnahSaoCo+rTTF26kg=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=yjOeU+YulkpftLdBJvffYsy54G+zjMeRiSqWHp4vd52zGY9JIuNNKGhzouEMxzq3i ApRjWkXD3ugIL07VtZJmwT9xmbsn0ZCQ4CyK5wnfS+KxCiTuCds3PB9U1/NaVTUCi9 DYbWJLjlLBivSSxJpK5tgadkl0z2GLhKwpkAS9Qc= Received: by quaco.ghostprotocols.net (Postfix, from userid 1000) id 7FEB34097F; Wed, 12 Aug 2020 09:46:53 -0300 (-03) Date: Wed, 12 Aug 2020 09:46:53 -0300 From: Arnaldo Carvalho de Melo To: Rob Herring Cc: linux-kernel@vger.kernel.org, Peter Zijlstra , Ingo Molnar , Mark Rutland , Alexander Shishkin , Jiri Olsa , Namhyung Kim Subject: Re: [PATCH] libperf: Fix man page typos Message-ID: <20200812124653.GK13995@kernel.org> References: <20200807193241.3904545-1-robh@kernel.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20200807193241.3904545-1-robh@kernel.org> X-Url: http://acmel.wordpress.com Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Em Fri, Aug 07, 2020 at 01:32:41PM -0600, Rob Herring escreveu: > Fix various typos and inconsistent capitalization of CPU in the libperf > man pages. Thanks, applied, - Arnaldo > Cc: Peter Zijlstra > Cc: Ingo Molnar > Cc: Arnaldo Carvalho de Melo > Cc: Mark Rutland > Cc: Alexander Shishkin > Cc: Jiri Olsa > Cc: Namhyung Kim > Signed-off-by: Rob Herring > --- > tools/lib/perf/Documentation/libperf-counting.txt | 14 ++++++++------ > tools/lib/perf/Documentation/libperf-sampling.txt | 13 +++++++------ > tools/lib/perf/Documentation/libperf.txt | 4 ++-- > 3 files changed, 17 insertions(+), 14 deletions(-) > > diff --git a/tools/lib/perf/Documentation/libperf-counting.txt b/tools/lib/perf/Documentation/libperf-counting.txt > index cae9757f49c1..8b75efcd67ce 100644 > --- a/tools/lib/perf/Documentation/libperf-counting.txt > +++ b/tools/lib/perf/Documentation/libperf-counting.txt > @@ -7,13 +7,13 @@ libperf-counting - counting interface > > DESCRIPTION > ----------- > -The counting interface provides API to meassure and get count for specific perf events. > +The counting interface provides API to measure and get count for specific perf events. > > The following test tries to explain count on `counting.c` example. > > It is by no means complete guide to counting, but shows libperf basic API for counting. > > -The `counting.c` comes with libbperf package and can be compiled and run like: > +The `counting.c` comes with libperf package and can be compiled and run like: > > [source,bash] > -- > @@ -26,7 +26,8 @@ count 176242, enabled 176242, run 176242 > It requires root access, because of the `PERF_COUNT_SW_CPU_CLOCK` event, > which is available only for root. > > -The `counting.c` example monitors two events on the current process and displays their count, in a nutshel it: > +The `counting.c` example monitors two events on the current process and displays > +their count, in a nutshell it: > > * creates events > * adds them to the event list > @@ -152,7 +153,7 @@ Configure event list with the thread map and open events: > -- > > Both events are created as disabled (note the `disabled = 1` assignment above), > -so we need to enable the whole list explicitely (both events). > +so we need to enable the whole list explicitly (both events). > > From this moment events are counting and we can do our workload. > > @@ -167,7 +168,8 @@ When we are done we disable the events list. > 79 perf_evlist__disable(evlist); > -- > > -Now we need to get the counts from events, following code iterates throught the events list and read counts: > +Now we need to get the counts from events, following code iterates through the > +events list and read counts: > > [source,c] > -- > @@ -178,7 +180,7 @@ Now we need to get the counts from events, following code iterates throught the > 85 } > -- > > -And finaly cleanup. > +And finally cleanup. > > We close the whole events list (both events) and remove it together with the threads map: > > diff --git a/tools/lib/perf/Documentation/libperf-sampling.txt b/tools/lib/perf/Documentation/libperf-sampling.txt > index d71a7b4fcf5f..d6ca24f6ef78 100644 > --- a/tools/lib/perf/Documentation/libperf-sampling.txt > +++ b/tools/lib/perf/Documentation/libperf-sampling.txt > @@ -8,13 +8,13 @@ libperf-sampling - sampling interface > > DESCRIPTION > ----------- > -The sampling interface provides API to meassure and get count for specific perf events. > +The sampling interface provides API to measure and get count for specific perf events. > > The following test tries to explain count on `sampling.c` example. > > It is by no means complete guide to sampling, but shows libperf basic API for sampling. > > -The `sampling.c` comes with libbperf package and can be compiled and run like: > +The `sampling.c` comes with libperf package and can be compiled and run like: > > [source,bash] > -- > @@ -33,7 +33,8 @@ cpu 0, pid 4465, tid 4470, ip 7f84fe0ebebf, period 176 > > It requires root access, because it uses hardware cycles event. > > -The `sampling.c` example profiles/samples all CPUs with hardware cycles, in a nutshel it: > +The `sampling.c` example profiles/samples all CPUs with hardware cycles, in a > +nutshell it: > > - creates events > - adds them to the event list > @@ -90,7 +91,7 @@ Once the setup is complete we start by defining cycles event using the `struct p > 36 }; > -- > > -Next step is to prepare cpus map. > +Next step is to prepare CPUs map. > > In this case we will monitor all the available CPUs: > > @@ -152,7 +153,7 @@ Once the events list is open, we can create memory maps AKA perf ring buffers: > -- > > The event is created as disabled (note the `disabled = 1` assignment above), > -so we need to enable the events list explicitely. > +so we need to enable the events list explicitly. > > From this moment the cycles event is sampling. > > @@ -212,7 +213,7 @@ Each sample needs to get parsed: > 106 cpu, pid, tid, ip, period); > -- > > -And finaly cleanup. > +And finally cleanup. > > We close the whole events list (both events) and remove it together with the threads map: > > diff --git a/tools/lib/perf/Documentation/libperf.txt b/tools/lib/perf/Documentation/libperf.txt > index 5a6bb512789d..0c74c30ed23a 100644 > --- a/tools/lib/perf/Documentation/libperf.txt > +++ b/tools/lib/perf/Documentation/libperf.txt > @@ -29,7 +29,7 @@ SYNOPSIS > void libperf_init(libperf_print_fn_t fn); > -- > > -*API to handle cpu maps:* > +*API to handle CPU maps:* > > [source,c] > -- > @@ -217,7 +217,7 @@ Following objects are key to the libperf interface: > > [horizontal] > > -struct perf_cpu_map:: Provides a cpu list abstraction. > +struct perf_cpu_map:: Provides a CPU list abstraction. > > struct perf_thread_map:: Provides a thread list abstraction. > > -- > 2.25.1 > -- - Arnaldo