|
|
Invoking URL from Unix
12-20-2011
|
|
http(n) Tnm Tcl Extension http(n) __________________________________________________________________________________________________________________________________________________ NAME
http - Send and process HTTP requests. _________________________________________________________________ DESCRIPTION
The Hypertext Transfer Protocol (HTTP) (RFC 1945) is a client/server protocol used to retrieve documents in the World Wide Web. Documents are addressed using Uniform Resource Locators (URL) (RFC 1738). The http command allows to implement HTTP clients and a simple HTTP server. HTTP COMMAND
The following list of http commands is useful for HTTP clients: http proxy [url] The http proxy command allows to define a proxy HTTP server which will be used in subsequent client commands. Using this command without an url argument will return the URL to the currently used proxy or an empty string. Providing a url argument sets the proxy server. Setting the proxy to an empty string turns the proxy feature off. http head url The http head command retrieves the HTTP header for the document located at url. The header is returned as a list of keys and values which can be converted into a Tcl array using the array set command. http get url fileName The http get command retrieves the document located at url. The body of the document is written to the file named fileName. The com- mand returns the HTTP header as described for the http head command above. http post url docFileName fileName The http post command posts the document in docFileName to the location url. The body of the returned document is written to the file named fileName. The command returns the HTTP header as described for the http head command above. http put url docFileName The http put command puts the document in docFileName to the location url. The command returns the HTTP header as described for the http head command above. http delete url The http delete command deletes the document at the location defined by url. The command returns HTTP status information. The following set of http commands is useful for a simple HTTP server: http server [port] The http server command starts a simple HTTP server listening on port port. If called without a port argument, the currently used port number or an empty string is returned. An empty string indicates that no server is currently active. http mime type extension The http mime command is used to add mime type definitions to the internal table which maps file name extension to mime types. If called without an argument, the list of all mime type mappings is returned. A new mapping is created by supplying a mime type and the file name extension. http bind pattern method [script] The http bind command binds a Tcl script to the invocation of a HTTP method where the URL matches pattern. Whenever a HTTP request of type method is received that matches the pattern, script is evaluated. The return value of the script must be a name of a file which will be send back to the client. Errors during the evaluation of the script will result in an error response. The following % sequences are substituted before a script bound to a URL is evaluated: %A The network address of the client. %P The URL path requested by the client. %S The search path contained in the URL path. SEE ALSO
scotty(1), Tnm(n), Tcl(n) AUTHORS
Juergen Schoenwaelder <schoenw@cs.utwente.nl> Tnm http(n)