# Description

The OpenBMC debugtools tarball clashes with the filesystem layout of witherspoon
systems, and contains a number of other outstanding issues with respect to the
tools it deploys. The debug script here documents and executes the workarounds
necessary to make it functional.

## Usage

```sh
./debug [USER@]HOST TARBALL
```

For example:

```sh
./debug root@my-witherspoon obmc-phosphor-debug-tarball-witherspoon.tar.xz
```

## Notes

The script will:

1. Ensure `/usr/local` is a tmpfs mountpoint (may not be if system is configured
   for Field Mode)
2. Deploy the debugtools tarball to `/usr/local`
3. Make `perf(1)` work by
   1. Installing a fake `expand(1)` if necessary
   2. Fixing the `objdump(1)` symlink
   3. Disabling `perf(1)`'s buildid tracking (fills the RW filesystem)
4. Make `latencytop(1)` work by deploying and symlinking libncurses{,w}.so