---
name: "pathoc"
section: "1"
platform: "linux"
package: "mitmproxy"
version: "0.18.2-6+deb9u2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/pathoc"
---

# pathoc(1)

a perverse HTTP client

## NAME

pathoc - a perverse HTTP client

## SYNOPSIS

pathoc \[-h\] \[--show-uas\] \[--version\] \[-c *HOST*:*PORT*\] \[--memo-limit *N*\]

       \[-m\] \[-n *N*\] \[-w *N*\] \[-r\] \[-t *TIMEOUT*\] \[--http2\]

       \[--http2-skip-connection-preface\] \[-s\] \[-C *CLIENTCERT*\] \[-i *SNI*\]

       \[--ciphers *CIPHERS*\]

       \[--ssl-version {`all`\|`TLSv1_2`\|`secure`\|`TLSv1_1`\|`TLSv1`\|`SSLv3`\|`SSLv2`}\]

       \[-I *IGNORECODES*\] \[-S\] \[-e\] \[-o\] \[-q\] \[-p\] \[-T\] \[-x\]

       \[--http2-framedump\]

       *host*\[:*port*\] *requests* \[*requests* ...\]

## DESCRIPTION

`pathoc` is a perverse HTTP client designed to let you craft almost any conceivable HTTP request, including ones that creatively violate the standards. HTTP requests are specified using a small, terse language, which `pathoc` shares with its server-side twin, `pathod`.

## OPTIONS

### Positional Arguments:

- ***host*\[:*port*\]**

  Host and port to connect to.

- ***requests***

  Request specification, or path to a file containing request specifcations.

### Optional Arguments:

- **-h, --help**

  Show this help message and exit.

- **--show-uas**

  Print user agent shortcuts and exit.

- **--version**

  Show program's version number and exit.

- **-c *HOST*:*PORT***

  Issue an HTTP CONNECT to connect to the specified host.

- **--memo-limit *N***

  Stop if we do not find a valid request after *N* attempts.

- **-m**

  Remember specs, and never play the same one twice.

  Note that this means requests have to be rendered in memory, which means that large generated data can cause issues.

- **-n *N***

  Repeat *N* times. Pass `-1` to repeat infinitely.

- **-w *N***

  Wait *N* seconds between each request.

- **-r**

  Select a random request from those specified. If this is not specified, requests are all played in sequence.

- **-t *TIMEOUT***

  Connection timeout.

- **--http2**

  Perform all requests over a single HTTP/2 connection.

- **--http2-skip-connection-preface**

  Skips the HTTP/2 connection preface before sending requests.

### SSL:

- **-s**

  Connect with SSL.

- **-C *CLIENTCERT***

  Path to a file containing client certificate and private key.

- **-i *SNI***

  SSL Server Name Indication.

- **--ciphers *CIPHERS***

  SSL cipher specification.

- **--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 Output:

Some of these options expand generated values for logging. If you're generating large data, use them with caution.

- **-I *IGNORECODES***

  Comma-separated list of response codes to ignore.

- **-S**

  Show info on SSL connection.

- **-e**

  Explain requests.

- **-o**

  Oneshot - exit after first non-ignored response.

- **-q**

  Print full request.

- **-p**

  Print full response.

- **-T**

  Ignore timeouts.

- **-x**

  Output in hexdump format.

- **--http2-framedump**

  Output all received & sent HTTP/2 frames.

## AUTHORS

`pathoc` was written by Aldo Cortesi.

This manual page was written for the Debian GNU/Linux system, but its use elsewhere is encouraged.

## SEE ALSO

`pathoc` documentation and examples are available online at \<http://docs.mitmproxy.org/en/latest/pathod/intro.html#pathoc\>.