public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
From: Jiri Olsa <jolsa@kernel.org>
To: Arnaldo Carvalho de Melo <acme@kernel.org>
Cc: lkml <linux-kernel@vger.kernel.org>,
	Ingo Molnar <mingo@kernel.org>,
	Namhyung Kim <namhyung@kernel.org>,
	Alexander Shishkin <alexander.shishkin@linux.intel.com>,
	Peter Zijlstra <a.p.zijlstra@chello.nl>,
	Michael Petlan <mpetlan@redhat.com>
Subject: [PATCH 0/3] perf/libperf move
Date: Fri,  6 Dec 2019 14:55:10 +0100	[thread overview]
Message-ID: <20191206135513.31586-1-jolsa@kernel.org> (raw)

hi,
this patchset moves libperf under tools/lib.
It's now possible to build and install it with:

  $ cd tools/lib/perf
  $ make prefix=/tmp/libperf install
    INSTALL  libperf.a
    INSTALL  libperf.so
    INSTALL  libperf.so.0
    INSTALL  libperf.so.0.0.1
    INSTALL  headers
    INSTALL  libperf.pc
    INSTALL  man
    INSTALL  html
    INSTALL  examples
  $ find /tmp/libperf/ -not -type d
  /tmp/libperf/share/doc/libperf/examples/sampling.c
  /tmp/libperf/share/doc/libperf/examples/counting.c
  /tmp/libperf/share/doc/libperf/html/libperf-sampling.html
  /tmp/libperf/share/doc/libperf/html/libperf-counting.html
  /tmp/libperf/share/doc/libperf/html/libperf.html
  /tmp/libperf/share/man/man7/libperf-sampling.7
  /tmp/libperf/share/man/man7/libperf-counting.7
  /tmp/libperf/share/man/man3/libperf.3
  /tmp/libperf/include/perf/mmap.h
  /tmp/libperf/include/perf/event.h
  /tmp/libperf/include/perf/evsel.h
  /tmp/libperf/include/perf/evlist.h
  /tmp/libperf/include/perf/threadmap.h
  /tmp/libperf/include/perf/cpumap.h
  /tmp/libperf/include/perf/core.h
  /tmp/libperf/lib64/pkgconfig/libperf.pc
  /tmp/libperf/lib64/libperf.so.0.0.1
  /tmp/libperf/lib64/libperf.so.0
  /tmp/libperf/lib64/libperf.so
  /tmp/libperf/lib64/libperf.a

There are few obvious fixes added like include path changes,
that I put in separate patch, because they would get lost in
the big move changes.

Plus adding Documentation changes to have the man page base
for more additions. I switched man pages to asciidoc and
added 3 man pages:

  libperf.3          - overall description
  libperf-counting.7 - counting basics explained on simple example
  libperf-sampling.7 - sampling basics explained on simple example

The plan is to add more man pages to cover the basic API.

I put the html pages in here for you to check:
  http://people.redhat.com/~jolsa/libperf/libperf.html
  http://people.redhat.com/~jolsa/libperf/libperf-counting.html
  http://people.redhat.com/~jolsa/libperf/libperf-sampling.html

It's also available in here:
  git://git.kernel.org/pub/scm/linux/kernel/git/jolsa/perf.git
  perf/lib

NOTE we are still able to change any libperf ABI,
nothing is committed by this move ;-)

NOTE 'make perf-targz-src-pkg' works nicely with this change,
but is currently failing because of recent bpf changes, I have
a fix for that and will send it shortly

thanks,
jirka


