HTTPECHO manpage

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

SEE ALSO