HTTPECHO(1) General Commands Manual
NAME
httpecho — Small HTTP-Echo server echoing incoming HTTP-Requests back to the client and to the console.
SYNOPSIS
| httpecho | [ -p <port> ] [ -c <connections> ] [ -D ] [ -e ] [ -P ] [ -Q ] [ -H ] [ -B ] [ -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 echoes --echo incoming HTTP requests back to the
client as HTTP response (optionally) and prints (“echo”) 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
such as XML, JSON, YAML or INI.
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
| -B --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 --date: | Include the current local date when echoing an HTTP-Request. |
| -d --debug: | Enables the debug mode with additional (developer readable) informational output. |
| -e --echo: | Echo the HTTP-Request back as HTTP-Response. |
| -h --help: | Shows this help. |
| -H --header: | Echo the HTTP-Header: When specified, then URL-Path, URL-Query, and HTTP-Body are only echoed when the according switches are set. |
| -n --notation <notation>: | The output notation such as: { INI, JAVA, JSON, TOML, XML, YAML } |
| -p --port <port>: | Sets the port for the server. |
| -P --path: | Echo the URL-Path: When specified, then URL-Query, HTTP-Header and HTTP-Body are only echoed when the according switches are set. |
| -Q --query: | Echo the URL-Query: When specified, then URL-Path, HTTP-Header and HTTP-Body 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 HTTP messages also as HTTP-Response from port:
- httpecho -p <port> -e -v
Echos just the HTTP body from port:
- httpecho -p <port> -H -v
Echos just the HTTP body from port:
- httpecho -p <port> -B -v
Echos just the HTTP path and query from port:
- httpecho -p <port> -P -Q -v
Echos HTTP messages from port using specific notation:
- httpecho -p <port> --notation <notation> -v
Include local date when echoing HTTP messages from port:
- httpecho -p <port> -D -v
To show the help text:
- httpecho -h
To print the system info:
- httpecho --sysinfo
BUGS
See BitBucket issues at <https://bitbucket.org/funcodez/funcodes-httpecho/issues>
AUTHOR
Siegfried Steiner steiner@refcodes.org