bionic (1) pathod.1.gz

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:

              http://localhost:9999/p/200:b@100

       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                                        pathod(1)