|
51 | 51 | <li class="toctree-l2"><a class="reference internal" href="#basic-usages">Basic Usages</a> |
52 | 52 | </li> |
53 | 53 | <li class="toctree-l2"><a class="reference internal" href="#command-options">Command Options</a> |
54 | | - <ul> |
55 | | - <li class="toctree-l3"><a class="reference internal" href="#core-options">Core options</a> |
56 | | - </li> |
57 | | - <li class="toctree-l3"><a class="reference internal" href="#advance-options">Advance options</a> |
58 | | - </li> |
59 | | - </ul> |
60 | 54 | </li> |
61 | 55 | </ul> |
62 | 56 | </li> |
@@ -127,29 +121,33 @@ <h2 id="prerequisites">Prerequisites</h2> |
127 | 121 | pacman -S bcc bcc-tools python-bcc |
128 | 122 | </code></pre> |
129 | 123 | <p>For more distros, visit the official BCC's <a href="https://github.com/iovisor/bcc/blob/master/INSTALL.md">installation guide</a></p> |
| 124 | +<p>Finally, install process monitor</p> |
| 125 | +<pre><code>sudo apt install python3-psutil |
| 126 | +</code></pre> |
130 | 127 | <h2 id="basic-usages">Basic Usages</h2> |
131 | | -<p>Infinite tracing (Exit on demand)</p> |
| 128 | +<p>Start tracing</p> |
132 | 129 | <pre><code class="language-bash">sudo python3 iotrc.py |
133 | 130 | </code></pre> |
134 | | -<p>Quick Start (30 Seconds Trace)</p> |
135 | | -<pre><code class="language-bash">sudo python3 iotrc.py -d 30 |
| 131 | +<p>Tracing with <a href="../privacy/">anonymization</a></p> |
| 132 | +<pre><code class="language-bash">sudo python3 iotrc.py -a |
| 133 | +</code></pre> |
| 134 | +<p>Tracing with automatic upload</p> |
| 135 | +<pre><code class="language-bash">sudo python3 iotrc.py -au |
136 | 136 | </code></pre> |
137 | 137 | <h2 id="command-options">Command Options</h2> |
138 | | -<h3 id="core-options">Core options</h3> |
139 | | -<ul> |
140 | | -<li><code>-d, --duration <seconds></code> - Duration to trace (default: indefinite)</li> |
141 | | -<li><code>-o, --output <directory></code> - Output directory (default: auto-generated)</li> |
142 | | -<li><code>-v, --verbose</code> - Enable verbose logging</li> |
143 | | -<li><code>-a, --anonimize</code> - Anonymize process and file names </li> |
144 | | -</ul> |
145 | | -<h3 id="advance-options">Advance options</h3> |
146 | | -<ul> |
147 | | -<li><code>-b BPF_FILE, --bpf-file BPF_FILE</code> - BPF C source file path</li> |
148 | | -<li><code>-p PAGE_CNT, --page-cnt PAGE_CNT</code> - Number of pages for perf buffer (default 8)</li> |
149 | | -<li><code>-s SPLIT_THRESHOLD, --split_threshold SPLIT_THRESHOLD</code> - Split threshold in seconds (default 1 day)</li> |
150 | | -<li><code>-a, --anonimize</code> - Enable anonymization of process and file names</li> |
151 | | -<li><code>-uc, --uncompressed</code> - Enable uncompressed output</li> |
152 | | -</ul> |
| 138 | +<pre><code>usage: iotrc.py [-h] [-o OUTPUT] [-v VERBOSE] [-a] [-au] |
| 139 | + |
| 140 | +Trace IO syscalls |
| 141 | + |
| 142 | +options: |
| 143 | + -h, --help show this help message and exit |
| 144 | + -o OUTPUT, --output OUTPUT |
| 145 | + Output Directory for logging, must be new! |
| 146 | + -v VERBOSE, --verbose VERBOSE |
| 147 | + Print verbose output |
| 148 | + -a, --anonimize Enable anonymization of process and file names |
| 149 | + -au, --auto-upload Enable anonymization of process and file names |
| 150 | +</code></pre> |
153 | 151 |
|
154 | 152 | </div> |
155 | 153 | </div><footer> |
|
0 commit comments