@@ -29,12 +29,10 @@ multiple tracing sessions.
2929** Commands:**
3030
3131` tracebox ctl start `
32- : Starts ` traced ` and ` traced_probes ` in the background. On Linux, running
33- as root (via ` sudo ` ) is highly recommended to place sockets in the standard
34- ` /run/perfetto/ ` directory.
32+ : Starts ` traced ` and ` traced_probes ` in the background.
3533
3634` tracebox ctl stop `
37- : Stops daemons started via ` ctl start ` and cleans up PID files .
35+ : Stops daemons started via ` ctl start ` .
3836
3937` tracebox ctl status `
4038: Checks if daemons are running, accessible, and which sockets they are using.
@@ -43,14 +41,14 @@ multiple tracing sessions.
4341
4442``` bash
4543# Start services once (as root for full system/SDK support)
46- sudo ./tracebox ctl start
44+ ./tracebox ctl start
4745
4846# Record multiple traces
49- sudo ./tracebox -t 10s -o trace1.pftrace sched
50- sudo ./tracebox -t 10s -o trace2.pftrace sched
47+ ./tracebox -t 10s -o trace1.pftrace sched
48+ ./tracebox -t 10s -o trace2.pftrace sched
5149
5250# Stop services when finished
53- sudo ./tracebox ctl stop
51+ ./tracebox ctl stop
5452```
5553
5654### 2. Autodaemonize Mode
@@ -65,7 +63,7 @@ Pass the `--autodaemonize` flag before other arguments.
6563
6664``` bash
6765# Start daemons, record trace, stop daemons
68- sudo ./tracebox --autodaemonize -t 10s -o trace.pftrace sched
66+ ./tracebox --autodaemonize -t 10s -o trace.pftrace sched
6967```
7068
7169### 3. Applet Mode
@@ -94,7 +92,7 @@ This is the preferred mode for most workflows.
9492
9593* ** SDK/App Tracing:** If you are tracing applications instrumented with the
9694 Perfetto SDK (using ` track_event ` ), you ** must** use Managed Mode (usually
97- as root). SDK applications only connect to the standard system socket paths
95+ as root). SDK applications connect to the standard system socket paths
9896 (e.g., ` /run/perfetto/ ` on Linux).
9997* ** Repeated Tracing:** If you are recording multiple traces in succession,
10098 Managed Mode avoids the overhead of restarting the services for every trace.
@@ -107,6 +105,3 @@ This is the preferred mode for most workflows.
107105 you want to ensure no leftover processes remain after execution.
108106* ** Debugging:** Quick verification of ftrace events where setting up a full
109107 service is unnecessary.
110- * ** Limitations:** This mode uses private, randomized socket paths (e.g., in
111- ` /tmp/ ` ). Applications using the Perfetto SDK ** cannot** connect to these
112- daemons, so you will not capture userspace instrumentation.
0 commit comments