Use env to find bpftrace

docs/reference_guide.md

@@ -170,10 +170,11 @@ iscsid is sleeping.
 [...]
 ```
 
-It can also be made executable to run stand-alone. Start by adding an interpreter line at the top (`#!`) with the path to your installed bpftrace (/usr/local/bin is the default):
+It can also be made executable to run stand-alone. Start by adding an interpreter line at the top (`#!`) with either the path to your installed bpftrace (/usr/local/bin is the default) or the path to `env` (usually just `/usr/bin/env`) followed by `bpftrace` (so it will find bpftrace in your `$PATH`):
 
 ```
      1	#!/usr/local/bin/bpftrace
+     1	#!/usr/bin/env bpftrace
      2	
      3	tracepoint:syscalls:sys_enter_nanosleep
      4	{

tools/bashreadline.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * bashreadline    Print entered bash commands from all running shells.
  *                 For Linux, uses bpftrace and eBPF.

tools/biolatency.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * biolatency.bt	Block I/O latency as a histogram.
  *			For Linux, uses bpftrace, eBPF.

tools/biosnoop.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * biosnoop.bt   Block I/O tracing tool, showing per I/O latency.
  *               For Linux, uses bpftrace, eBPF.

tools/bitesize.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * bitesize	Show disk I/O size as a histogram.
  *		For Linux, uses bpftrace and eBPF.

tools/capable.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * capable	Trace security capabilitiy checks (cap_capable()).
  *		For Linux, uses bpftrace and eBPF.

tools/cpuwalk.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * cpuwalk	Sample which CPUs are executing processes.
  *		For Linux, uses bpftrace and eBPF.

tools/dcsnoop.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * dcsnoop	Trace directory entry cache (dcache) lookups.
  *		For Linux, uses bpftrace and eBPF.

tools/execsnoop.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * execsnoop.bt   Trace new processes via exec() syscalls.
  *                For Linux, uses bpftrace and eBPF.

tools/gethostlatency.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * gethostlatency	Trace getaddrinfo/gethostbyname[2] calls.
  *			For Linux, uses bpftrace and eBPF.

tools/killsnoop.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * killsnoop	Trace signals issued by the kill() syscall.
  *		For Linux, uses bpftrace and eBPF.

tools/loads.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * loads	Prints load averages.
  *		For Linux, uses bpftrace and eBPF.

tools/mdflush.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * mdflush	Trace md flush events.
  *		For Linux, uses bpftrace and eBPF.

tools/oomkill.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * oomkill	Trace OOM killer.
  *		For Linux, uses bpftrace and eBPF.

tools/opensnoop.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * opensnoop	Trace open() syscalls.
  *		For Linux, uses bpftrace and eBPF.

tools/pidpersec.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * pidpersec	Count new procesess (via fork).
  *		For Linux, uses bpftrace and eBPF.

tools/runqlat.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * runqlat.bt	CPU scheduler run queue latency as a histogram.
  *		For Linux, uses bpftrace, eBPF.

tools/runqlen.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * runqlen.bt	CPU scheduler run queue length as a histogram.
  *		For Linux, uses bpftrace, eBPF.

tools/statsnoop.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * statsnoop	Trace stat() syscalls.
  *		For Linux, uses bpftrace and eBPF.

tools/syncsnoop.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * syncsnoop	Trace sync() variety of syscalls.
  *		For Linux, uses bpftrace and eBPF.

tools/syscount.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * syscount.bt	Count system callls.
  *		For Linux, uses bpftrace, eBPF.

tools/vfscount.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * vfscount	Count VFS calls ("vfs_*").
  *		For Linux, uses bpftrace and eBPF.

tools/vfsstat.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * vfsstat	Count some VFS calls, with per-second summaries.
  *		For Linux, uses bpftrace and eBPF.

tools/writeback.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * writeback	Trace file system writeback events with details.
  * 		For Linux, uses bpftrace and eBPF.

tools/xfsdist.bt

-#!/usr/local/bin/bpftrace
+#!/usr/bin/env bpftrace
 /*
  * xfsdist	Summarize XFS operation latency.
  *		For Linux, uses bpftrace and eBPF.