cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

Build.txt (2173B)

      1
      21) perf build
      3=============
      4The perf build process consists of several separated building blocks,
      5which are linked together to form the perf binary:
      6  - libperf library (static)
      7  - perf builtin commands
      8  - traceevent library (static)
      9  - GTK ui library
     10
     11Several makefiles govern the perf build:
     12
     13  - Makefile
     14    top level Makefile working as a wrapper that calls the main
     15    Makefile.perf with a -j option to do parallel builds.
     16
     17  - Makefile.perf
     18    main makefile that triggers build of all perf objects including
     19    installation and documentation processing.
     20
     21  - tools/build/Makefile.build
     22    main makefile of the build framework
     23
     24  - tools/build/Build.include
     25    build framework generic definitions
     26
     27  - Build makefiles
     28    makefiles that defines build objects
     29
     30Please refer to tools/build/Documentation/Build.txt for more
     31information about build framework.
     32
     33
     342) perf build
     35=============
     36The Makefile.perf triggers the build framework for build objects:
     37   perf, libperf, gtk
     38
     39resulting in following objects:
     40  $ ls  *-in.o
     41  gtk-in.o  libperf-in.o  perf-in.o
     42
     43Those objects are then used in final linking:
     44  libperf-gtk.so <- gtk-in.o  libperf-in.o
     45  perf           <- perf-in.o libperf-in.o
     46
     47
     48NOTE this description is omitting other libraries involved, only
     49     focusing on build framework outcomes
     50
     513) Build with ASan or UBSan
     52==========================
     53  $ cd tools/perf
     54  $ make DESTDIR=/usr
     55  $ make DESTDIR=/usr install
     56
     57AddressSanitizer (or ASan) is a GCC feature that detects memory corruption bugs
     58such as buffer overflows and memory leaks.
     59
     60  $ cd tools/perf
     61  $ make DEBUG=1 EXTRA_CFLAGS='-fno-omit-frame-pointer -fsanitize=address'
     62  $ ASAN_OPTIONS=log_path=asan.log ./perf record -a
     63
     64ASan outputs all detected issues into a log file named 'asan.log.<pid>'.
     65
     66UndefinedBehaviorSanitizer (or UBSan) is a fast undefined behavior detector
     67supported by GCC. UBSan detects undefined behaviors of programs at runtime.
     68
     69  $ cd tools/perf
     70  $ make DEBUG=1 EXTRA_CFLAGS='-fno-omit-frame-pointer -fsanitize=undefined'
     71  $ UBSAN_OPTIONS=print_stacktrace=1 ./perf record -a
     72
     73If UBSan detects any problem at runtime, it outputs a “runtime error:” message.