MAP

Describes how to use Linaro MAP.

• Get started with MAP
  • Welcome page
  • Express Launch (MAP)
    • Run dialog box
  • Prepare a program for profiling
    • Debug symbols
    • Disable function inlining
    • Disable tail call optimization
    • Linking
    • Dynamic linking on Cray X-Series systems
    • Static linking
    • Static linking on Cray X-Series systems
    • Dynamic and static linking on Cray X-Series systems using the modules environment
    • map-link modules installation on Cray X-Series
    • Unsupported user applications
  • Profile a program
    • Application
    • Duration
    • Metrics
    • Capture Environment Variables
    • MPI
    • OpenMP
    • Environment variable
    • Profiling
    • Profiling only part of a program
  • remote-exec required by some MPIs (MAP)
  • Profile a single-process program
  • Send standard input (MAP)
  • Start a job in a queue (MAP)
  • Use custom MPI scripts (MAP)
  • Start MAP from a job script
  • Numactl (MAP)
• MAP user interface
• Program details
  • Profile Metadata
  • Environment Variables
  • Performance Report
• Time display mode
  • Time display toggle button
• Program output
  • View standard output and error
  • Restrict output
  • Save output
• Source code (MAP)
  • View source code (MAP)
  • OpenMP programs
  • GPU programs
    • NVIDIA CUDA Kernel Analysis
  • Complex code: code folding
  • Edit source code (MAP)
  • Rebuild and restart (MAP)
  • Commit changes (MAP)
• Selected lines view
  • Use Selected lines view
  • NVIDIA GPU CUDA profiles
  • Limitations
• Stacks view
• OpenMP Regions view
• Functions view
• Library view
• Project Files view
• Metrics view
  • User interface
  • CPU instructions
    • CPU instruction metrics available on x86_64 systems
    • CPU instruction metrics available on Arm®v8-A systems
  • CPU time
  • I/O
  • Memory
  • MPI calls
  • Detecting MPI imbalance
  • Accelerator
    • NVIDIA
    • AMD
  • Energy
  • Requirements
  • Lustre
  • Zooming
  • View totals across processes and nodes
  • Custom metrics
• Thread affinity advisor
  • Affinity binding snapshots
  • Affinity binding variables
  • Node topology viewer
  • Exemplar nodes
  • Processes and threads
  • Commentary
• Compiler remarks
  • Setting build directories
  • Source code annotations
  • Remarks filtering
  • Embedding remarks
• MPI Call Statistics dialog
  • MPI call table and statistics
  • MPI call histogram
• Configurable Perf metrics
  • Performance events
  • Permissions
  • Probe target hosts
  • Specify Perf metrics using the Run window
  • Specify Perf metrics using the command line
  • Specify Perf metrics using a file
  • View events
  • Advanced configuration
• Main-thread, OpenMP, and Thread view modes
  • Main thread only mode
  • OpenMP mode
  • Thread mode
• Processes and cores window
• Run MAP from the command line
  • Command line arguments
  • Profile MPMD programs
  • Profile MPMD programs without Express Launch
• Export profiler data in JSON format
  • JSON format
    • info object
    • samples object
  • Activities
    • Description of categories
    • Main Thread Activity Categories
    • OpenMP and Pthreads Activity Categories
  • Metrics
  • Example JSON output
• NVIDIA GPU profiling
  • GPU Kernels tab
  • CUDA Kernel analysis
  • Memory transfers analysis
  • Compilation
  • Performance impact
    • CUDA kernel analysis
    • CUDA memory transfer analysis
    • Overhead mitigation
  • Customize NVIDIA GPU profiling behavior
  • Known issues for NVIDIA GPU profiling
• AMD GPU profiling
  • GPU Kernels tab
  • Compilation
  • Known issues for AMD GPU profiling
• Python profiling
  • Profile a Python script
    • About this task
    • Procedure
    • Results
    • Example: Profiling a simple Python script
    • Next steps
    • Related information
  • Known issues for Python profiling
• Performance analysis with Caliper instrumentation
  • Get Caliper
  • Annotate your program
    • Annotate in C/C++
    • Annotate in Fortran
  • Analyze your program
    • Procedure
    • Results
  • Guidelines
    • Next steps
    • Related information
• Arm Statistical Profiling Extension (SPE)
  • Arm SPE Prerequisites
  • Enable Arm SPE from the command line
  • Enable Arm SPE from the Run dialog
  • Analyze your program
  • Guidelines
  • Memlock limit exceeded
    • Solution
    • Solution
  • Arm SPE disabled on Amazon Web Services
    • Solution
    • Solution
  • Known issues for Arm SPE