1Description
2===========
3
4The OpenBMC debugtools tarball clashes with the filesystem layout of
5witherspoon systems, and contains a number of other outstanding issues with
6respect to the tools it deploys. The debug script here documents and executes
7the workarounds necessary to make it functional.
8
9Usage
10-----
11```
12./debug [USER@]HOST TARBALL
13```
14
15For example:
16
17```
18$ ./debug root@my-witherspoon obmc-phosphor-debug-tarball-witherspoon.tar.xz
19```
20
21Notes
22-----
23
24The script will:
25
261. Ensure `/usr/local` is a tmpfs mountpoint (may not be if system is
27   configured for Field Mode)
282. Deploy the debugtools tarball to `/usr/local`
293. Make `perf(1)` work by
30   1. Installing a fake `expand(1)` if necessary
31   2. Fixing the `objdump(1)` symlink
32   3. Disabling `perf(1)`'s buildid tracking (fills the RW filesystem)
334. Make `latencytop(1)` work by deploying and symlinking libncurses{,w}.so
34