HTTPECHO(1) General Commands Manual
NAME
httpecho — Small and friendly HTTP-Echo server echoing incoming HTTP-Requests to the console.
SYNOPSIS
| httpecho | [ -p <port> ] [ -c <connections> ] [ --path ] [ --query ] [ --header ] [ --body ] [ -u <urlPattern> ] [ --notation <notation> ] [ -v ] [ -d ] |
| httpecho | ∅ | [ -v ] [ -d ] |
| httpecho | -h | --sysinfo [ -v ] |
DESCRIPTION
This manual page documents the httpecho command: The httpecho command listens
on an HTTP port --port and echos incoming HTTP requests’ header --header,
path --path, query --query and body --body with the URL matching a pattern
--url-pattern to the console using a content --notation for the body.
Depending on the executable’s flavor the command might also be named httpecho-x.y.z.jar, httpecho-bundle-x86_64-x.y.z.elf, httpecho-bundle-x86_64-x.y.z.exe, httpecho-installer-x86_64-x.y.z.msi, httpecho-launcher-x.y.z.sh, httpecho-launcher-x86_64-x.y.z.elf, httpecho-launcher-x86_64-x.y.z.exe, httpecho-native-x86_64-x.y.z.elf where x.y.z stands for the version of the httpecho command. The according executable’s name will be referenced to in this manual as httpecho.
OPTIONS
| --body: | Echo the HTTP-Body: When specified, then URL-Path, URL-Query and HTTP-Header are only echoed when the according switches are set. |
| -c --connections <connections>: | Sets the number of max. connections. |
| -d --debug: | Enables the debug mode with additional (developer readable) informational output. |
| -h --help: | Shows this help. |
| --header: | Echo the HTTP-Header: When specified, then the HTTP-Path and Body are only echoed when the according switches are set. |
| --notation <notation>: | The output notation such as: { INI, JAVA, JSON, TOML, XML, YAML } |
| -p --port <port>: | Sets the port for the server. |
| --path: | Echo the URL-Path: When specified, then URL-Query, HTTP-Body and HTTP-Header are only echoed when the according switches are set. |
| --query: | Echo the URL-Query: When specified, then URL-Path, HTTP-Body and HTTP-Header are only echoed when the according switches are set. |
| --sysinfo: | Shows some system information for debugging purposes. |
| -u --url-pattern <urlPattern>: | The ant-like pattern supporting wildcards (“*”, “**”, “?”) for the URL to observe. You might need to escape a trailing slash “/” with a backslash “\”, e.g. “/my/url/**”. |
| -v --verbose: | Enables the verbose mode with additional (human readable) informational output. |
| ∅: | Starts with the default configuration. |
EXAMPLES
Echos HTTP messages from port:
- httpecho -p <port> -v
Echos just the HTTP body from port:
- httpecho -p <port> --header -v
Echos just the HTTP body from port:
- httpecho -p <port> --body -v
Echos just the HTTP path and query from port:
- httpecho -p <port> --path --query -v
Echos HTTP messages from port using specific notation:
- httpecho -p <port> --notation <notation> -v
To show the help text:
- httpecho -h
To print the system info:
- httpecho --sysinfo
BUGS
See BitBucket issues: https://bitbucket.org/funcodez/funcodes-httpecho
AUTHOR
Siegfried Steiner steiner@refcodes.org