Embedthis Appweb 3.0A.0
Home > Users Reference > Http client

Quick Nav

Synopsis
Description
Options

See Also

User Guide Overview
Appweb Architecture
Configuring Appweb
Configuration Directives
Ports and Binding
Authorization
Secure Sockets Layer (SSL)
Virtual Hosts
Creating Dynamic Web Pages
Embedded Server Pages
Using Embedded JavaScript
Using PHP
Using CGI
Loadable Modules
Handlers

Appweb HTTP Client

httpClient -- Retrieve documents from HTTP servers by issuing HTTP client requests.

Synopsis

httpClient [options] urls ...

Description

The httpClient utility uses the Appweb HTTP client to retrieve documents from HTTP servers. It is primarily designed to test the Appweb server.

Options

Option
Description
-b
Benchmark. Output timing results after retrieving URLs.
-c
Continue on errors. Default is to stop on the first error.
-C compareDirectory
Compare the retrieved files against master copies in compareDir. Warn if any retrieved files are corrupted.
-d postData
String of post data. Assumed to be already URL encoded. ie. name=peter&address=oz
-f fileList
Retrieve the files in the specified file list. The format of the file is:
    {GET|POST} URL
If using POST, the line after the URL should contain encoded POST data and it should begin with a TAB.
-H
Output HTTP headers. Useful for debugging.
-h host
Prepend all URLs with the specified host. For example if '-h www.myHost.com:8888" were used with the URL "/index.html", then httpClient will retrieve http://www.myHost.com:8888
-i iterations
Retrieve the URLs iterations times. Useful for load testing.
-l logSpec
Log debug information to the specified log file.
The syntax is: -l logName[,moduleName][:logLevel].
-M method
Set the HTTP method. Values may be "GET", "PUT", "OPTIONS", "TRACE".
-o timeout
Specifies a timeout to use for each request in milliseconds.
-q
Quiet mode. Suppress error messages.
-r retryCount Retry failed requests this number of times.
-t threads
Number of threads to use. Each URL will be retrieved by all threads. Useful only for load testing.
-T poolThreads
Specify the number of pool threads to use.
-v
Verbose mode. Trace activity to stdout. Can by specified multiple times for more verbose tracing.
-w writeDir
Write retrieved files to the specified directory.
-V httpVersion
Use the specified HTTP protocol. httpVersion should be either '0' for HTTP/1.0 or 1 for HTTP/1.1.

© Embedthis Software LLC, 2003-2009. All rights reserved. Embedthis, Ejscript and Appweb are trademarks of Embedthis Software LLC.