kernel-shark: Make some top level "make" changes and documention updates
v2 cover kernel-shark: Make some top level "make" changes and documention updates
This is built on top of the three patches from Yordan that can be found here:
https://patchwork.kernel.org/project/linux-trace-devel/list/?series=132531
It makes "make clean" remove cmake generated files (my build failed and I couldn't figure out why. "make clean" should allow builds to build again when CMake files change).
I also adde a "make BUILD_TYPE=foo" to pass to the cmake command to change the CMAKE_BUILD_TYPE to allow an easy build by the package maintainers to change how KernelShark is built.
It also updates the README with the current way to build KernelShark.
Changes from v1:
- Added a patch to first change the README to the latest make process
- Incorporated Yordan's suggestions about breaking up the build documentation into two sections, one explaining the "simple" method from the toplevel git repo, and the other explaining the "expert" method using cmake directly.
Steven Rostedt (VMware) (3):
kernelshark: Update the README for changes to the make process
kernel-shark: Have "make clean" run cmake-clean.sh
kernel-shark: Add 'make BUILD_TYPE=X gui' to change how the gui is made
----
Makefile | 6 ++++- kernel-shark/CMakeLists.txt | 2 +- kernel-shark/README | 63 +++++++++++++++++++++++++++++++++++++-------- 3 files changed, 58 insertions(+), 13 deletions(-)
PATCH v2 1/3 kernelshark: Update the README for changes to the make process
From: "Steven Rostedt (VMware)" <[email protected]>
The top level git tree's Makefile has code added to build the cmake portion of KernelShark. But the README does not document the process. Bring the README up to speed with how to actually build KernelShark.
--- kernel-shark/README | 50 ++++++++++++++++++++++++++++++++++++--------- 1 file changed, 40 insertions(+), 10 deletions(-)
kernel-shark/README +40 -10
@@ -30,18 +30,47 @@ Building: 1. Follow the instructions given in trace-cmd/README and build the original trace-cmd end traceevent libraries. -2. Do: - cd kernel-shark/build - cmake ../ - make +2. Building KernelShark: + +2.1 There is a simple and expert way to build KernelShark + +2.1.1 Option 1 (simple) : build KernelShark as part of trace-cmd + + (from the toplevel git tree) + + make gui + + This will build the necessary parts of trace-cmd needed + by KernelShark. + +2.1.1.1 By default, the installation prefix is "/usr/local". It can be +changed by passing in "prefix" to the build. + + make prefix=/usr gui -2.1.1 In order to create a Doxygen documentation add -D_DOXYGEN_DOC=1 +2.1.1.2 Use "make clean" if you want to delete all already compiled objects. +Note, this will not clean up the files created by cmake. See section 2.1.2.4 + +2.1.2 Option 2 (expert) : standalone build of KernelShark (for hackers only) + + (note, you may need to do a normal make from the toplevel git + tree before performing the following) + + make + cd kernel-shark/build + cmake ../ + make + + This gives you a bit more control as you may easily pass in + your own cmake options. + +2.1.2.1 In order to create a Doxygen documentation add -D_DOXYGEN_DOC=1 as a CMake Command-Line option. -2.1.2 By default, installation prefix is "/usr/local". It can be changed using +2.1.2.2 By default, installation prefix is "/usr/local". It can be changed using -D_INSTALL_PREFIX= as a CMake Command-Line option. -2.1.3 In addition to the standard CMake build types (Debug, Release, +2.1.2.3 In addition to the standard CMake build types (Debug, Release, RelWithDebInfo, MinSizeRel) KernelShark supports a "Package" build type. By default this build type adds the "-O2" compiler flag. Package maintainers can chose their own compiler flags by providing the corresponding
@@ -57,10 +86,11 @@ Examples: cmake -DCMAKE_BUILD_TYPE=Package -DCMAKE_C_FLAGS_PACKAGE="-O3 -pedantic" ../ -2.2.1 Use "make clean" if you want to delete all already compiled objects. - -2.2.2 Use the script "cmake_clean.sh" if you want to delete all already +2.1.2.4 Use the script "cmake_clean.sh" if you want to delete all already compiled objects and all files generated by CMake. + cd kernel-shark/build + ./cmake-clean.sh + 3. After building the code "kernel-shark/lib" will contain all libraries and "kernel-shark/bin" will contain all executables.
Signature · 1 line
2.20.1
PATCH v2 2/3 kernel-shark: Have "make clean" run cmake-clean.sh
In reply to Steven RostedtFrom: "Steven Rostedt (VMware)" <[email protected]>
A make clean should clean up the cmake files as well.
--- Makefile | 1 + kernel-shark/README | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-)
Makefile +1 -0
@@ -357,6 +357,7 @@ clean: $(MAKE) -C $(src)/python clean $(MAKE) -C $(src)/tracecmd clean if [ -f $(kshark-dir)/build/Makefile ]; then $(MAKE) -C $(kshark-dir)/build clean; fi + cd $(kshark-dir)/build; ./cmake_clean.sh ##### PYTHON STUFF #####
kernel-shark/README +1 -1
@@ -49,7 +49,7 @@ changed by passing in "prefix" to the build. make prefix=/usr gui 2.1.1.2 Use "make clean" if you want to delete all already compiled objects. -Note, this will not clean up the files created by cmake. See section 2.1.2.4 +This will also clean up all the files created by cmake. 2.1.2 Option 2 (expert) : standalone build of KernelShark (for hackers only)
Signature · 1 line
2.20.1
PATCH v2 3/3 kernel-shark: Add make BUILD_TYPE=X gui to change how the gui is made
In reply to Steven RostedtFrom: "Steven Rostedt (VMware)" <[email protected]>
Add a option to the Makefile called "BUILD_TYPE" that is passed to the CMake commonds to change how kernelshark is built. The current options are:
make BUILD_TYPE=Debug gui - for "-g" option
make BUILD_TYPE=Release gui - for "-O3" option
make BUILD_TYPE=RelWithDebInfo gui - for "-g -O2" option (default)
make BUILD_TYPE=MinSizeRel gui - for "-Os" option
By default, BUILD_TYPE is set to RelWithDebInfo.
Also change the CMakeLists.txt to use RelWithDebInfo as the default instead of just Debug.
--- Makefile | 5 ++++- kernel-shark/CMakeLists.txt | 2 +- kernel-shark/README | 13 ++++++++++++- 3 files changed, 17 insertions(+), 3 deletions(-)
Makefile +4 -1
@@ -252,8 +252,11 @@ all_cmd: $(CMD_TARGETS) CMAKE_COMMAND = /usr/bin/cmake +# Build with "BUILD_TYPE=Release" to remove cmake debug info +BUILD_TYPE ?= RelWithDebInfo + $(kshark-dir)/build/Makefile: $(kshark-dir)/CMakeLists.txt - $(Q) cd $(kshark-dir)/build && $(CMAKE_COMMAND) -D_INSTALL_PREFIX=$(prefix) .. + $(Q) cd $(kshark-dir)/build && $(CMAKE_COMMAND) -DCMAKE_BUILD_TYPE=$(BUILD_TYPE) -D_INSTALL_PREFIX=$(prefix) .. gui: force $(CMD_TARGETS) $(kshark-dir)/build/Makefile $(Q)$(MAKE) $(S) -C $(kshark-dir)/build
kernel-shark/CMakeLists.txt +1 -1
@@ -37,7 +37,7 @@ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -pthread -fPIC") set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -std=c++11 -pthread -fPIC") if (NOT CMAKE_BUILD_TYPE) - set(CMAKE_BUILD_TYPE Debug) + set(CMAKE_BUILD_TYPE RelWithDebInfo) endif (NOT CMAKE_BUILD_TYPE) message("\n Build type: ${CMAKE_BUILD_TYPE}")
kernel-shark/README +12 -1
@@ -51,6 +51,16 @@ changed by passing in "prefix" to the build. 2.1.1.2 Use "make clean" if you want to delete all already compiled objects. This will also clean up all the files created by cmake. +2.1.1.3 KernelShark has multiple build types (See section 2.1.2.3 for more +details. By default, the build type is RelWithDebInfo, which will build +a release candidate with debug information. To change the type, pass in +the option BUILD_TYPE=<type> to the make process. + + make BUILD_TYPE=Debug gui - for "-g" option + make BUILD_TYPE=Release gui - for "-O3" option + make BUILD_TYPE=RelWithDebInfo gui - for "-g -O2" option (default) + make BUILD_TYPE=MinSizeRel gui - for "-Os" option + 2.1.2 Option 2 (expert) : standalone build of KernelShark (for hackers only) (note, you may need to do a normal make from the toplevel git
@@ -79,9 +89,10 @@ CMAKE_XXXX_FLAGS_PACKAGE Command-Line options (see the example below). Note that when built as a "Package" the RPATH-s of the executables are set directly to _INSTALL_PREFIX/lib/kernelshark/ -If no build types is specified, the type will be "Debug". +If no build types is specified, the type will be "RelWithDebInfo". Examples: + cmake -D_DOXYGEN_DOC=1 -D_INSTALL_PREFIX=/usr ../ cmake -DCMAKE_BUILD_TYPE=Package -DCMAKE_C_FLAGS_PACKAGE="-O3 -pedantic" ../
Signature · 1 line
2.20.1
Re: [PATCH v2 3/3] kernel-shark: Add make BUILD_TYPE=X gui to change how the gui is made
Quoted 5 lines · Steven Rostedt
From: "Steven Rostedt (VMware)" <[email protected]>
Add a option to the
Makefilecalled "BUILD_TYPE" that is passed to the CMake commonds to change how kernelshark is built. The current options are:
Just fix the typos:
Add a option -> Add an option
commonds -> commands
All patches look good.
Quoted 81 lines
make BUILD_TYPE=Debug gui - for "-g" option
make BUILD_TYPE=Release gui - for "-O3" option
make BUILD_TYPE=RelWithDebInfo gui - for "-g -O2" option (default)
make BUILD_TYPE=MinSizeRel gui - for "-Os" optionBy default,
BUILD_TYPEis set to RelWithDebInfo.Also change the CMakeLists.txt to use RelWithDebInfo as the default instead of just Debug.
Signed-off-by Steven Rostedt (VMware) <[email protected]>--- Makefile | 5 ++++- kernel-shark/CMakeLists.txt | 2 +- kernel-shark/README | 13 ++++++++++++- 3 files changed, 17 insertions(+), 3 deletions(-)Makefile +4
-1@@ -252,8 +252,11 @@ all_cmd: $(CMD_TARGETS) CMAKE_COMMAND = /usr/bin/cmake +# Build with "BUILD_TYPE=Release" to remove cmake debug info +BUILD_TYPE ?= RelWithDebInfo + $(kshark-dir)/build/Makefile: $(kshark-dir)/CMakeLists.txt - $(Q) cd $(kshark-dir)/build && $(CMAKE_COMMAND) -D_INSTALL_PREFIX=$(prefix) .. + $(Q) cd $(kshark-dir)/build && $(CMAKE_COMMAND) -DCMAKE_BUILD_TYPE=$(BUILD_TYPE) -D_INSTALL_PREFIX=$(prefix) .. gui: force $(CMD_TARGETS) $(kshark-dir)/build/Makefile $(Q)$(MAKE) $(S) -C $(kshark-dir)/buildkernel-shark/CMakeLists.txt +1
-1@@ -37,7 +37,7 @@ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -pthread -fPIC") set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -std=c++11 -pthread -fPIC") if (NOT CMAKE_BUILD_TYPE) - set(CMAKE_BUILD_TYPE Debug) + set(CMAKE_BUILD_TYPE RelWithDebInfo) endif (NOT CMAKE_BUILD_TYPE) message("\n Build type: ${CMAKE_BUILD_TYPE}")kernel-shark/README +12
-1@@ -51,6 +51,16 @@ changed by passing in "prefix" to the build. 2.1.1.2 Use "make clean" if you want to delete all already compiled objects. This will also clean up all the files created by cmake. +2.1.1.3 KernelShark has multiple build types (See section 2.1.2.3 for more +details. By default, the build type is RelWithDebInfo, which will build +a release candidate with debug information. To change the type, pass in +the option BUILD_TYPE=<type> to the make process. + + make BUILD_TYPE=Debug gui - for "-g" option + make BUILD_TYPE=Release gui - for "-O3" option + make BUILD_TYPE=RelWithDebInfo gui - for "-g -O2" option (default) + make BUILD_TYPE=MinSizeRel gui - for "-Os" option + 2.1.2 Option 2 (expert) : standalone build of KernelShark (for hackers only) (note, you may need to do a normal make from the toplevel git@@ -79,9 +89,10 @@ CMAKE_XXXX_FLAGS_PACKAGE Command-Line options (see the example below). Note that when built as a "Package" the RPATH-s of the executables are set directly to _INSTALL_PREFIX/lib/kernelshark/ -If no build types is specified, the type will be "Debug". +If no build types is specified, the type will be "RelWithDebInfo". Examples: + cmake -D_DOXYGEN_DOC=1 -D_INSTALL_PREFIX=/usr ../ cmake -DCMAKE_BUILD_TYPE=Package -DCMAKE_C_FLAGS_PACKAGE="-O3 -pedantic" ../