https://github.com/llnl/callpath

Library for representing callpaths consistently in distributed-memory performance tools.
https://github.com/llnl/callpath

performance shell

Last synced: 7 days ago
JSON representation

Library for representing callpaths consistently in distributed-memory performance tools.

• Host: GitHub
• URL: https://github.com/llnl/callpath
• Owner: LLNL
• License: other
• Created: 2010-10-15T06:27:28.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2018-02-14T17:51:51.000Z (almost 7 years ago)
• Last Synced: 2024-06-15T00:02:51.239Z (5 months ago)
• Topics: performance, shell
• Language: Shell
• Homepage:
• Size: 437 KB
• Stars: 7
• Watchers: 6
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Callpath

==========================================

by Todd Gamblin, [email protected]

This is the callpath library, a tool for representing callpath information

consistently in distributed-memory parallel applications.

See the `LICENSE` file for license and distribution information.

Directory structure

------------------------------------------

    callpath/

      build/     # contains sample cmake build line scripts

      cmake/     # Extra build files an find modules

      doc/       # target directory for doxygen

      scripts/   # scripts to be installed to $prefix/bin

      src/       # Callpath library source code

      tests/     # Test programs for callpath library

Building

------------------------------------------

To build, you need to use cmake.  We recommend that you build out of source.

That is, you should make a directory to build in first.  e.g., to build with

backtrace:

    mkdir $SYS_TYPE && cd $SYS_TYPE

    cmake \

        -D CMAKE_INSTALL_PREFIX=/path/to/install \

        -D CALLPATH_WALKER=backtrace  \

        -D CMAKE_BUILD_TYPE=RelWithDebInfo \

        ..

    make -j8

    make -j8 install

To build with Dyninst you need to tell CMake where dyninst and its deps live, e.g.:

    cmake \

        -D CMAKE_INSTALL_PREFIX=/path/to/install \

        -D CMAKE_BUILD_TYPE=RelWithDebInfo \

        -D CALLPATH_WALKER=dyninst \

        -D Dyninst_DIR=/usr/global/tools/dyninst/stackwalker/$SYS_TYPE/current \

        -D DWARF_DIR=/usr/global/tools/dyninst/libdwarf/$SYS_TYPE/dwarf-20111030 \

        ..

To build on Blue Gene machines, you will need to use a toolchain file.  We include

some sample toolchain files in `cmake/Toolchain`:

    cmake \

        -D CMAKE_TOOLCHAIN_FILE=../cmake/Toolchain/BlueGeneQ-gnu.cmake \

        -D CMAKE_INSTALL_PREFIX=/path/to/install \

        -D CMAKE_BUILD_TYPE=RelWithDebInfo \

        -D CALLPATH_WALKER=dyninst \

        -D Dyninst_DIR=/usr/global/tools/dyninst/stackwalker/$SYS_TYPE/current \

        -D DWARF_DIR=/usr/global/tools/dyninst/libdwarf/$SYS_TYPE/dwarf-20111030 \

        ..

You can find some more sample CMake command lines in the scripts in the `build`

directory.

Directory structure

------------------------------------------

    callpath/

      build/     # contains sample cmake build line scripts

      cmake/     # Extra build files an find modules

      doc/       # target directory for doxygen

      scripts/   # scripts to be installed to $prefix/bin

      src/       # Callpath library source code

      tests/     # Test programs for callpath library