| pathod(1) | pathod(1) |
NAME¶
pathod - a pathological HTTP/S daemon
SYNOPSIS¶
pathod [-h] [--version] [-p PORT] [-l ADDRESS] [-a ANCHOR]
[-c CRAFTANCHOR] [--confdir CONFDIR] [-d STATICDIR] [-D]
[-t TIMEOUT] [--limit-size SIZELIMIT] [--nohang] [--nocraft]
[--webdebug] [-s] [--cn CN] [-C] [--cert SPEC]
[--ciphers CIPHERS] [--san SAN]
[--ssl-version {all|TLSv1_2|secure|TLSv1_1|TLSv1|SSLv3|SSLv2}]
[-e] [-f LOGFILE] [-q] [-r] [-x] [--http2-framedump]
DESCRIPTION¶
pathod is a pathological HTTP daemon designed to let you craft almost any conceivable HTTP response, including ones that creatively violate the standards. HTTP responses are specified using a small, terse language which pathod shares with its evil twin, pathoc. To start playing with pathod, fire up the daemon:
-
$ pathod
By default, the service listens on port 9999 of localhost, and the default crafting anchor point is the path /p/. Anything after this URL prefix is treated as a response specifier. So, hitting the following URL will generate an HTTP 200 response with 100 bytes of random data:
See the language documentation (http://docs.mitmproxy.org/en/latest/pathod/language.html#language) to get (much) fancier.
OPTIONS¶
Optional Arguments:¶
- -h, --help
- Show this help message and exit.
- --version
- Show program's version number and exit.
- -p PORT
- Port. Specify 0 to pick an arbitrary empty port. (Default: 9999)
- -l ADDRESS
- Listening address. (Default: 127.0.0.1)
- -a ANCHOR
- Add an anchor. Specified as a string with the form pattern=spec or pattern=filepath, where pattern is a regular expression.
- -c CRAFTANCHOR
- URL path specifying prefix for URL crafting commands. (Default: /p/)
- --confdir CONFDIR
- Configuration directory. (Default: ~/.mitmproxy)
- -d STATICDIR
- Directory for static files.
- -D
- Daemonize.
- -t TIMEOUT
- Connection timeout.
- --limit-size SIZELIMIT
- Size limit of served responses. Understands size suffixes, e.g. 100k.
- --nohang
- Disable pauses during crafted response generation.
- --nocraft
- Disable response crafting. If anchors are specified, they still work.
- --webdebug
- Debugging mode for the web app (dev only).
SSL:¶
- -s
- Run in HTTPS mode.
- --cn CN
- CN for generated SSL certs. (Default: pathod.net)
- -C
- Don't expect SSL after a CONNECT request.
- --cert SPEC
- Add an SSL certificate. SPEC is of the form "[domain=]path". The domain may include a wildcard, and is equal to "*" if not specified. The file at path is a certificate in PEM format. If a private key is included in the PEM, it is used, otherwise the default key in the conf dir is used. Can be passed multiple times.
- --ciphers CIPHERS
- SSL cipher specification.
- --san SAN
- Subject Altnernate Name to add to the server certificate. May be passed multiple times.
- --ssl-version {all|TLSv1_2|secure|TLSv1_1|TLSv1|SSLv3|SSLv2}
- Set supported SSL/TLS versions. SSLv2, SSLv3 and all are INSECURE. Defaults to secure, which is TLS1.0+.
Controlling Logging:¶
Some of these options expand generated values for logging. If you're generating large data, use them with caution.
- -e
- Explain responses.
- -f LOGFILE
- Log to file.
- -q
- Log full request.
- -r
- Log full response.
- -x
- Log request/response in hexdump format.
- --http2-framedump
- Output all received & sent HTTP/2 frames.
AUTHORS¶
pathod was written by Aldo Cortesi.
This manual page was written for the Debian GNU/Linux system, but its use elsewhere is encouraged.
SEE ALSO¶
pathod documentation and examples are available online at <http://docs.mitmproxy.org/en/latest/pathod/intro.html#pathod>.
| November 2016 |