aboutsummaryrefslogtreecommitdiffstats
path: root/libpathod/templates
diff options
context:
space:
mode:
authorAldo Cortesi <aldo@nullcube.com>2012-11-16 15:00:15 +1300
committerAldo Cortesi <aldo@nullcube.com>2012-11-16 15:00:15 +1300
commitb11260f064ef6f2341d2b637f2e9a4dcc5b9f50c (patch)
treeace9c5da547880a139b0ce92ba2999f9f92ebd81 /libpathod/templates
parent5fb31f916231e8d76da3a3792e8bf596b93556d4 (diff)
downloadmitmproxy-b11260f064ef6f2341d2b637f2e9a4dcc5b9f50c.tar.gz
mitmproxy-b11260f064ef6f2341d2b637f2e9a4dcc5b9f50c.tar.bz2
mitmproxy-b11260f064ef6f2341d2b637f2e9a4dcc5b9f50c.zip
Expand basic fuzzing example.
Diffstat (limited to 'libpathod/templates')
-rw-r--r--libpathod/templates/docs_pathoc.html29
1 files changed, 23 insertions, 6 deletions
diff --git a/libpathod/templates/docs_pathoc.html b/libpathod/templates/docs_pathoc.html
index 5c07aee3..b9338c87 100644
--- a/libpathod/templates/docs_pathoc.html
+++ b/libpathod/templates/docs_pathoc.html
@@ -89,16 +89,33 @@ the command-line help:</p>
a few of its command-line options makes for quite a powerful basic fuzzer.
Here's an example:</p>
- <pre class="terminal">&gt; pathoc -t 2 -n 1000 localhost get:/:b@10:ir,@1</pre>
+ <pre class="terminal">&gt; pathoc -e -C 200 -t 2 -n 1000 localhost get:/:b@10:ir,@1</pre>
<p>The request specified here is a valid GET with a body consisting of 10
random bytes, but with 1 random byte inserted in a random place. This could
be in the headers, in the initial request line, or in the body itself.
- Corrupting the request in this way will often make the server enter a state
- where it's awaiting more input from the client. This is where the <b>-t</b>
- option comes in, which sets a timeout that causes pathoc to disconnect
- after two seconds. Finally, the <b>-n</b> option tells pathoc to repeat the
- request 1000 times.</p>
+ There are a few things to note here:<p>
+
+ <ul>
+
+ <li> Corrupting the request in this way will often make the server
+ enter a state where it's awaiting more input from the client. This is
+ where the <b>-t</b> option comes in, which sets a timeout that causes
+ pathoc to disconnect after two seconds. </li>
+
+ <li> The <b>-n</b> option tells pathoc to repeat the request 1000
+ times.</li>
+
+ <li> The <b>-C</b> option tells pathoc to ignore HTTP 200 response
+ codes. You can use this to fine-tune what pathoc considers to be an
+ exceptional condition, and therefore log-worthy.</li>
+
+ <li> The <b>-e</b> option tells pathoc to print an explanation of each
+ logged request, in the form of an expanded pathoc specification with
+ all random portions and automatic header additions resolved. This lets
+ you precisely replay a request that triggered an error </li>
+
+ </ul>
</section>