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