---
Jiri Olsa (3):
      libperf: Move libperf under tools/lib/perf
      libperf: Additional fixes
      libperf: Add man pages

 tools/{perf/lib => lib/perf}/Build                        |   0
 tools/lib/perf/Documentation/Makefile                     | 156 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 tools/lib/perf/Documentation/asciidoc.conf                | 120 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 tools/lib/perf/Documentation/examples/sampling.c          | 119 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 tools/lib/perf/Documentation/libperf-counting.txt         | 211 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 tools/lib/perf/Documentation/libperf-sampling.txt         | 243 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 tools/lib/perf/Documentation/libperf.txt                  | 246 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 tools/lib/perf/Documentation/manpage-1.72.xsl             |  14 +++++++++
 tools/lib/perf/Documentation/manpage-base.xsl             |  35 +++++++++++++++++++++
 tools/lib/perf/Documentation/manpage-bold-literal.xsl     |  17 +++++++++++
 tools/lib/perf/Documentation/manpage-normal.xsl           |  13 ++++++++
 tools/lib/perf/Documentation/manpage-suppress-sp.xsl      |  21 +++++++++++++
 tools/{perf/lib => lib/perf}/Makefile                     |   7 +++--
 tools/{perf/lib => lib/perf}/core.c                       |   0
 tools/{perf/lib => lib/perf}/cpumap.c                     |   0
 tools/{perf/lib => lib/perf}/evlist.c                     |   0
 tools/{perf/lib => lib/perf}/evsel.c                      |   0
 tools/{perf/lib => lib/perf}/include/internal/cpumap.h    |   0
 tools/{perf/lib => lib/perf}/include/internal/evlist.h    |   0
 tools/{perf/lib => lib/perf}/include/internal/evsel.h     |   0
 tools/{perf/lib => lib/perf}/include/internal/lib.h       |   0
 tools/{perf/lib => lib/perf}/include/internal/mmap.h      |   0
 tools/{perf/lib => lib/perf}/include/internal/tests.h     |   0
 tools/{perf/lib => lib/perf}/include/internal/threadmap.h |   0
 tools/{perf/lib => lib/perf}/include/internal/xyarray.h   |   0
 tools/{perf/lib => lib/perf}/include/perf/core.h          |   0
 tools/{perf/lib => lib/perf}/include/perf/cpumap.h        |   0
 tools/{perf/lib => lib/perf}/include/perf/event.h         |   0
 tools/{perf/lib => lib/perf}/include/perf/evlist.h        |   0
 tools/{perf/lib => lib/perf}/include/perf/evsel.h         |   0
 tools/{perf/lib => lib/perf}/include/perf/mmap.h          |   0
 tools/{perf/lib => lib/perf}/include/perf/threadmap.h     |   0
 tools/{perf/lib => lib/perf}/internal.h                   |   0
 tools/{perf/lib => lib/perf}/lib.c                        |   0
 tools/{perf/lib => lib/perf}/libperf.map                  |   0
 tools/{perf/lib => lib/perf}/libperf.pc.template          |   0
 tools/{perf/lib => lib/perf}/mmap.c                       |   0
 tools/{perf/lib => lib/perf}/tests/Makefile               |   2 +-
 tools/{perf/lib => lib/perf}/tests/test-cpumap.c          |   0
 tools/{perf/lib => lib/perf}/tests/test-evlist.c          |   0
 tools/{perf/lib => lib/perf}/tests/test-evsel.c           |   0
 tools/{perf/lib => lib/perf}/tests/test-threadmap.c       |   0
 tools/{perf/lib => lib/perf}/threadmap.c                  |   0
 tools/{perf/lib => lib/perf}/xyarray.c                    |   0
 tools/perf/MANIFEST                                       |   1 +
 tools/perf/Makefile.config                                |   2 +-
 tools/perf/Makefile.perf                                  |   2 +-
 tools/perf/lib/Documentation/Makefile                     |   7 -----
 tools/perf/lib/Documentation/man/libperf.rst              | 100 -----------------------------------------------------------
 tools/perf/lib/Documentation/tutorial/tutorial.rst        | 123 -------------------------------------------------------------------------
 50 files changed, 1204 insertions(+), 235 deletions(-)
 rename tools/{perf/lib => lib/perf}/Build (100%)
 create mode 100644 tools/lib/perf/Documentation/Makefile
 create mode 100644 tools/lib/perf/Documentation/asciidoc.conf
 create mode 100644 tools/lib/perf/Documentation/examples/sampling.c
 create mode 100644 tools/lib/perf/Documentation/libperf-counting.txt
 create mode 100644 tools/lib/perf/Documentation/libperf-sampling.txt
 create mode 100644 tools/lib/perf/Documentation/libperf.txt
 create mode 100644 tools/lib/perf/Documentation/manpage-1.72.xsl
 create mode 100644 tools/lib/perf/Documentation/manpage-base.xsl
 create mode 100644 tools/lib/perf/Documentation/manpage-bold-literal.xsl
 create mode 100644 tools/lib/perf/Documentation/manpage-normal.xsl
 create mode 100644 tools/lib/perf/Documentation/manpage-suppress-sp.xsl
 rename tools/{perf/lib => lib/perf}/Makefile (96%)
 rename tools/{perf/lib => lib/perf}/core.c (100%)
 rename tools/{perf/lib => lib/perf}/cpumap.c (100%)
 rename tools/{perf/lib => lib/perf}/evlist.c (100%)
 rename tools/{perf/lib => lib/perf}/evsel.c (100%)
 rename tools/{perf/lib => lib/perf}/include/internal/cpumap.h (100%)
 rename tools/{perf/lib => lib/perf}/include/internal/evlist.h (100%)
 rename tools/{perf/lib => lib/perf}/include/internal/evsel.h (100%)
 rename tools/{perf/lib => lib/perf}/include/internal/lib.h (100%)
 rename tools/{perf/lib => lib/perf}/include/internal/mmap.h (100%)
 rename tools/{perf/lib => lib/perf}/include/internal/tests.h (100%)
 rename tools/{perf/lib => lib/perf}/include/internal/threadmap.h (100%)
 rename tools/{perf/lib => lib/perf}/include/internal/xyarray.h (100%)
 rename tools/{perf/lib => lib/perf}/include/perf/core.h (100%)
 rename tools/{perf/lib => lib/perf}/include/perf/cpumap.h (100%)
 rename tools/{perf/lib => lib/perf}/include/perf/event.h (100%)
 rename tools/{perf/lib => lib/perf}/include/perf/evlist.h (100%)
 rename tools/{perf/lib => lib/perf}/include/perf/evsel.h (100%)
 rename tools/{perf/lib => lib/perf}/include/perf/mmap.h (100%)
 rename tools/{perf/lib => lib/perf}/include/perf/threadmap.h (100%)
 rename tools/{perf/lib => lib/perf}/internal.h (100%)
 rename tools/{perf/lib => lib/perf}/lib.c (100%)
 rename tools/{perf/lib => lib/perf}/libperf.map (100%)
 rename tools/{perf/lib => lib/perf}/libperf.pc.template (100%)
 rename tools/{perf/lib => lib/perf}/mmap.c (100%)
 rename tools/{perf/lib => lib/perf}/tests/Makefile (93%)
 rename tools/{perf/lib => lib/perf}/tests/test-cpumap.c (100%)
 rename tools/{perf/lib => lib/perf}/tests/test-evlist.c (100%)
 rename tools/{perf/lib => lib/perf}/tests/test-evsel.c (100%)
 rename tools/{perf/lib => lib/perf}/tests/test-threadmap.c (100%)
 rename tools/{perf/lib => lib/perf}/threadmap.c (100%)
 rename tools/{perf/lib => lib/perf}/xyarray.c (100%)
 delete mode 100644 tools/perf/lib/Documentation/Makefile
 delete mode 100644 tools/perf/lib/Documentation/man/libperf.rst
 delete mode 100644 tools/perf/lib/Documentation/tutorial/tutorial.rst


             reply	other threads:[~2019-12-06 13:55 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-12-06 13:55 Jiri Olsa [this message]
2019-12-06 13:55 ` [PATCH 1/3] libperf: Move libperf under tools/lib/perf Jiri Olsa
2019-12-06 14:27   ` Arnaldo Carvalho de Melo
2019-12-06 15:07     ` Jiri Olsa
2019-12-06 15:33       ` Arnaldo Carvalho de Melo
2019-12-06 15:38         ` Jiri Olsa
2019-12-06 13:55 ` [PATCH 2/3] libperf: Additional fixes Jiri Olsa
2019-12-06 13:55 ` [PATCH 3/3] libperf: Add man pages Jiri Olsa
2019-12-06 14:21 ` [PATCH 0/3] perf/libperf move Arnaldo Carvalho de Melo
2019-12-06 14:34   ` Jiri Olsa

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20191206135513.31586-1-jolsa@kernel.org \
    --to=jolsa@kernel.org \
    --cc=a.p.zijlstra@chello.nl \
    --cc=acme@kernel.org \
    --cc=alexander.shishkin@linux.intel.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mingo@kernel.org \
    --cc=mpetlan@redhat.com \
    --cc=namhyung@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox