HTTPECHO manpage

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

SEE ALSO